Symfonyでサービスを手動登録する方法を完全解説！services.yamlを初心者向けにやさしく理解

1. Symfonyのサービスとは何か？

1. Symfonyのサービスとは何か？

Symfonyにおけるサービスとは、アプリケーションの中で何度も使われる便利な部品のことです。たとえば、メールを送る処理、データベースに保存する処理、計算を行う処理などがサービスになります。

現実世界でたとえると、サービスは「道具箱に入っている道具」のような存在です。必要なときに取り出して、どこからでも同じように使えます。Symfonyでは、この道具を管理する仕組みが最初から用意されています。

2. 依存性注入（DI）を超かんたんに理解する

2. 依存性注入（DI）を超かんたんに理解する

依存性注入とは、難しそうな言葉ですが考え方はシンプルです。クラスの中で新しく道具を作るのではなく、外から道具を渡してもらう仕組みです。

たとえば料理で包丁が必要な場合、自分で包丁を作るのではなく、キッチンから借りますよね。この「借りる」動作が依存性注入です。Symfonyでは、サービスとして登録されたクラスを自動で渡してくれます。

3. services.yamlとは何をするファイル？

3. services.yamlとは何をするファイル？

services.yamlは、Symfonyでサービスを設定するための重要なファイルです。このファイルに「このクラスはサービスとして使います」と書いておくことで、Symfonyが管理してくれるようになります。

YAML（ヤムル）という形式で書かれており、インデント（字下げ）で構造を表現します。プログラミング未経験の方でも、箇条書き感覚で読めるのが特徴です。

4. 最小構成でサービスを手動登録してみよう

4. 最小構成でサービスを手動登録してみよう

まずは、シンプルなクラスをサービスとして登録してみます。以下は、あいさつ文を返すだけのクラスです。

<?php
namespace App\Service;

class HelloService
{
    public function sayHello(): string
    {
        return 'こんにちは、Symfony！';
    }
}

このクラスを services.yaml に登録します。

services:
    App\Service\HelloService:
        public: true

これで、HelloServiceはSymfonyのサービスとして使えるようになります。

5. コントローラでサービスを使う方法

5. コントローラでサービスを使う方法

登録したサービスは、コントローラでそのまま受け取れます。以下は依存性注入を使った例です。

<?php
namespace App\Controller;

use App\Service\HelloService;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class SampleController extends AbstractController
{
    public function index(HelloService $helloService): Response
    {
        return new Response($helloService->sayHello());
    }
}

Symfonyが自動でHelloServiceを用意してくれるため、自分で new する必要はありません。

6. 引数を持つサービスを登録する

6. 引数を持つサービスを登録する

サービスには設定値を渡すこともできます。たとえば、メッセージ内容を外から決めたい場合です。

<?php
namespace App\Service;

class MessageService
{
    private string $message;

    public function __construct(string $message)
    {
        $this->message = $message;
    }

    public function getMessage(): string
    {
        return $this->message;
    }
}

services:
    App\Service\MessageService:
        arguments:
            $message: '設定ファイルから渡されたメッセージ'

7. publicとprivateの違いを理解しよう

7. publicとprivateの違いを理解しよう

services.yamlでは、publicという設定があります。これは「外から直接使えるかどうか」を意味します。

初心者のうちは public: true を指定して問題ありませんが、実際の開発では private が推奨されます。Symfonyの内部から安全に管理するためです。

8. 自動登録との違いと手動登録のメリット

8. 自動登録との違いと手動登録のメリット

Symfonyは多くの場合、クラスを自動でサービス登録してくれます。しかし、細かい設定をしたい場合や、特別な初期値を渡したい場合は手動登録が必要です。

services.yamlを理解すると、Symfonyが「なぜ思った通りに動くのか」「なぜエラーになるのか」が見えるようになります。これは初心者にとって大きな一歩です。