Twig

概要

Twigは、PHPのための柔軟で安全、かつ高速なテンプレートエンジンです。Symfonyプロジェクトの一部として開発され、シンプルで表現力豊かな構文を特徴としています。

インストールと設定

Composerでのインストール

composer require "twig/twig:^3.0"

基本セットアップ

<?php
require_once '/path/to/vendor/autoload.php';

$loader = new \Twig\Loader\FilesystemLoader('/path/to/templates');
$twig = new \Twig\Environment($loader, [
    'cache' => '/path/to/compilation_cache',
    'debug' => true,
    'auto_reload' => true
]);

基本構文

変数の出力

{# 基本的な変数の出力 #}
{{ name }}
{{ user.name }}
{{ user['name'] }}

{# HTMLエスケープ #}
{{ data|escape }}
{{ data|e }}

制御構文

条件分岐

{% if user.isLoggedIn %}
    <h1>ようこそ、{{ user.name }}さん</h1>
{% else %}
    <h1>ログインしてください</h1>
{% endif %}

ループ

{% for item in items %}
    <div class="item">
        <h2>{{ item.title }}</h2>
        <p>{{ item.description }}</p>
    </div>
{% else %}
    <p>アイテムが見つかりません</p>
{% endfor %}

テンプレート継承

親テンプレート

base.html.twig

<!DOCTYPE html>
<html>
    <head>
        <title>{% block title %}{% endblock %}</title>
        {% block stylesheets %}{% endblock %}
    </head>
    <body>
        {% block body %}{% endblock %}
        {% block javascripts %}{% endblock %}
    </body>
</html>

子テンプレート

page.html.twig

{% extends 'base.html.twig' %}

{% block title %}ページタイトル{% endblock %}

{% block body %}
    <h1>コンテンツ</h1>
{% endblock %}

フィルタ

組み込みフィルタ

date
escape/e
upper
lower
trim
nl2br
raw
length

カスタムフィルタ

$filter = new \Twig\TwigFilter('price', function ($number) {
    return number_format($number, 2) . '円';
});
$twig->addFilter($filter);

関数

組み込み関数

range
date
dump
include
max
min
random

カスタム関数

$function = new \Twig\TwigFunction('calculateTax', function ($amount) {
    return $amount * 1.1;
});
$twig->addFunction($function);

マクロ

マクロの定義と使用

{% macro input(name, value, type = "text", size = 20) %}
    <input type="{{ type }}" name="{{ name }}" value="{{ value|e }}" size="{{ size }}">
{% endmacro %}

{% import "forms.html" as forms %}
{{ forms.input('username') }}

インクルードとエンベッド

インクルード

{% include 'header.html' %}
{% include 'sidebar.html' with {'items': menu_items} %}

エンベッド

{% embed "base_sidebar.html" %}
    {% block sidebar %}
        <h3>カスタムサイドバー</h3>
    {% endblock %}
{% endembed %}

エクステンション

コアエクステンション

StringLoader
Debug
Sandbox
Optimizer
Profiler

カスタムエクステンション

class CustomExtension extends \Twig\Extension\AbstractExtension
{
    public function getFilters()
    {
        return [
            new \Twig\TwigFilter('custom', [$this, 'customFilter']),
        ];
    }

    public function customFilter($value)
    {
        // フィルタの処理
    }
}

セキュリティ

サンドボックス機能

タグの制限
フィルタの制限
関数の制限

エスケープ戦略

HTML自動エスケープ
JavaScriptエスケープ
CSSエスケープ

パフォーマンス最適化

キャッシュ設定

コンパイルキャッシュ
オートリロード
最適化オプション

ベストプラクティス

テンプレートの分割
キャッシュの活用
適切なエスケープ処理

デバッグ

デバッグツール

dump()関数
プロファイラ
エラーハンドリング

開発環境設定

デバッグモード
厳密な変数チェック
自動リロード

統合

フレームワーク統合

Symfony
Laravel
Slim
CodeIgniter

その他のツール

PHPUnit
Composer
IDE支援

APIリファレンス

主要なクラス

Environment
LoaderInterface
Template
Extension

コミュニティリソース

ドキュメント

公式ドキュメント
チュートリアル
クックブック

サポート

Stack Overflow
GitHub Issues
コミュニティフォーラム