display與show方法怎么在thinkphp3.x中使用

這期內容當中小編將會給大家帶來有關display與show方法怎么在thinkphp3.x中使用，文章內容豐富且以專業的角度為大家分析和敘述，閱讀完這篇文章希望大家可以有所收獲。

一、模板定義

為了對模板文件更加有效的管理，ThinkPHP對模板文件進行目錄劃分，默認的模板文件定義規則是：

模板目錄/[分組名/][模板主題/]模塊名/操作名+模板后綴

模板目錄默認是項目下面的Tpl， 當定義分組的情況下，會按照分組名分開子目錄，新版模板主題默認是空（表示不啟用模板主題功能），

模板主題功能是為了多模板切換而設計的，如果有多個模板主題的話，可以用DEFAULT_THEME參數設置默認的模板主題名。

在每個模板主題下面，是以項目的模塊名為目錄，然后是每個模塊的具體操作模板文件，例如：

User模塊的add操作 對應的模板文件就應該是：

Tpl/User/add.html

模板文件的默認后綴是.html，也可以通過TMPL_TEMPLATE_SUFFIX來配置成其他的。例如，我們可以配置：

'TMPL_TEMPLATE_SUFFIX'=>'.tpl'

定義后，User模塊的add操作 對應的模板文件就變成是：

Tpl/User/add.tpl

如果項目啟用了模塊分組功能（假設User模塊屬于Home分組），那么默認對應的模板文件可能變成 ：

Tpl/Home/User/add.html

分組模式下面，如果覺得目錄結構太深，可以通過設置TMPL_FILE_DEPR參數來配置簡化模板的目錄層次，例如設置：

'TMPL_FILE_DEPR'=>'_'

默認的模板文件就變成了：

Tpl/Home/User_add.html

正是因為系統有這樣一種模板文件自動識別的規則，所以給我們的模板渲染輸出帶來了簡化。

二、模板渲染

模板定義后就可以通過display和show方法來渲染輸出。其中display方法需要我們有定義模板文件，而show方法則是直接渲染內容輸出。

最常用的是display方法，調用格式：

第一種：

display('[主題:][模塊:][操作]'[,'字符編碼'][,'輸出類型'])

第二種：

display('完整的模板文件名'[,'字符編碼'][,'輸出類型'])

下面是一個最典型的用法，不帶任何參數：

$this->display();

表示系統會按照默認規則自動定位模板文件，所以通常display方法無需帶任何參數即可輸出對應的模板，這是模板輸出的最簡單的用法。

如果沒有按照模板定義規則來定義模板文件，或者我需要調用其他模塊下面的某個模板，可以使用：

$this->display('edit');

表示調用當前模塊下面的edit模板

$this->display('Member:read');

表示調用Member模塊下面的read模板。

如果我們使用了模板主題功能，那么也可以支持跨主題調用，使用：

$this->display('theme:User:edit');

表示調用theme主題下面的User模塊的edit模板。

這種方式的渲染輸出不需要寫模板文件的路徑和后綴，確切地說，這里面的模塊和操作并不一定需要有對應的模塊或者操作，只是一個目錄名稱和文件名稱而已，例如，你的項目里面可能根本沒有Public模塊，更沒有Public模塊的menu操作，但是一樣可以使用

$this->display('Public:menu');

輸出這個模板文件。理解了這個，模板輸出就清晰了。

display方法支持在渲染輸出的時候指定輸出編碼和類型，例如：

$this->display('read', 'utf-8', 'text/xml');

表示輸出XML頁面類型（配合你的應用需求可以輸出很多類型）。

事情總有特例，如果模板目錄是自定義的，或者根本不需要按模塊進行分目錄存放，那么默認的display渲染規則就不能處理，這個時候，我們就需要使用另外一種方式來應對，直接傳入模板文件名即可，例如：

$this->display('./Public/menu.html');

這種方式需要指定模板路徑和后綴，這里的Public目錄是位于當前項目入口文件位置下面。如果是其他的后綴文件，也支持直接輸出，例如：

$this->display('./Public/menu.tpl');

只要./Public/menu.tpl是一個實際存在的模板文件。

要注意模板文件位置是相對于項目的入口文件，而不是模板目錄。

還有一種情況是，你需要獲取渲染模板的輸出內容，就可以使用fetch方法，fetch方法的用法和display基本一致，區別就在于fetch方法渲染后不是直接輸出，而是返回渲染后的內容，例如：

