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

這期內(nèi)容當(dāng)中小編將會(huì)給大家?guī)碛嘘P(guān)display與show方法怎么在thinkphp3.x中使用，文章內(nèi)容豐富且以專業(yè)的角度為大家分析和敘述，閱讀完這篇文章希望大家可以有所收獲。

一、模板定義

為了對模板文件更加有效的管理，ThinkPHP對模板文件進(jìn)行目錄劃分，默認(rèn)的模板文件定義規(guī)則是：

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

模板目錄默認(rèn)是項(xiàng)目下面的Tpl， 當(dāng)定義分組的情況下，會(huì)按照分組名分開子目錄，新版模板主題默認(rèn)是空（表示不啟用模板主題功能），

模板主題功能是為了多模板切換而設(shè)計(jì)的，如果有多個(gè)模板主題的話，可以用DEFAULT_THEME參數(shù)設(shè)置默認(rèn)的模板主題名。

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

User模塊的add操作 對應(yīng)的模板文件就應(yīng)該是：

Tpl/User/add.html

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

'TMPL_TEMPLATE_SUFFIX'=>'.tpl'

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

Tpl/User/add.tpl

如果項(xiàng)目啟用了模塊分組功能（假設(shè)User模塊屬于Home分組），那么默認(rèn)對應(yīng)的模板文件可能變成 ：

Tpl/Home/User/add.html

分組模式下面，如果覺得目錄結(jié)構(gòu)太深，可以通過設(shè)置TMPL_FILE_DEPR參數(shù)來配置簡化模板的目錄層次，例如設(shè)置：

'TMPL_FILE_DEPR'=>'_'

默認(rèn)的模板文件就變成了：

Tpl/Home/User_add.html

正是因?yàn)橄到y(tǒng)有這樣一種模板文件自動(dòng)識(shí)別的規(guī)則，所以給我們的模板渲染輸出帶來了簡化。

二、模板渲染

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

最常用的是display方法，調(diào)用格式：

第一種：

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

第二種：

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

下面是一個(gè)最典型的用法，不帶任何參數(shù)：

$this->display();

表示系統(tǒng)會(huì)按照默認(rèn)規(guī)則自動(dòng)定位模板文件，所以通常display方法無需帶任何參數(shù)即可輸出對應(yīng)的模板，這是模板輸出的最簡單的用法。

如果沒有按照模板定義規(guī)則來定義模板文件，或者我需要調(diào)用其他模塊下面的某個(gè)模板，可以使用：

$this->display('edit');

表示調(diào)用當(dāng)前模塊下面的edit模板

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

表示調(diào)用Member模塊下面的read模板。

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

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

表示調(diào)用theme主題下面的User模塊的edit模板。

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

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

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

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

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

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

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

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

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

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

只要./Public/menu.tpl是一個(gè)實(shí)際存在的模板文件。

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

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

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

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

如果你沒有定義任何模板文件，或者把模板內(nèi)容存儲(chǔ)到數(shù)據(jù)庫中的話，你就需要使用show方法來渲染輸出了，show方法的調(diào)用格式：

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

例如，

$this->show($content);

也可以指定編碼和類型：

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

show方法中的內(nèi)容也可以支持模板解析。

三、模板賦值

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

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

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

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

{$name}

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

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

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

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

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

如果采用內(nèi)置的模板引擎，可以使用：

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

輸出同樣的內(nèi)容。

關(guān)于更多的模板標(biāo)簽使用，我們會(huì)在后面模板標(biāo)簽中詳細(xì)講解。

四、模板替換

在進(jìn)行模板輸出之前，系統(tǒng)還可以對渲染的模板結(jié)果進(jìn)行一些模板的特殊字符串替換操作，也就是實(shí)現(xiàn)了模板輸出的替換和過濾。這個(gè)機(jī)制可以使得模板文件的定義更加方便，默認(rèn)的替換規(guī)則有：

../Public： 會(huì)被替換成當(dāng)前項(xiàng)目的公共模板目錄 通常是 /項(xiàng)目目錄/Tpl/當(dāng)前主題/Public/

__TMPL__： 會(huì)替換成項(xiàng)目的模板目錄 通常是 /項(xiàng)目目錄/Tpl/當(dāng)前主題/

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

__PUBLIC__：會(huì)被替換成當(dāng)前網(wǎng)站的公共目錄 通常是 /Public/

__ROOT__： 會(huì)替換成當(dāng)前網(wǎng)站的地址（不含域名）

__APP__： 會(huì)替換成當(dāng)前項(xiàng)目的URL地址 （不含域名）

__GROUP__：會(huì)替換成當(dāng)前分組的URL地址 （不含域名）

__URL__： 會(huì)替換成當(dāng)前模塊的URL地址（不含域名）

__ACTION__：會(huì)替換成當(dāng)前操作的URL地址 （不含域名）

__SELF__： 會(huì)替換成當(dāng)前的頁面URL

注意這些特殊的字符串是嚴(yán)格區(qū)別大小寫的，并且這些特殊字符串的替換規(guī)則是可以更改或者增加的，我們只需要在項(xiàng)目配置文件中配置TMPL_PARSE_STRING就可以完成。如果有相同的數(shù)組索引，就會(huì)更改系統(tǒng)的默認(rèn)規(guī)則。例如：

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

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

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

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

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