ThinkPHP内置了一个基于XML的编译型模板引擎,本篇开始对其内置的标签做深入的讲解,如果你使用的是Smarty等第三方模板引擎,请忽略。
变量的输出我们已经在快速入门的变量输出中做了详细的描述,后面主要讲解变量的输出判断、循环和控制,以及包含公共模板和资源文件等。
包含公共模板
[-more-]
include标签
使用include标签在当前模板中包含公共模板,例如常见的header和footer等公共模板,include标签最常用的属性是file,但是支持不同的用法,其用法基本和我们常用的模板渲染方法display方法差不多。例如:
包含Public目录下面的header模板
<include file="Public:header" />
复制代码
包含当前模板目录下面的menu模板
<include file="menu" />
复制代码
如果当前使用了多模板主题功能,还可以包含其他主题的模板
<include file="blue:User:read" />
复制代码
表示包含blue模板主题下面的User/read模板文件,include标签所支持的模板深度只能到操作层次,也就是说ThinkPHP默认的模板结构采用的是:主题/模块/操作.模板后缀,使用上述用法包含模板的时候,file属性不需要指定模板后缀,如果你的模板结构不是标准结构,可以采用包含完整模板文件的方式:
<include file="./Tpl/default/header.html" />
复制代码
如果你在file属性中指定了模板文件后缀,则就会认为是包含完整模板的规则,如果你采用的是相对路径包含,那么当前的起始目录应该是项目入口文件所在的位置。
也可以用变量的方式:
<include file="$filename" />
复制代码
但是并不推荐变量调用方式,因为由于模板引擎的编译特性,编译后会被缓存。
参数传递
include标签除了file属性之外,还支持传入一些简单的参数,并直接传递给模板文件使用,举个例子,我们包含一个头部文件,希望在模板文件里面动态指定网页标题和关键字信息,那么可以通过:
<include file="Public:header" title="ThinkPHP框架" keywords="开源WEB开发框架"/>
复制代码
这里我们在包含header公共模板的时候,还传入了title和keywords两个参数,我们来看下header模板文件怎么接收这些参数:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>[title]</title> <meta name="keywords" content="[keywords]" /> </head>
复制代码
模板文件中的[title]和[keywords]来替换include标签中传入的参数。
包含多个模板
从3.1版本开始,include标签可以支持同时包含多个模板文件,例如:
<include file="Public:header,Public:menu" />
复制代码
也可以支持不同方式的包含混合,例如:
<include file="Public:header,./Tpl/default/menu.html" />
复制代码
嵌套包含模板
include标签支持嵌套使用,例如,我们可以在header公共模板文件中再次包含另外一个公共模板:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>[title]</title> <meta name="keywords" content="[keywords]" /> </head> <include file="Public:menu" />
复制代码
并且理论上不限制嵌套层次,只要避免不发生循环嵌套的情况即可。
总结
include标签可以一定程度上简化重复的模板书写,和便于同步修改,不足就是如果公共模板文件发生更改,但是当前的主模板文件没有更改,则不会自动更新模板缓存,除非你设置了模板缓存有效期,那么在缓存过期后会自动更新模板缓存。