本文實例講解 ThinkPHP 模板未經解析、直接原樣輸出的問題及其解決方法,分享給大家參考。
近來在學習 ThinkPHP 模板,卻發現模板頁原樣輸出了,經過一番搜索終於找到解決方案。
很多人都碰到過相同問題:在變數中賦值的字串若含有 __ROOT__、__PUBLIC__、__APP__ 這類字元,在模板中 display 出來時都會被替換成真實路徑。這個問題是在開發 Timi 檔案管理系統時發現的。
從檔案中把原始碼讀出來輸出到頁面後發現,只要是 TP 的路徑字元,都被替換成了真實路徑。例如:
$this->assign('fileContent', $fileContent); //$fileContent 中包含 __PUBLIC__ 這種「路徑常量」字元。
頁面輸出後顯示為真實路徑 /public/。期間經過多種嘗試,例如在 assign 時做 base64 加密、模板輸出時再 decode,都沒起作用。最後忍不住看了 TP 這塊的原始碼,發現是在 display 方法的最後一步透過呼叫 tag 方法把「TP 的路徑常量」替換成真實路徑的,而在 render 方法之前都還正常。

原本打算改原始碼來滿足「原樣輸出」的需求,但看完這塊原始碼後才發現改動太大,並不容易。最後另一位網友的回覆點出了最終方案:
「可以參考模板替換的相關內容。有了模板替換規則後,頁面上所有的 __PUBLIC__ 字串都會被替換,那如果確實需要輸出 __PUBLIC__ 字串到模板呢?我們可以透過增加替換規則的方式,例如:
'TMPL_PARSE_STRING' => array(
'--PUBLIC--' => '__PUBLIC__', // 採用新規則輸出 /Public 字串
)
這樣增加替換規則後,如果我們要輸出 __PUBLIC__ 字串,只需要在模板中加入 --PUBLIC--,其他替換字串的輸出方式類似。」
於是方案出爐:在 TP 的設定檔 config.php 中設定:
'TMPL_PARSE_STRING' => array (// 路徑設定
// Timi 檔案路徑還原
'--PUBLIC--' => '__PUBLIC__',
'--APP--' => '__APP__',
'--URL--' => '__URL__',
'--ACTION--' => '__ACTION__',
'--SELF--' => '__SELF__',
'--INFO--' => '__INFO__',
'--EXT--' => '__EXT__'
),
讀出原始碼時再用正則替換一下,把「路徑常量字元」__ROOT__ 換成 --ROOT--:
$fileContent = file_get_contents($filePath);
$fileContent = htmlspecialchars(preg_replace('/__(.*?)__/is', '--$1--', $fileContent));
然後 TMPL_PARSE_STRING 的設定會在模板被解析時剛好替換回去,如下圖所示:

於是這個問題就「暫時」完美解決了。核心思路是:先把要原樣輸出的路徑常量加上自訂的佔位格式(如 --PUBLIC--),避開 TP 的自動替換,再透過自訂的 TMPL_PARSE_STRING 規則把它還原回 __PUBLIC__。希望本文對大家的 ThinkPHP 框架程式設計有所幫助。