# EC-CUBE4 Twig テンプレートエンジン
Twig は、PHP のテンプレートエンジンの一つであり、Symfony フレームワークにも標準で採用されている人気の高いテンプレートエンジンです。
Twig は、シンプルで直感的な文法を持っており、簡単にテンプレートを作成できるため、Web アプリケーションの開発に広く利用されています。また、セキュリティ上の理由から、Twig は PHP コードの実行を禁止しており、テンプレート内で PHP コードを実行することができません。
Twig の特徴として、ビューのテンプレートの拡張性が高く、自由自在にカスタマイズできることが挙げられます。また、テンプレート内で変数や関数を使って、柔軟に表示内容を変更することができます。
EC-CUBE 4 では、Twig が採用されており、ビューのテンプレートを Twig で記述することができます。Twig の文法に慣れることで、より簡単にビューのテンプレートを作成することができます。
# Twig と Laravel Blade テンプレートエンジン比較
Twig の特徴
- シンプルで直感的な文法を持つ
- テンプレート内で PHP コードの実行を禁止しており、セキュリティが高い
- テンプレート内で独自のフィルターや関数を定義することができる
- テンプレートの拡張性が高く、自由自在にカスタマイズできる
- ビューのテンプレートを Twig で記述することができる Symfony フレームワークに標準で採用されている
Laravel Blade の特徴
- PHP コードを直接書くことができるため、柔軟性が高い
- 簡単にテンプレートを継承することができる
- ディレクティブを使用することで、繰り返し処理や条件分岐を簡単に記述することができる
- テンプレートの記述がシンプルで、HTML との親和性が高い
- ビューのテンプレートを Laravel フレームワークに標準で採用されている
Twig と Laravel Blade は、それぞれ特徴があります。Twig はシンプルな文法を持ち、セキュリティが高いため、テンプレートの拡張性やカスタマイズ性が高いです。
一方で、Laravel Blade は PHP コードを直接書けるため、柔軟性が高く、繰り返し処理や条件分岐を簡単に記述することができます。
# Twig url ファンクション
EC-CUBE の Twig テンプレートには、URL を生成するための便利な関数 url が用意されています。この関数は、リンク先の URL を自動的に生成してくれるため、テンプレートの記述が簡単になります。
仕様
{{ url(route_name, route_parameters = [], schemeRelative = false) }}
route_name
type: string
route_parameters (optional)
type: array default: []
schemeRelative (optional)
type: boolean default: false
第 1 引数は route_name というルート名を指定しています。
第 2 引数では、パラメーターを指定します。
第 3 引数は、schemeRelative パラメーターを使用して、スキームを省略した URL を生成することができます。
例
<a href="{{ url('product_detail', {id: product.id}, false) }}">商品詳細ページへ</a>
# app.user User 情報を取得する方法
User 情報を取得するには、セッションから User 情報を取得する方法があります。
// user id
{{ app.user.id }}
// user login_date 取得
{{ app.user.login_date|date_min }}
// user name 取得
{{ app.user.name}}
// user ２段階認証
{{ app.user.two_factor_auth_enabled }}
// user 姓
{{ app.user.name01 }}
// user 名
{{ app.user.name02 }}
// user 氏名
{{ app.user.name }}
// user point数
{{ app.user.point|number_format }}
# app.session Session 情報を取得する方法
Session 情報を取得するには、app.session 変数を使用します。例えば、セッションに保存されている情報を取得するには、以下のように記述します。
// お問い合わせページ情報
{{ app.session.get('eccube.admin.contact.search.page_no')|default('1') }}
// 管理画面商品検索ページ情報
{{ app.session.get('eccube.admin.product.search.page_no')|default('1') }}
// カートまわり
{{ app.session.flashbag.get('eccube.front.request.product') }}
{{ app.session.flashbag.get('eccube.front.request.error') }}
{{ app.session.flashbag.get('eccube.front.cart.error') }}
{{ app.session.flashbag.get('eccube.front.cart.' ~ cartKey ~ '.request.error') }}
// ログインまわり
{{ app.session.flashBag.has('eccube.login.target.path') }}
{{ app.session.flashBag.peek('eccube.login.target.path') }}
{{ app.session.flashbag.get('password_reset_complete') }}
// アラートまわり
{{ app.session.flashbag.get('eccube.front.error') }}
{{ app.session.flashbag.get('eccube.front.warning') }}
# app.request Request 情報を取得する方法
Request 情報を取得するには、app.request 変数を使用します。
// リクエストのHTTPメソッド
{{ app.request.getMethod() }}
// ページ処理
{{ app.request.query.all|merge({'page_no': pages.first}) }}
{{ app.request.query.all|merge({'page_no': pages.next}) }}
// 遷移元
{{ app.request.query.get('return') }}
// httpからスタートしてポートまでURL
{{ app.request.schemeAndHttpHost }}
// パス関係
{{ app.request.basePath }}
{{ app.request.baseUrl }}