模板引擎使用詳解：包含公共模板

weixin_34119545發表於2014-11-17

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標籤可以一定程度上簡化重複的模板書寫，和便於同步修改，不足就是如果公共模板檔案發生更改，但是當前的主模板檔案沒有更改，則不會自動更新模板快取，除非你設定了模板快取有效期，那麼在快取過期後會自動更新模板快取。

相關文章