CodeIgniter4用のTwig組み込みです。
Composerで導入可能です。CI4やTwigも予めComposerでインストールしておいてください。
$ composer require sarah-systems/ci4twig
デフォルトでは、Twig関連のパスは自体は次のような設定で動作するようになっています。
種類 | パス |
---|---|
テンプレート | app/Views |
キャッシュ | writable/twig/cache |
writable
が正しく書き込み可能な場合、下の3つのディレクトリは自動的に生成されます。
もしエラーが起きた場合は、これらのディレクトリを作って適切なパーミッションを与えることで動作します。
もしこのパスを変更したい場合は.env
ファイルに次のパラメータをセットすることで、任意のパスに変更可能です。
CI4Twig.TemplateDir = /path/to/TemplateDir
CI4Twig.CacheDir = /path/to/CacheDir
これ以外にも.env
では、TwigのDebugフラグのOn/Offとデフォルトの拡張子を設定できます。
CI4Twig.Debug = 1 または 0
CI4Twig.DefaultTemplateExtension = .html.twig
デフォルトの拡張子を設定すると、view()関数で
CI4のview関数をTwig用にCI4Twigというnamespaceで定義しています。
利用する際はapp
ディレクトリ直下のCommon.php
に次を追記してください。
require_once ROOTPATH . "vendor/sarah-systems/ci4twig/src/Common.php";
使用法はCI4のview関数と同じですが、関数の利用時には名前空間を指定するか、事前にエイリアスを張ってください。
\CI4Twig\view('template.html.twig');
または
use function CI4Twig\view as view;
view('template.html.twig');
拡張子.html.twig
(CI4Twig.DefaultTemplateExtension
で設定されたものです。無指定の場合は.html.twig
)は省略可能です。
\CI4Twig\view('template');
view関数の第2パラメータはTwig変数$CI
にアサインされます。
$data = [ 'apple' , 'banana' , 'lemon' ];
\CI4Twig\view('template',$data);
Twigのtemplate上では
{{ CI.0 }} ← appleが表示されます。
第3引数の$optionsは無視されます。
CI4のServiceが利用可能です。
use CI4Twig\Config\Services;
$time = date('Y-m-d H:i:s');
$twig = Services::twig();
$twig->Environment->addGlobal('time',$time);
$twig->Environment->display('template.html.twig');
The source code is licensed MIT. The website content is licensed CC BY 4.0,see LICENSE.