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就可以完成,如果有相同的数组索引,就会更改系统的默认规则:

1. TMPL_PARSE_STRING  => array(    
2.       '__ PUBLIC __' => '/Common',  // 更改默认的__ PUBLIC __ 替换规则    
3.      '__UPLOAD__' => '/Public/Uploads/',  // 增加新的上传路径替换规则    
4. ) 

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.布局模版

<!-- layout::模板文件规则::缓存时间（秒） -->

<!-- layout::Public:header::60 -->

10.系统模板

系统有一些内置的模板文件用于异常页面和页面Trace功能的输出,你可以定制这些模板页面，满足自己的需要。默认的系统模板主要有：

页面Trace模板:默认位于系统目录的Tpl/PageTrace.tpl.php 是一个php文件,可更改TMPL_TRACE_FILE进行配置.

异常模板:默认位于系统目录的Tpl/ThinkException.tpl.php,可以更改TMPL_EXCEPTION_FILE进行配置.

Tags: ThinkPHP 模版 笔记

分享到：