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

生徒

「Twigでリストみたいなデータを表示するにはどうすればいいですか？」

先生

「Twigでは配列や連想配列を使って、データの一覧や表形式を簡単に表示できますよ。」

生徒

「連想配列ってなんですか？難しそう……」

先生

「大丈夫です。配列との違いから順番にわかりやすく説明していきますね！」

1. Twigで配列を表示する基本

Symfonyのテンプレートエンジン「Twig」では、配列をfor文で繰り返し処理して、リスト表示などが簡単にできます。

配列とは、データが順番に並んでいる「リスト」のようなものです。例えば「りんご」「バナナ」「みかん」といった果物の一覧も、Twigでは配列として扱えます。


{% set fruits = ['りんご', 'バナナ', 'みかん'] %}

<ul>
  {% for fruit in fruits %}
    <li>{{ fruit }}</li>
  {% endfor %}
</ul>

このように、{% set %}で変数に配列を代入し、{% for %}で1つずつ取り出して表示します。

2. 実行結果のイメージ（配列の表示）


<ul>
  <li>りんご</li>
  <li>バナナ</li>
  <li>みかん</li>
</ul>

このように、Twigを使うと配列の中身を順番にHTMLに出力することができます。

3. Twigで連想配列を表示する方法

連想配列とは、「名前：太郎」「年齢：25」「住所：東京」のように、キーと値のペアで情報を管理するデータのことです。Twigでは次のように表示できます。


{% set user = {
  '名前': '田中太郎',
  '年齢': 30,
  '住所': '東京都'
} %}

<ul>
  {% for key, value in user %}
    <li>{{ key }}：{{ value }}</li>
  {% endfor %}
</ul>

この例では、keyが「名前」「年齢」「住所」、valueが「田中太郎」「30」「東京都」としてループの中で使えます。

4. 実行結果のイメージ（連想配列）


<ul>
  <li>名前：田中太郎</li>
  <li>年齢：30</li>
  <li>住所：東京都</li>
</ul>

連想配列は、プロフィール情報や設定など、名前付きのデータを扱うときに非常に便利です。

5. Twigで配列をテーブル表示する方法

配列や連想配列をHTMLの表（テーブル）で表示したい場合もTwigで簡単に実装できます。たとえば、商品の一覧を表形式で見せる場合などです。


{% set products = [
  {'商品名': 'ノート', '価格': 100},
  {'商品名': 'ペン', '価格': 200},
  {'商品名': '消しゴム', '価格': 150}
] %}

<table class="table table-bordered">
  <thead>
    <tr>
      <th>商品名</th>
      <th>価格</th>
    </tr>
  </thead>
  <tbody>
    {% for product in products %}
      <tr>
        <td>{{ product['商品名'] }}</td>
        <td>{{ product['価格'] }}円</td>
      </tr>
    {% endfor %}
  </tbody>
</table>

表形式にすることで、複数のデータを見やすく整列させることができます。tdタグの中にそれぞれの値を表示しています。

6. Twigの中で配列の長さを調べる方法

配列の要素数（何個あるか）を知りたいときは、lengthフィルタを使います。


<p>商品は{{ products|length }}件あります。</p>

このように書くと、配列に含まれる要素数を表示できます。

7. Twigで配列を使うときの注意点

キー名にスペースや記号が含まれるときは['キー']の形式で指定しましょう。
値が空かどうかを確認するにはif文でチェックできます。
ループの中でインデックス（何番目か）を使いたいときは、loop.indexを活用します。

Twigの配列処理は、慣れるととても直感的に使えるので、まずは簡単な例から試してみましょう。

まとめ

今回の記事では、Twigにおける配列と連想配列の表示方法について、初心者の方でも理解しやすいように基本から応用までを順番に解説してきました。TwigはSymfonyで広く使われているテンプレートエンジンであり、画面表示を担当する重要な役割を持っています。その中でも、配列や連想配列を正しく扱えるようになることは、実用的なテンプレートを作るための大きな一歩です。

まず、配列の基本として「順番に並んだデータ」をfor文で繰り返し表示する方法を学びました。配列は、リスト表示やメニュー、カテゴリ一覧など、Webページのあらゆる場面で使われます。Twigのfor構文はHTMLに近い書き方ができるため、コードの流れが直感的に理解しやすく、テンプレート初心者でも安心して扱える点が特徴です。

次に、連想配列について確認しました。連想配列は「キーと値」の組み合わせでデータを管理する形式で、ユーザー情報や設定情報、プロフィール表示などに非常によく使われます。Twigでは、for文の中でキーと値を同時に受け取れるため、「項目名：内容」という形の表示も簡単に実装できます。この仕組みを理解すると、情報を分かりやすく整理した画面が作れるようになります。

また、配列や連想配列をテーブル形式で表示する方法も紹介しました。商品一覧やデータ一覧など、複数の項目を整理して見せたい場合には、HTMLのtableタグとTwigのfor文を組み合わせることで、見やすく整った画面を作ることができます。Twigのテンプレートでは、HTMLとロジックが自然に組み合わさるため、デザインとデータ表示を同時に考えやすいのも魅力です。

配列の要素数を取得する方法として、lengthフィルターについても触れました。件数表示や「データが存在するかどうか」の判定など、実務でもよく使われる機能です。Twigのフィルターは、配列や文字列などさまざまなデータに対して使えるため、覚えておくとテンプレートの表現力が一気に広がります。

さらに、Twigで配列を扱う際の注意点として、キーの指定方法や空チェック、ループ内で使える便利な変数についても確認しました。これらを意識することで、エラーを防ぎながら、より柔軟なテンプレートを書くことができます。特に、キー名に日本語や記号が含まれる場合の書き方は、初心者がつまずきやすいポイントなので、しっかり覚えておきたいところです。

Twigで配列や連想配列を使いこなせるようになると、単純な文字表示だけでなく、動きのあるWebページを作れるようになります。データの数や内容に応じて表示を切り替えたり、自動で一覧を生成したりできるため、実践的なSymfony開発には欠かせない知識です。今回学んだ内容をベースに、ぜひ自分のテンプレートで配列表示を試しながら、Twigの理解を深めていきましょう。

サンプルプログラムの振り返り


{% for key, value in user %}
  <li>{{ key }}：{{ value }}</li>
{% endfor %}

このサンプルプログラムでは、Twigの連想配列をfor文で繰り返し処理し、キーと値をセットで表示しています。プロフィール情報や設定一覧など、項目名と内容を同時に表示したい場面でとても便利な書き方です。Twigの配列処理に慣れることで、テンプレート作成がぐっと楽になります。

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

生徒：Twigで配列を表示できるようになると、できることが一気に増えますね。

先生：そうですね。配列と連想配列は、画面表示の基本になります。

生徒：最初は連想配列が難しそうでしたが、キーと値で考えると分かりやすかったです。

先生：その理解で正解です。情報を整理して表示したいときにとても役立ちます。

生徒：テーブル表示も簡単に書けるのが便利だと思いました。

先生：一覧画面を作る場面では、ほぼ必須のテクニックですね。

生徒：これからは、Twigでデータをどう見せるか考えるのが楽しくなりそうです。

先生：その調子です。Twigを使いこなせば、テンプレート作成がもっと自由になりますよ。

Twigの配列と連想配列の表示方法を完全解説！初心者向けテンプレート入門