Symfony Twig入門｜フィルターと関数で値を整形する方法をやさしく解説

1. Twigとは何かを超かんたんに理解しよう

1. Twigとは何かを超かんたんに理解しよう

Twig（トゥイッグ）は、Symfonyで使われるテンプレートエンジンです。 テンプレートエンジンとは、画面に表示する文章や数字を組み立てるための仕組みのことです。 例えるなら、チラシのひな形に数字や名前を当てはめて印刷するようなイメージです。 Twigを使うことで、PHPの難しい処理を書かなくても、見た目を整えた表示ができます。 Symfony、Twig、テンプレート、初心者向けというキーワードでよく検索される重要な部分です。

2. フィルターとは？値を後ろから整える仕組み

2. フィルターとは？値を後ろから整える仕組み

Twigのフィルターは、表示したい値の後ろにパイプ記号を付けて使います。 パイプ記号は「このあと加工します」という合図です。 例えば、文字を大文字にしたり、余計な空白を消したりできます。 フィルターは「表示直前の仕上げ」と考えると分かりやすいです。

{{ name|upper }}

上の例では、nameという値をすべて大文字にして表示します。 upperは「大文字にする」という意味です。

3. よく使う文字のフィルターを覚えよう

3. よく使う文字のフィルターを覚えよう

初心者の方が最初によく使うのは、文字を整えるフィルターです。 文章の前後にある空白を消したり、文字数を数えたりできます。 これは、見た目をきれいにするためにとても役立ちます。

{{ message|length }}

lengthは文字の数を数えるフィルターです。 フォーム入力の確認や、文字数表示によく使われます。

4. 数字を見やすくするフィルター

4. 数字を見やすくするフィルター

数字はそのまま表示すると読みにくいことがあります。 Twigでは、カンマを付けて金額のように表示することも簡単です。 これはネットショップや管理画面でとても重要です。

{{ price|number_format }}

number_formatを使うと、10000が10,000のように表示されます。 初心者でも安心して使える便利なフィルターです。

5. 関数とは？表示前に呼び出す便利な道具

5. 関数とは？表示前に呼び出す便利な道具

Twigの関数は、あらかじめ用意された便利な命令です。 フィルターと違い、値の前で使うのが特徴です。 「何かを取得する」「条件を調べる」といった役割があります。

{{ path('home') }}

path関数は、指定したページのURLを作ってくれます。 SymfonyとTwigを組み合わせる代表的な使い方です。

6. 日付を整形して表示する方法

6. 日付を整形して表示する方法

日付は表示形式がとても重要です。 Twigではdateフィルターを使うことで、日本人に分かりやすい形にできます。 年月日をそろえて表示できるので、画面が一気に見やすくなります。

{{ createdAt|date('Y年m月d日') }}

このように書くと、「2026年01月23日」のように表示されます。

7. フィルターと関数を組み合わせる考え方

7. フィルターと関数を組み合わせる考え方

Twigでは、関数で取得した値にフィルターをかけることもできます。 料理で例えると、材料を取り出してから味付けする流れです。 この考え方を覚えると、表示の自由度が一気に広がります。

{{ app.user.name|upper }}

ユーザー名を取得して、大文字で表示する例です。 Symfony、Twig、フィルター、関数の基本がここに詰まっています。

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

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

初心者の方がよく間違えるのは、フィルターと関数の位置です。 フィルターは後ろ、関数は前と覚えるだけで混乱が減ります。 また、エラーが出ても慌てず、表示を整える道具だと思って試すことが大切です。 Twigの値の整形は、慣れるほど楽しくなります。