Twigでセッションとユーザー情報を表示する方法！Symfony初心者向け完全ガイド

1. セッションとは？やさしく解説

1. セッションとは？やさしく解説

セッションとは、ユーザーがウェブサイトを訪れてからブラウザを閉じるまでの一連の操作（通信）を記録しておく一時的な保存場所のことです。Webサイトは通常、ページを移動すると前のページの情報を忘れてしまいます。しかし、セッションを使うことで「誰が今アクセスしているか」を継続して覚えることが可能になります。

身近な例でいうと、ネットショップの「カート機能」がわかりやすいでしょう。商品をカートに入れた後、別の商品ページに移動してもカートの中身が消えないのは、サーバー側のセッションという箱にデータが保存されているからです。

Symfonyでは、このセッションという箱を非常に簡単に扱うことができます。コントローラで値を保存し、Twigテンプレートでそれを取り出すといった連携もスムーズに行えるため、ログイン機能やユーザーごとのカスタマイズ表示には欠かせない仕組みです。

2. Twigでセッションの値を表示する方法

2. Twigでセッションの値を表示する方法

Symfonyでは、コントローラ側でセッションに値をセットしておくと、Twigで簡単にその値を取り出すことができます。

たとえば、コントローラで次のように設定します。

$session = $request->getSession();
$session->set('username', 'taro');

このようにすると、Twigテンプレートで次のように表示できます。

<p>こんにちは、{{ app.session.get('username') }}さん！</p>

app.session.get()を使うことで、セッションに保存された値を取得して表示できます。

3. Twigでユーザー情報を表示するには？

3. Twigでユーザー情報を表示するには？

Symfonyでは、ログインしているユーザーの情報をapp.userという変数で取得できます。

これは、セッションとは別に、セキュリティ機能によって管理されているログイン中のユーザー情報です。

たとえば、ユーザーのメールアドレスやユーザー名を表示したい場合、次のように書きます。

<p>ログイン中のユーザー：{{ app.user.email }}</p>

また、ユーザー名がgetUsername()で取得できるようになっていれば、次のようにも書けます。

<p>ユーザー名：{{ app.user.username }}</p>

4. ログインしているかを判定する方法

4. ログインしているかを判定する方法

Twigでは、ログイン中かどうかをapp.userが存在するかで判定できます。次のように書くことで、ログイン中だけメッセージを表示することができます。

{% if app.user %}
    <p>ようこそ、{{ app.user.username }}さん！</p>
{% else %}
    <p>ログインしていません。</p>
{% endif %}

このように、条件分岐を使えば、ログイン状態によって表示を切り替えることができます。

5. セッションに保存された他の情報も表示できる

5. セッションに保存された他の情報も表示できる

セッションには、ログイン状態だけでなく、任意のデータを保存できます。たとえば、以下のように住所を保存した場合：

$session->set('address', '東京都新宿区');

Twigでは次のように取り出せます。

<p>登録住所：{{ app.session.get('address') }}</p>

このように、Twigからセッションを使って簡単に個別の情報を表示することができます。

6. セッションの値が無い場合の対処

6. セッションの値が無い場合の対処

セッションに指定したキーが無い場合、何も表示されない、またはエラーになることがあります。そこで、デフォルト値（初期値）を設定する方法があります。

<p>{{ app.session.get('nickname', 'ゲスト') }}</p>

この例では、nicknameがセッションに無ければ「ゲスト」と表示されます。

7. Twigで現在のログインユーザーのロール（役割）を確認する

7. Twigで現在のログインユーザーのロール（役割）を確認する

Symfonyでは、ユーザーに「管理者」「一般ユーザー」などの役割（ロール）を持たせることができます。

Twigでそのロールを確認するには、is_granted()を使います。

{% if is_granted('ROLE_ADMIN') %}
    <p>あなたは管理者です。</p>
{% endif %}

このようにして、ログイン中のユーザーがどの役割を持っているかに応じて、画面の表示内容を変えることも可能です。

まとめ

まとめ

