編輯“ThinkPHP-模板指南-包含文件”

<span style="border:1px solid #000; float:right; text-align:center; padding:6px;"><strong>導(dǎo)航：</strong>[[ThinkPHP-模板指南|返回上一頁]]</span>
<div style="clear:both;"></div>

可以使用Include標(biāo)簽來包含外部的[[模板]]文件，使用方法如下： 

*使用完整文件名包含

'''格式'''：<include file="完整模板文件名" />

'''例如'''：[[XML]]/[[HTML]]代碼
<pre>
<include file="./Tpl/default/Public/header.html" />   
</pre>

這種情況下，模板文件名必須包含后綴。使用完整文件名包含的時(shí)候，特別要注意文件包含指的是服務(wù)器端包含，而不是包含一個(gè)[[URL]]地址，也就是說file參數(shù)的寫法是服務(wù)器端的路徑，如果使用相對路徑的話，是基于項(xiàng)目的入口文件位置。

*包含當(dāng)前模塊的其他操作模板文件

'''格式'''：<include file="操作名" />

'''例如''': 導(dǎo)入當(dāng)前模塊下面的read操作模版：XML/HTML代碼
<pre>
<include file="read" />   
</pre>

操作模板無需帶后綴。

*包含其他模塊的操作模板

'''格式'''：<include file="模塊名:操作名" />

'''例如''':包含Public模塊的header操作模版：XML/HTML代碼
<pre>
<include file="Public:header" />   
</pre>

*包含其他模板主題的模塊操作模板

'''格式'''：<include file="主題名@模塊名:操作名" />

'''例如''':包含blue主題的User模塊的read操作模版：

'''XML/HTML代碼'''
<pre>
<include file="blue@User:read" />   
</pre>

*用變量控制要導(dǎo)入的模版

'''格式'''：<include file="$變量名" />

'''例如''':XML/HTML代碼
<pre>
<include file="$tplName" />   
</pre>
給$tplName賦不同的值就可以包含不同的模板文件，變量的值的用法和上面的用法相同。

*使用快捷方式包含文件

'''格式'''：{include:模板文件規(guī)則}

其中的模板文件規(guī)則可以使用上面提到的5種方式。

'''注意'''：由于模板解析的特點(diǎn)，從入口模板開始解析，如果外部模板有所更改，模板引擎并不會重新編譯模板，除非緩存已經(jīng)過期。如果修改了包含的外部模板文件后，需要把模塊的緩存目錄清空，否則無法生效。


[[category:ThinkPHP]]