sygytyr / yii2-mustache
为 Yii 框架提供的 Mustache 模板。
dev-master
2024-06-13 11:46 UTC
Requires
- php: >=7.1.0
- ext-json: *
- ext-mbstring: *
- ext-pcre: *
- mustache/mustache: ^2.12.0
- psr/log: ^1.0.2
- yiisoft/yii2: ^2.0.13
Requires (Dev)
- cedx/coveralls: ^6.0.0
- cedx/phpunit-expect: ^0.4.0
- phing/phing: ^2.16.0
This package is auto-updated.
Last update: 2024-09-13 12:28:02 UTC
README
此包提供了一种视图渲染器,即 yii\mustache\ViewRenderer
类。此渲染器允许在视图模板中使用 Mustache 语法。
要求
最新版本的 PHP 和 Composer。如果您打算与源代码一起玩耍,您还需要最新版本的 Phing。
通过 Composer 安装
从命令提示符运行
$ composer global require fxp/composer-asset-plugin $ composer require sygytyr/yii2-mustache
配置应用程序
为了开始使用 Mustache,您需要配置 view
应用程序组件,如下所示
use yii\mustache\{ViewRenderer}; use yii\web\{View}; return [ 'components' => [ 'view' => [ 'class' => View::class, 'renderers' => [ 'mustache' => ViewRenderer::class ] ] ] ];
完成后,您可以在具有 .mustache
扩展名的文件中创建模板(或使用其他文件扩展名,但相应地配置组件)。与标准视图文件不同,在使用 Mustache 时,您必须在 $this->render()
控制器调用中包含扩展名。
return $this->render('template.mustache', [ 'model' => 'The view model' ]);
模板语法
学习 Mustache 基础的最好资源是您可以在 mustache.github.io 找到的官方文档。此外,下面还描述了特定于 Yii 的语法扩展。
变量
在 Mustache 模板中,以下变量始终定义
app
:Yii::$app
实例。this
:当前的View
对象。yii.debug
:YII_DEBUG
常量。yii.devEnv
:YII_ENV_DEV
常量。yii.prodEnv
:YII_ENV_PROD
常量。yii.testEnv
:YII_ENV_TEST
常量。
lambda
format
:提供一组常用数据格式化方法。html
:提供一组用于生成常用 HTML 标签的方法。i18n
:提供与国际化(I18N)和本地化(L10N)相关的功能。url
:提供一组用于管理 URL 的方法。
部分
有两种方式来引用部分
{{> post }}
{{> @app/views/layouts/2columns }}
在第一种情况下,视图将在相对当前视图路径的位置搜索。对于 post.mustache
,这意味着这些将在当前渲染模板的同一目录中搜索。
在第二种情况下,我们使用路径别名。所有默认的 Yii 别名,如 @app
,都是可用的。
另请参阅
许可证
Mustache for Yii 在 MIT 许可证下分发。