Download the PHP package windwork/template without Composer

Windwork模板引擎

Windwork模板引擎模板引擎是一个超轻量级“编译”型模板引擎,10分钟即可完全掌握。

Windwork通过模板引擎将视图从业务逻辑分离，便于前端与程序的分工协作。前端或设计师只需要简单的模板标签语法即可进行模板开发。 视图层将模型化的数据渲染为某种表现形式。负责用它得到的信息生成应用程序需要的任何表现界面。

模板示例

安装

该组件已包含在Windwork框架中，如果你已安装Windwork框架则可以直接使用。

• 安装方式一：通过composer安装（推荐）

• 安装方式二：传统方式安装
  下载源码后，解压源码到项目文件夹中，然后require_once $PATH_TO_WF/core/lib/Loader.php文件，即可自动加载组件中的类。

1、模板文件夹

• 默认模板文件放在 ./template/，可自定义模板文件夹。
• 建议系统管理后台、前台PC版、前台手机版可以分开存放到不同的文件夹中。
• 模板引擎提供自定义模板文件夹的配置，详见模板引擎配置参数部分

Windwork模板引擎

2、使用模板

在Windwork控制器中使用 $this->view()调用模板实例。

2.1 模板变量赋值：

2.2 显示模板：

默认模板文件存放于模块文件夹下的view文件夹中，使用render方法显示模板。

2.3 在控制器中使用模板

如下为在Windwork MVC的控制器中使用模板引擎

3、模板引擎语法

3.1 输出

输出代码写在两对大括号中间，如{{$var}} 被解析成 。 {{后不能有空格，否则不会被解析。 非输出标签只有一对大括号。

3.1.1 变量输出

• 标量变量 {{$var}}
• 数组变量 {{$arr[key]}}
• 多维数组 {{$arr[key1][key2]}}

3.1.2 常量输出

{{CONST_XX}} // 模板中的常量约定全部为大写

3.1.3 调用类、对象、函数并输出返回值

• 使用双大括号{{}}调用函数、方法并输出内容，
• 如果不输出内容，使用{# ... #}

3.1.4 url 链接标签

1)使用url标签 {{url $mod.$ctl.$act/param1/param2/paramk1:paramv1/...}} 2)使用url函数 {{url("$mod.$ctl.$act/param1/param2/paramk1:paramv1/...")}}

3.1.5 lang

3.1.5.1 lang 语言标签：

{{lang nickname}}

3.1.5.2 lang函数：

{{lang("nickname")}}

3.1.5.3 {{lang xx}}与 {{lang('xx')}}的区别：

• {{lang xx}} 被模板引擎直接解析为语言变量值，lang标签后面不能是变量；
• {{lang('xx')}} 被模板引擎解析为函数调用，lang()参数可以是变量； 如：

3.2 模板逻辑运算标签

3.2.1 foreach

3.2.2 if

3.2.3 for

4、扩展语法

4.1 执行代码段

• 1）{# ... #}

• 2）可以直接使用PHP标签

4.2 static 不解析内容标签

模板中有些部分我们不希望进行解析“编译”，这时我们需要使用static标签。

4.3 模板继承

模板继承可以在父模板中定义继承后的模板中可重新定义的区域。

4.3.1 使用模板继承

第一步，使用ext标签定义继承的模板文件，如下

第二步，使用block标签在父模板文件定义可修改的区块，然后在继承的模板中使用同样的区块名修改区块内容。

案例：使用区块定义重写父模板中的区块

父模板

子模板extend.html 继承 base_tpl.html

extend.html模板解析后内容为

4.3.2 保留父模板区块内容的语法

在继承模板的区块中嵌入{parent}标签，该标签将被替换成父区块中的代码。

将解析为

4.4 模板注释

1） 模板标签注释

可在模板标签两边加上HTML注释，模板解析时自动清掉HTML注释

服务端注释

使用 { 注释内容 } 的格式添加模板注释，模板编译后自动去掉注释内容。

5、单独使用Windwork模板引擎

Windwork控制器中已经初始化好模板引擎，你只需要在配置文件中设置模板参数即可。而当你只使用windwork模板引擎，不使用完整的windwork MVC时，创建模板对象案例如下：

6、配置参数

通过模板引擎构造函数设置模板配置参数，可配置参数如下：

注：为灵活支持模板文件的查找，模板目录选项可使用{0}、{1}、{2}等匹配规则，运行时$view->render($file)的$file参数中的第n个文件夹将替换掉大括号中对应的n数字的配置。 例如：

7、自定义模板引擎

如果你有兴趣，也可以自定义模板引擎，在Windwork中使用。 请implements \wf\template\EngineInterface 接口实现自定义模板。

要了解更多？

• 官方完整文档首页
• 官方源码首页