ThinkPHP内置了一个基于XML的编译型模板引擎,本篇开始对其内置的标签做深入的讲解,如果你使用的是Smarty等第三方模板引擎,请忽略。
变量的输出我们已经在快速入门的变量输出中做了详细的描述,后面主要讲解变量的输出判断、循环和控制,以及包含公共模板和资源文件等。
包含Public目录下面的header模板
也可以用变量的方式:
变量的输出我们已经在快速入门的变量输出中做了详细的描述,后面主要讲解变量的输出判断、循环和控制,以及包含公共模板和资源文件等。
包含公共模板
[-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标签中传入的参数。<head>
<title>[title]</title>
<Meta name="keywords" content="[keywords]" />
</head>
包含多个模板
从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" />
并且理论上不限制嵌套层次,只要避免不发生循环嵌套的情况即可。<head>
<title>[title]</title>
<Meta name="keywords" content="[keywords]" />
</head>
<include file="Public:menu" />