今回の記事では、PHPの代表的なフレームワークであるSymfonyにおいて、テンプレートエンジン「Twig」を活用してセッション情報やログインユーザー情報を表示する方法について詳しく解説してきました。Webアプリケーション開発において、ユーザーごとにパーソナライズされた画面を提供することは非常に重要です。ログインしているユーザーの名前を表示したり、ショッピングカートの内容を保持したり、あるいはユーザーの権限（ロール）に応じてメニューの表示・非表示を切り替えたりといった処理は、モダンなWebサービスには欠かせない要素だからです。

Symfonyにおけるグローバル変数「app」の強力な機能

Twig内では、Symfonyが標準で用意している app という特別なグローバル変数を利用できます。これを使うことで、コントローラーから明示的に値を渡さなくても、リクエスト情報、セッション、ユーザー情報などに直接アクセスできるのが大きなメリットです。

例えば、セッションに保存されたデータを取得する際には app.session.get('キー名') を使用します。セッションは、サーバー側に一時的にデータを保存する仕組みであり、ブラウザを閉じたり有効期限が切れたりするまで、ページをまたいで情報を保持し続けることができます。これにより、複数の画面を遷移しても「誰が」「何をしているか」を追跡することが可能になります。

ユーザー情報とセキュリティの連携

ログイン中のユーザーに関しては app.user を通じて、Userエンティティに定義されたプロパティ（emailやusernameなど）を簡単に呼び出すことができます。セキュリティコンポーネントと密接に連携しているため、複雑なSQLを書くことなく「現在ログインしているのは誰か」という情報を扱えるのがSymfonyの使い勝手の良い点です。

実践的なプログラム例：ユーザープロフィールの表示と条件分岐

ここで、これまでに学んだ内容を組み合わせた実践的なコードを確認してみましょう。例えば、ユーザーがログインしている場合にはプロフール情報を出し、未ログインの場合にはログインを促すリンクを出すようなケースです。

<div class="user-profile">
    {% if app.user %}
        <h3>会員専用メニュー</h3>
        <ul>
            <li>ユーザー名：{{ app.user.username }}</li>
            <li>メールアドレス：{{ app.user.email }}</li>
            <li>
                現在のステータス：
                {{ app.session.get('user_status', '未設定') }}
            </li>
        </ul>
        
        {% if is_granted('ROLE_ADMIN') %}
            <div class="alert alert-danger">
                管理者専用パネルへのアクセス権限があります。
            </div>
        {% endif %}
        
    {% else %}
        <p>サービスを利用するには<a href="/login">ログイン</a>してください。</p>
        <p>ゲストさん、こんにちは！</p>
    {% endif %}
</div>

上記のコードでは、まず {% if app.user %} でログインの有無をチェックしています。ログインしていれば app.user から具体的な情報を取得し、同時に app.session.get を使ってセッションに保存されている個別のステータス（例：プレミアム会員フラグなど）を表示しています。さらに is_granted('ROLE_ADMIN') を用いることで、管理者のみが見ることができる特別なメッセージを表示させるという、より高度な制御を行っています。

開発効率を上げるためのポイント

Symfonyで開発を進める上で、Twigとセッションの扱いをマスターすることは、ユーザー体験（UX）の向上に直結します。以下のポイントを意識して実装を進めると、より堅牢で使い勝手の良いシステムを構築できるでしょう。

• デフォルト値の活用： セッションから値を取得する際は、必ず app.session.get('key', 'default') のようにデフォルト値を設定しましょう。これにより、値が存在しない場合の予期せぬ空白やエラーを防げます。
• セキュリティの意識： app.user で取得できる情報は、あくまでログイン中の自分自身の情報です。他人の情報を不用意に表示させないよう、コントローラー側のロジックと合わせて設計することが大切です。
• デバッグの活用： Symfonyのプロファイラー（画面下部に出るバー）を確認すれば、現在のセッションの内容やログインユーザーのロール情報を視覚的に確認できます。開発中は積極的に活用しましょう。

Twigは非常に柔軟なテンプレートエンジンであり、今回紹介した機能以外にも、フィルターや関数を自作してさらに拡張することも可能です。まずは基本となる app 変数の使い方に慣れ、徐々に複雑な条件分岐やデータ表示に挑戦してみてください。