mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-01 03:26:36 +08:00
50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
テンプレートエンジンを使う
|
|
==========================
|
|
|
|
デフォルトでは、Yii は PHP をテンプレート言語として使いますが、[Twig](https://twig.symfony.com/) や
|
|
[Smarty](https://www.smarty.net/) などの他のレンダリング・エンジンをサポートするように Yii を構成することが出来ます。
|
|
|
|
`view` コンポーネントがビューのレンダリングに責任を持っています。
|
|
このコンポーネントのビヘイビアを構成することによって、カスタム・テンプレート・エンジンを追加することが出来ます。
|
|
|
|
```php
|
|
[
|
|
'components' => [
|
|
'view' => [
|
|
'class' => 'yii\web\View',
|
|
'renderers' => [
|
|
'tpl' => [
|
|
'class' => 'yii\smarty\ViewRenderer',
|
|
//'cachePath' => '@runtime/Smarty/cache',
|
|
],
|
|
'twig' => [
|
|
'class' => 'yii\twig\ViewRenderer',
|
|
'cachePath' => '@runtime/Twig/cache',
|
|
// twig のオプションの配列
|
|
'options' => [
|
|
'auto_reload' => true,
|
|
],
|
|
'globals' => ['html' => '\yii\helpers\Html'],
|
|
'uses' => ['yii\bootstrap'],
|
|
],
|
|
// ...
|
|
],
|
|
],
|
|
],
|
|
]
|
|
```
|
|
|
|
上記のコードにおいては、Smarty と Twig の両者がビュー・ファイルによって使用可能なものとして構成されています。
|
|
しかし、これらのエクステンションをプロジェクトで使うためには、`composer.json` ファイルも修正して、これらのエクステンションを含める必要があります。
|
|
|
|
```
|
|
"yiisoft/yii2-smarty": "~2.0.0",
|
|
"yiisoft/yii2-twig": "~2.0.0",
|
|
```
|
|
上のコードを `composer.json` の `require` セクションに追加します。変更をファイルに保存した後、コマンドラインで `composer update --prefer-dist` を実行することによってエクステンションをインストールすることが出来ます。
|
|
|
|
具体的にテンプレート・エンジンを使用する方法については、それぞれのドキュメントで詳細を参照してください。
|
|
|
|
- [Twig ガイド](https://www.yiiframework.com/extension/yiisoft/yii2-twig/doc/guide/)
|
|
- [Smarty ガイド](https://www.yiiframework.com/extension/yiisoft/yii2-smarty/doc/guide/)
|