先生と生徒の会話形式で理解しよう

生徒

「Symfony（シンフォニー）っていうPHPのフレームワークで、コントローラっていうのがあるって聞いたんですが、それって何ですか？」

先生

「コントローラは、ウェブサイトの画面を表示したり、データを処理したりする役割を持っている重要な部分ですよ。」

生徒

「えっ？でもそれって難しそう……どうやって作るんですか？」

先生

「安心してください！今日はSymfonyのコントローラについて、作り方から役割まで、基礎からやさしく解説していきますね。」

1. Symfonyのコントローラとは？

Symfony（シンフォニー）は、PHPで本格的なウェブアプリケーションを作るためのフレームワークです。その中で「コントローラ」と呼ばれる部分は、ユーザーがページを開いたり、ボタンを押したりしたときにどんな処理を行うかを決める司令塔のような存在です。

たとえば、ユーザーが「お問い合わせページを開きたい」と思ってURLへアクセスすると、コントローラが「ではこの画面を表示しよう」と判断し、対応する処理を実行します。

また、コントローラは画面（テンプレート）を読み込んだり、データベースから情報を取ってきたりと、アプリケーションの動きを支える重要な役割も担っています。まるで舞台裏で動きを管理する監督のように、全体の流れを整えるのがコントローラです。

仕組みをイメージしやすくするために、簡単なサンプルを書いてみましょう。


namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class SampleController extends AbstractController
{
    #[Route('/sample', name: 'sample_page')]
    public function index(): Response
    {
        // このメソッドが「/sample」のページを表示する役割を担当
        return new Response('これはサンプルページです！');
    }
}

このコードでは、/sample というURLにアクセスすると、コントローラが呼び出され、画面に文字が表示されます。「リクエストが来たらどう動くか」を決めるというコントローラの役割が、シンプルな形で体験できます。

2. コントローラの基本構造

Symfonyでコントローラを作るときは、まずPHPのクラスとしてファイルを用意します。クラスは「機能をまとめる箱」のようなもので、その中に画面を表示したり、データを返したりするためのメソッド（処理のかたまり）を書いていきます。

Symfonyでは、このクラスがAbstractControllerという親クラスを継承することで、画面表示やレスポンス作成などの便利な機能をそのまま利用できるようになります。継承と聞くと難しく感じますが、「親の便利な道具を受け継いで使えるようにする仕組み」とイメージすればOKです。

まずは、最もシンプルなコントローラの例を見てみましょう。


namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class HelloController extends AbstractController
{
    #[Route('/hello', name: 'hello')]
    public function index(): Response
    {
        // ここが URL "/hello" にアクセスされたときに実行される処理
        return new Response('こんにちは、Symfony！');
    }
}

このサンプルでは、index() というメソッドが「/hello」ボタンのような役割を持ち、ユーザーがそのURLにアクセスすると実行されます。難しい処理はなく、文字列を返しているだけですが、これがSymfonyのコントローラの基本的な流れです。

初心者の方は、まずは「URLにアクセスすると、このメソッドが呼ばれる」という考え方を理解しておくとスムーズに次のステップへ進めます。

3. コントローラの役割とは？

Symfonyのコントローラは、アプリケーションの中心となる「判断役」のような存在です。ユーザーがページを開いたり、ボタンを押したりしたときに、どの処理を行うべきかを決めて実行する司令塔として働きます。ウェブサイトの使いやすさは、このコントローラの作り方で大きく変わると言っても過言ではありません。

具体的には、コントローラには次のような役割があります。

URLごとに適切な処理を実行する
例：トップページ表示、記事一覧の読み込みなど。
Twigテンプレートを使って画面（HTML）を表示する
表示したいページを選び、必要なデータを渡します。
フォームから送られたデータを受け取り、内容をチェックする
データベースとのやり取りを行い、必要な情報を取得・保存する

たとえば「商品一覧ページを表示する」場合、コントローラは次のように動きます。


#[Route('/products', name: 'product_list')]
public function list(): Response
{
    // 仮のデータ（本来はデータベースから取得する）
    $products = ['りんご', 'みかん', 'ぶどう'];

    // Twig テンプレートにデータを渡して画面を表示
    return $this->render('product/list.html.twig', [
        'products' => $products,
    ]);
}

このように、コントローラは「データを用意する」→「画面に渡す」→「表示する」という流れの中心に位置しています。Symfonyを使いこなすための鍵になる部分なので、まずは処理の入り口としてコントローラが動くというイメージを持っておくと理解が深まりやすくなります。

4. コントローラを自動で作る方法

Symfonyには便利なコマンドがあり、コントローラを自動で作成することができます。コマンドとは、決まった言葉を入力して操作する方法です。

ターミナル（黒い画面）で以下のように入力すると、コントローラのファイルが自動で作られます。


php bin/console make:controller HelloController

このコマンドを実行すると、コントローラの雛形と、それに対応するテンプレート（画面）が自動で生成されます。

5. コントローラとURLのつながり（ルーティング）

コントローラがどのURLに対応するのかは、#[Route()]というルーティングの仕組みで決まります。

先ほどの例では、次のようになっていました。


#[Route('/hello', name: 'hello')]

この意味は、「/helloというURLにアクセスがあったら、index()メソッドを呼び出す」という指定です。

この仕組みを使うことで、それぞれのURLに応じたページを簡単に作ることができます。

6. コントローラからHTMLを表示する方法

