sygytyr/yii2-mustache

为 Yii 框架提供的 Mustache 模板。

安装: 1

依赖者: 0

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 0

开放问题: 0

类型:yii2-extension

dev-master 2024-06-13 11:46 UTC

This package is auto-updated.

Last update: 2024-09-13 12:28:02 UTC


README

Runtime Release License Downloads Coverage Build

Mustache 模板为 Yii,高性能 PHP 框架。

此包提供了一种视图渲染器,即 yii\mustache\ViewRenderer 类。此渲染器允许在视图模板中使用 Mustache 语法

要求

最新版本的 PHPComposer。如果您打算与源代码一起玩耍,您还需要最新版本的 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 模板中,以下变量始终定义

  • appYii::$app 实例。
  • this:当前的 View 对象。
  • yii.debugYII_DEBUG 常量。
  • yii.devEnvYII_ENV_DEV 常量。
  • yii.prodEnvYII_ENV_PROD 常量。
  • yii.testEnvYII_ENV_TEST 常量。

lambda

  • format:提供一组常用数据格式化方法。
  • html:提供一组用于生成常用 HTML 标签的方法。
  • i18n:提供与国际化(I18N)和本地化(L10N)相关的功能。
  • url:提供一组用于管理 URL 的方法。

部分

有两种方式来引用部分

{{> post }}
{{> @app/views/layouts/2columns }}

在第一种情况下,视图将在相对当前视图路径的位置搜索。对于 post.mustache,这意味着这些将在当前渲染模板的同一目录中搜索。

在第二种情况下,我们使用路径别名。所有默认的 Yii 别名,如 @app,都是可用的。

另请参阅

许可证

Mustache for Yii 在 MIT 许可证下分发。