1.模版定义
默认的模板文件定义规则是:
模板目录/模板主题/[分组名/]模块名/操作名+模板后缀
模板目录默认是项目下面的Tpl, 模板主题默认是default,模板主题功能是为了多模板切换而设计的,如果有多个模板主题的话,可以用TMPL_DEFAULT_THEME 参数设置默认的模板主题名。
在每个模板主题下面,是以项目的模块名为目录,然后是每个模块的具体操作模板文件,例如:
User模块的add操作 对应的模板文件就应该是:Tpl/default/User/add.html
模板文件的默认后缀的情况是.html,也可以通过TMPL_TEMPLATE_SUFFIX来配置成其他的。
如果项目启用了模块分组功能(假设User模块属于Home分组),那么默认对应的模板文件可能变成:Tpl/default/Home/User/add.html
2. 模版赋值
要在模板中输出变量,必须在在Action类中把变量传递给模板,视图类提供了 assign方法对模板变量赋值,无论何种变量类型都统一使用assign赋值。
3.模版调用
模板变量赋值后就需要调用模板文件来输出相关的变量,模板调用通过display方法来实现,我们在操作方法的最后使用:
$this->display();
根据前面的模板定义规则,因为系统会按照默认规则自动定位模板文件,所以通常display方法无需带任何参数即可输出对应的模板,这是模板输出的最简单的用法.
一、调用当前模块的其他操作模板
格式:display('操作名')
例如,假设当前操作是User模块下面的read操作,我们需要调用User模块的edit操作模版,使用:
$this->display('edit');
不需要写模板文件的路径和后缀。
二、调用其他模块的操作模板
格式:display('分组名:模块名:操作名') 其中分组名是可选的
例如,当前是User模块,我们需要调用Member模块的read操作模版,使用:
$this->display('Member:read');
三、调用其他主题的操作模板
格式:display('主题名@模块名:操作名')
例如我们需要 调用Xp主题的User模块的edit操作模版,使用:
$this->display('Xp@User:edit');
四、直接全路径输出模板
格式:display('模板文件名')
例如,我们直接输出当前的Public目录下面的menu.html模板文件,使用:
$this->display('./Public/menu.html');
这种方式需要指定模板路径和后缀,这里的Public目录是位于当前项目入口文件位置下面,如果是其他的后缀文件,也支持直接输出
4.模板替换
在进行模板输出之前,系统还会对渲染的模板结果进行一些模板的特殊字符串替换操作,也就是实现了模板输出的替换和过滤,这个机制可以使得模板文件的定义更加方便,默认的替换规则有:
./ Public: 会被替换成当前项目的公共模板目录 通常是 /项目目录/Tpl/default/Public/
__ PUBLIC __:会被替换成当前网站的公共目录 通常是 /Public/
__ TMPL __: 会替换成项目的模板目录 通常是 /项目目录/Tpl/dfault/
__ ROOT __: 会替换成当前网站的地址(不含域名)
__ APP __: 会替换成当前项目的URL地址 (不含域名)
__ URL __: 会替换成当前模块的URL地址(不含域名)
__ ACTION __:会替换成当前操作的URL地址 (不含域名)
__ SELF __: 会替换成当前的页面URL
注意这些特殊的字符串是严格区别大小写的,并且这些特殊字符串的替换规则是可以更改或者增加的,我们只需要在项目配置文件中配置TMPL_PARSE_STRING就可以完成,如果有相同的数组索引,就会更改系统的默认规则:
- TMPL_PARSE_STRING => array(
- '__ PUBLIC __' => '/Common', // 更改默认的__ PUBLIC __ 替换规则
- '__UPLOAD__' => '/Public/Uploads/', // 增加新的上传路径替换规则
- )
5. 获取内容
有些时候我们不想直接输出模板内容,而是希望对内容再进行一些处理后输出,就可以使用fetch方法来获取解析后的模板内容,在Action类里面使用:
$content = $this->fetch();
fetch的参数用法和Display方法基本一致,
6. 静态生成
ThinkPHP提供了灵活的静态文件生成功能,可以在输出模板的同时生成需要的静态文件,以供调用.
在Action中使用buildHtml方法即可创建静态文件,buildHtml方法的第一个参数就要生成的静态文件名,后面的参数和display方法一致,内部其实是调用了前面提到的fetch方法获取模板输出然后创建静态文件,用法如下:
$this->buildHtml('静态文件', '静态路径','模板文件');
静态路径如果留空的话 默认保存在HTML_PATH(默认的HTML_PATH路径位于项目目录下面的Html目录,如果没有的话手动创建)定义的路径下面,静态文件可以随意设置,也可以包括路径,如果不存在的路径系统会自动创建
7. 模板引擎
系统支持原生的PHP模板,而且本身内置了一个基于XML的高效的编译型模板引擎,无论在功能还是性能方面都优秀过Smarty,系统默认使用的模板引擎是内置模板引擎,关于这个模板引擎的标签详细使用可以参考模板指南部分。
内置的模板引擎也可以直接支持在模板文件中采用PHP原生代码和模板标签的混合使用,如果需要完全使用PHP本身作为模板引擎,可以配置:
'TMPL_ENGINE_TYPE' => 'PHP'
可以达到最佳的效率
8. 使用第三方模板引擎
系统支持模板引擎的扩展机制,并且官方提供了包括Smarty、EaseTemplate、TemplateLite和Smart在内的第三方模板引擎扩展。我们以Smarty模板引擎为例,来说明下如何使用第三方模板引擎。
首先,需要下载官方的模板引擎扩展,并放到系统目录的LibThinkUtilTemplate目录下面,然后,下载最新的Smarty模板引擎文件放到系统目录的Vendor第三方类库目录。
剩下的,我们要做的只是简单的配置下模板引擎名称即可,例如在项目配置文件里面设置:'TMPL_ENGINE_TYPE' => 'Smarty'
区别就在于display方法直接输出模板文件渲染后的内容,而fetch方法是返回模板文件渲染后的内容。如何对返回的结果content进行处理,完全由开发人员自行决定了。这是模板替换的另外一种高级方式,比较灵活,而且不需要通过配置的方式。
注意,fetch方法仍然会执行上面的模板替换操作。
9.布局模版
10.系统模板
系统有一些内置的模板文件用于异常页面和页面Trace功能的输出,你可以定制这些模板页面,满足自己的需要。默认的系统模板主要有:
页面Trace模板:默认位于系统目录的Tpl/PageTrace.tpl.php 是一个php文件,可更改TMPL_TRACE_FILE进行配置.
异常模板:默认位于系统目录的Tpl/ThinkException.tpl.php,可以更改TMPL_EXCEPTION_FILE进行配置.