這篇文章主要介紹了PHP模板引擎Smarty自訂變數調解器用法,較為詳細的分析了smarty變數調節器的用法與自訂變數調節器的實現技巧,需要的朋友可以參考下
在 PHP 中,有很多處理文本的函數,您可以把要處理的文本通過函數處理之後,再調用 Smarty 模板引擎中的 assign() 賦值給變數,分配到模板中進行顯示。
Smarty 中的變數調解器和 PHP 中處理文本的函數相似,不過文法不相同,在 Smarty 中,是通過 "|" 後面直接跟調解器函數名,如果有參數,得加在 ":" 後面,多個參數的話,累加即可。
格式:{$var|modifier1:"參數1":"參數2":參數3|modifier2|modifier3|...}
定義調解器的檔案必須放置在 Smarty 中,具體路徑是:libs/plugins/。其檔案名稱,必須按照 Smarty 的格式 modifier.調解器名.php
下面通過一個執行個體示範 Smarty 中,自訂變數調解器的使用
程式思路:做兩個變數調解器,功能是:一個轉換文本;一個截取文本。
init.inc.php(Smarty初始設定檔案)
<?php define('ROOT_PATH', dirname(__FILE__)); //設定網站根目錄 require ROOT_PATH.'/libs/Smarty.class.php'; //載入 Smarty 模板引擎 $_tpl = new Smarty(); //建立一個執行個體對象 $_tpl->template_dir = ROOT_PATH.'/tpl/'; //設定模板檔案目錄 $_tpl->compile_dir = ROOT_PATH.'./com/'; //設定編譯檔案目錄 $_tpl->left_delimiter = '<{'; //設定左定界符 $_tpl->right_delimiter = '}>'; //設定右定界符?>
index.php(主檔案)
<?php define('CONST_VAR', 'ABC'); require 'init.inc.php'; //引入模板初始設定檔案 global $_tpl; $_str = 'abcdEFGHigklmnOPQRSTuvwsYz'; //定義一個字串 $_tpl->assign('str',$_str); //字串賦值給str $_tpl->assign('str1',strtolower($_str)); //字串全部轉換為小寫賦給str1 $_tpl->assign('str2',strtoupper($_str)); //字串全部轉換為大寫賦給str2 $_tpl->assign('str3',ucfirst($_str)); //字串首字母轉換為大寫賦給str3 $_tpl->assign('str4',substr($_str, 0,15).'...'); //截取字串前15個字元,後面的用'...'代替,並賦給str4 $_tpl->assign('str5',strtoupper(substr($_str, 0,15)).'...'); //截取字串前15個字元轉換為大寫,後面的用'...'代替,並賦給str4 $_tpl->display('index.tpl'); //引入模板?>
tpl/index.tpl
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Smarty 中的變數調解器</title></head><body> <{$str}><br /> <!-- 輸出字串原形 --> <{$str1}><br /> <!-- 輸出字串轉換為小寫--> <{$str2}><br /> <!-- 輸出字串轉換為大寫 --> <{$str3}><br /> <!-- 輸出字串首字母大寫 --> <{$str4}><br /> <!-- 截取字串,截取15個字串,後面的用'...'代替 --> <{$str5}><br /> <!-- 截取字串,截取15個字串,轉換為大寫,後面的用'...'代替 --> <!-- 您會發現,使用賦值過來的變數,使用起來不是很靈活, 如果需要處理字串,就必須得在主檔案中設立一個新變數,並把值賦給這個新變數。 使用變數調解器,可靈活的處理字串 --> <{$str|transform}><br /> <!-- 輸出字串原形--> <{$str|transform:"lower"}><br /> <!-- 輸出字串轉換為小寫--> <{$str|transform:"upper"}><br /> <!-- 輸出字串轉換為大寫 --> <{$str|transform:"firstdx"}><br /> <!-- 輸出字串首字母大寫 --> <{$str|subString:0:15:"###"}><br /> <!-- 截取字串,截取15個字串,後面的用'###'代替 --> <{$str|subString:0:15:"@@@"|transform:"upper"}><br /> <!-- 截取字串,截取15個字串,後面的用'@@@'代替 --> <{$str|transform:"upper"|subString:0:15:"@@@"}><br /> <!-- 功能同上 --></body></html>
/libs/plugins/modifier.transform.php(轉換檔調解器)
<?php /** * smarty_modifier_transform * 字串轉換的變數調解器函數 * @param string $string 處理字串 * @param string $type 處理類型 */ function smarty_modifier_transform($string,$type) { switch ($type) { case 'upper' : $str = strtoupper($string); break; case 'lower' : $str = strtolower($string); break; case 'firstdx' : $str = ucfirst($string); break; default: $str = $string; } return $str; }?>
lib/plugins/modifier.subString.php(截取文本調解器)
<?php /** * smarty_modifier_subString * 處理截取字串調解器 * @param string $string 處理字串 * @param int $start_num 開始位置,預設從頭開始 * @param int $end_num 結束位置,預設20 * @param string $addTo 追加字串,預設'...' */ function smarty_modifier_subString($string,$start_num=0,$end_num=20,$addTo='...') { $_str = ''; if (strlen(substr($string, $start_num, $end_num))>=$end_num) { $_str = substr($string, $start_num, $end_num).$addTo; } else { $_str = substr($string, $start_num, $end_num); } return $_str; }?>
執行結果:
通過上面的執行個體,表明調解器檔案必須放在 Smarty 的外掛程式目錄 plugins 下,並且命名必須遵循 Smarty 的規則,這樣,才能調用到您編寫的調解器函數。還有一點需要說明,定義的函數名稱也必須符合 Smarty 內定的命名規則,例如:smarty_modifier_XXX,並且一個調解器檔案,只能放一個函數,不能放置多個。
總結:以上就是本篇文的全部內容,希望能對大家的學習有所協助。