$content = $this->fetch('Member:edit');

使用fetch方法獲取渲染內容后，你可以進行過濾和替換等操作，用于對模板輸出的復雜需求。

如果你沒有定義任何模板文件，或者把模板內容存儲到數據庫中的話，你就需要使用show方法來渲染輸出了，show方法的調用格式：

show('渲染內容'[,'字符編碼'][,'輸出類型'])

例如，

$this->show($content);

也可以指定編碼和類型：

$this->show($content, 'utf-8', 'text/xml');

show方法中的內容也可以支持模板解析。

三、模板賦值

我們知道了如何渲染模板輸出，但是如果要在模板中輸出變量，必須在在控制器中把變量傳遞給模板，提供了assign方法對模板變量賦值，無論何種變量類型都統一使用assign賦值。

$this->assign('name',$value);
//下面的寫法是等效的：
//$this->name = $value;

assign方法必須在display和show方法之前調用，并且系統只會輸出設定的變量，其它變量不會輸出（系統變量可以通過特殊的標簽輸出，可以無需賦值模板變量），一定程度上保證了變量的安全性。

賦值后，就可以在模板文件中輸出變量了，如果使用的是內置模板的話，就可以這樣輸出：

{$name}

如果要同時輸出多個模板變量，可以使用下面的方式：

$array['name'] = 'thinkphp'; 
$array['email'] = 'liu21st@gmail.com'; 
$array['phone'] = '12335678'; 
$this->assign($array);

這樣，就可以在模板文件中同時輸出name、email和phone三個變量。

模板變量的輸出根據不同的模板引擎有不同的方法，我們在后面會專門講解內置模板引擎的用法。如果你使用的是PHP本身作為模板引擎的話 ，就可以直接在模板文件里面輸出了：

<?php echo $name.'['.$email.''.$phone.']';?>

如果采用內置的模板引擎，可以使用：

{$name} [ {$email} {$phone} ]

輸出同樣的內容。

關于更多的模板標簽使用，我們會在后面模板標簽中詳細講解。

四、模板替換

在進行模板輸出之前，系統還可以對渲染的模板結果進行一些模板的特殊字符串替換操作，也就是實現了模板輸出的替換和過濾。這個機制可以使得模板文件的定義更加方便，默認的替換規則有：

../Public： 會被替換成當前項目的公共模板目錄 通常是 /項目目錄/Tpl/當前主題/Public/

__TMPL__： 會替換成項目的模板目錄 通常是 /項目目錄/Tpl/當前主題/

（注：為了部署安全考慮，../Public和__TMPL__不再建議使用）

__PUBLIC__：會被替換成當前網站的公共目錄 通常是 /Public/

__ROOT__： 會替換成當前網站的地址（不含域名）

__APP__： 會替換成當前項目的URL地址 （不含域名）

__GROUP__：會替換成當前分組的URL地址 （不含域名）

__URL__： 會替換成當前模塊的URL地址（不含域名）

__ACTION__：會替換成當前操作的URL地址 （不含域名）

__SELF__： 會替換成當前的頁面URL

注意這些特殊的字符串是嚴格區別大小寫的，并且這些特殊字符串的替換規則是可以更改或者增加的，我們只需要在項目配置文件中配置TMPL_PARSE_STRING就可以完成。如果有相同的數組索引，就會更改系統的默認規則。例如：

'TMPL_PARSE_STRING' =>array( 
  '__PUBLIC__' => '/Common', // 更改默認的/Public 替換規則 
  '__JS__' => '/Public/JS/', // 增加新的JS類庫路徑替換規則 
  '/Uploads' => '/Uploads', // 增加新的上傳路徑替換規則 
)

有了模板替換規則后，頁面上所有的__PUBLIC__ 字符串都會被替換，那如果確實需要輸出__PUBLIC__ 字符串到模板呢，我們可以通過增加替換規則的方式，例如：

'TMPL_PARSE_STRING' =>array( 
  '--PUBLIC--' => '__PUBLIC__', // 采用新規則輸出/Public字符串 
)

這樣增加替換規則后，如果我們要輸出__PUBLIC__ 字符串，只需要在模板中添加--PUBLIC--，其他替換字符串的輸出方式類似。

上述就是小編為大家分享的display與show方法怎么在thinkphp3.x中使用了，如果剛好有類似的疑惑，不妨參照上述分析進行理解。如果想知道更多相關知識，歡迎關注億速云行業資訊頻道。