実際のウェブページでは、文字だけでなく、HTMLで整えた見た目のある画面を表示したいことが多いです。

Symfonyでは、コントローラからテンプレートというHTMLファイルを読み込んで表示することができます。

その場合は、次のようにrender()という関数を使います。


return $this->render('hello/index.html.twig');

これで、templates/hello/index.html.twig というテンプレートファイルが読み込まれ、画面に表示されます。

7. 実行結果の例

実際にブラウザでhttp://localhost:8000/hello にアクセスすると、次のような画面が表示されます。


こんにちは、Symfony！

8. 初心者がつまずきやすいポイント

Symfonyのコントローラを初めて学ぶとき、よくあるつまずきポイントがあります。

コントローラのファイル名とクラス名を一致させる必要がある
ルートの指定（#[Route()]）を忘れるとURLに反応しない
テンプレートファイルが存在しないとエラーになる

これらは初心者でも慣れれば自然に理解できるようになるので、焦らず少しずつ慣れていきましょう！

まとめ

Symfonyのコントローラについて一通り学んできましたが、振り返ってみると、コントローラはウェブアプリケーションの流れを決める非常に重要な存在であることが改めて理解できる内容でした。リクエストを受けて、必要な処理を判断し、テンプレートを返したりデータベースと連携したり、まさに画面と内部処理をつなぐ「橋渡し役」として働いてくれます。特にSymfonyの場合、コントローラの仕組みが整っているため初心者でも構造を理解しやすく、ルーティングやテンプレート表示など基本的な動作が自然に身につけられる点が魅力的です。PHPを使った開発では、どこで処理を書くのか、どこで画面を返すのかが分かりにくいと感じやすいですが、Symfonyのコントローラは役割が明確で、ひとつひとつの動作が視覚的にも理解しやすく整理されています。また、コントローラの作り方や仕組みを知ると、フレームワーク全体の流れが見えやすくなるため、アプリケーション開発の効率が大きく変わります。自動生成コマンドを使えば必要なファイルが整った状態で作成されるため、開発がスムーズに進みやすく、テンプレートとのつながりも自然と理解できます。学習を進めるほど、「画面を表示するためのコントローラ」「入力フォームを処理するコントレーラ」「データを保存するコントローラ」のように使い分けができるようになり、Webアプリケーションの内部がどう動いているのかも見えてきます。特に重要なのがルーティングとの関係で、URLがどのコントローラと結びつくのかを定義することで、意図した通りにページを表示できるようになります。たとえば、/helloというURLを指定した場合、そのルートに対応するメソッドが動くという仕組みは、初心者にとっても理解しやすく、細かい画面管理が必要なアプリでも整理しやすい構成です。Symfonyでは属性（アトリビュート）によるルート定義が採用されているため、コードの中でURLと名前を完結に定義でき、読みやすさやメンテナンス性が向上します。さらに、テンプレートエンジンTwigとの連携が自然である点も見逃せません。コントローラからrender()を呼び出してHTMLを表示する流れがシンプルで、動的にデータを埋め込んだページを作る際にもわかりやすく、テンプレート側との役割分担がはっきりしています。複雑なデータを扱う場合でも、コントローラで処理してテンプレートに渡すという流れを繰り返すことで自然と構造が理解できるようになります。ここで、少し実践的な例として、コントローラから変数をテンプレートに渡す処理をまとめてみましょう。

サンプルプログラム：テンプレートにデータを渡すコントローラの例


namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class SampleController extends AbstractController
{
    #[Route('/sample', name: 'sample')]
    public function index(): Response
    {
        $data = [
            'title' => 'サンプルページ',
            'message' => 'Symfonyのコントローラからテンプレートへのデータ渡し例です。'
        ];

        return $this->render('sample/index.html.twig', [
            'data' => $data
        ]);
    }
}

このように、配列でまとめたデータをテンプレートに送ることで、ページ内に動的な内容を表示できます。実際のアプリケーションでは、データベースから取得した値をこの部分に渡したり、フォームから送られた内容を元に別の画面を表示したりと、応用の幅は非常に広いです。コントローラを軸にして、ルート、テンプレート、データベースが連動することで、ひとつの大きなアプリケーションが動いていることを改めて実感できるでしょう。そして、初心者が最初につまずきやすいポイントとしてファイル名とクラス名の一致やルートの記述ミスがありますが、コントローラの流れを理解しておけば自然と解決しやすくなります。Symfonyは構造が整っているため、慣れると非常に作業がしやすく、開発効率を高めてくれる強力なフレームワークです。コントローラをしっかり理解することは、Symfonyを使いこなす第一歩であり、画面表示からデータ処理までを繋ぐ重要な役割を知ることで、今後の開発がよりイメージしやすくなるはずです。

先生と生徒の振り返り会話

生徒

「先生、Symfonyのコントローラって最初は難しそうに感じましたけど、流れが分かると意外と整理されていて理解しやすいですね！」

先生

「その通りです。コントローラは依頼を受けて処理を実行する場所なので、役割を押さえておくと理解が深まりますよ。」

生徒

「URLとメソッドがつながるルーティングの仕組みも面白かったです。どのページがどの処理なのか一目で分かりますし。」

先生

「そうですね。Symfonyはコードの見通しが良くなるよう工夫されていますから、慣れてくるほど使いやすさが感じられると思います。」

生徒

「テンプレートにデータを渡す仕組みも覚えやすかったです。実際に自分で画面を作れるようになると楽しいですね！」

先生