Twigのインストール

ComposerからTwigをインストールします。

まず、composer.jsonに設定を追加します。ここでは、バージョンは「1.*」としてTwig 1.xの最新版を指定しています。

diff --git a/composer.json b/composer.json
index e1b21ea..2e8f6da 100644
--- a/composer.json
+++ b/composer.json
@@ -18,7 +18,8 @@
     "require": {
         "php": ">=5.3.3",
         "monolog/monolog": "1.5.*",
-        "fuelphp/upload": "2.0.1"
+        "fuelphp/upload": "2.0.1",
+        "twig/twig" : "1.*"
     },
     "suggest": {
         "mustache/mustache": "Allow Mustache templating with the Parser package",

composerからインストールします。

$ php composer.phar update

config.phpでParserパッケージを有効にします。

diff --git a/fuel/app/config/config.php b/fuel/app/config/config.php
index 5993891..16840eb 100644
--- a/fuel/app/config/config.php
+++ b/fuel/app/config/config.php
@@ -257,7 +257,7 @@ return array(
    /**************************************************************************/
    /* Always Load                                                            */
    /**************************************************************************/
-   // 'always_load'  => array(
+   'always_load'  => array(

        /**
         * These packages are loaded on Fuel's startup.
@@ -270,9 +270,10 @@ return array(
         *     array('auth' => PKGPATH.'auth/')
         * );
         */
-       // 'packages'  => array(
+       'packages'  => array(
        //  //'orm',
-       // ),
+           'parser',
+       ),

        /**
         * These modules are always loaded on Fuel's startup. You can specify them
@@ -308,6 +309,6 @@ return array(
         * If you don't want the lang in a group use null as groupname.
         */
        // 'language'  => array(),
-   // ),
+   ),

 );

テンプレートの拡張子の設定

FuelPHPでのテンプレートエンジンと対応する拡張子の設定は、fuel/packages/parser/config/parser.phpにあります。デフォルトは以下のようになっています。

    'extensions' => array(
        'php'       => 'View',
        'twig'      => 'View_Twig',
        'mthaml'    =>  array('class' => 'View_HamlTwig', 'extension' => 'twig'),
        'mustache'  => 'View_Mustache',
        'md'        => 'View_Markdown',
        'dwoo'      => array('class' => 'View_Dwoo', 'extension' => 'tpl'),
        'jade'      => 'View_Jade',
        'haml'      => 'View_Haml',
        'smarty'    => 'View_Smarty',
        'phptal'    => 'View_Phptal',
    ),

'twig' => 'View_Twig'となっているため、デフォルトでは拡張子twigのファイルがテンプレートとされます。

エスケープについて

FuelPHPでのTwigの設定は、fuel/packages/parser/config/parser.phpにあります。デフォルトは以下のようになっています。

    // TWIG ( http://www.twig-project.org/documentation )
    // ------------------------------------------------------------------------
    'View_Twig' => array(
        'auto_encode' => true,
        'views_paths' => array(APPPATH.'views'),
        'delimiters' => array(
            'tag_block'     => array('left' => '{%', 'right' => '%}'),
            'tag_comment'   => array('left' => '{#', 'right' => '#}'),
            'tag_variable'  => array('left' => '{{', 'right' => '}}'),
        ),
        'environment' => array(
            'debug'                => false,
            'charset'              => 'utf-8',
            'base_template_class'  => 'Twig_Template',
            'cache'                => APPPATH.'cache'.DS.'twig'.DS,
            'auto_reload'          => true,
            'strict_variables'     => false,
            'autoescape'           => false,
            'optimizations'        => -1,
        ),
        'extensions' => array(
            'Twig_Fuel_Extension'
        ),
    ),

ここで、'auto_encode' => trueは、FuelPHPでの自動エスケープ（Viewに渡す時の自動エスケープ）が有効、'autoescape' => falseは、Twigでの自動エスケープが無効、という意味です。

デフォルトがTwigの標準とは異なりますので、注意してください。

テンプレートの指定方法

通常は、公式ドキュメントにあるように、拡張子twigを付けたファイル名を指定します。

Response::forge(View::forge('index.twig'));

以下のようにView_Twigオブジェクトを生成する方法もあります。

 Response::forge(View_Twig::forge('index'));

Twigの拡張

Twigの拡張をFuelPHPで使う方法は、以下の記事が詳しいです。

• FuelPHPでTwig Extension #FuelPHPAdvent2013