本文實例講述了PHP模板引擎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，並且一個調解器文件，只能放一個函數，不能放置多個。
好了，自定義調解器先介紹到這裡， Smarty 中有很多已經寫的調解器函數，可以拿來直接調用或修改成您自己喜歡的風格。關於 Smary 內置的調解器，後續章節會有詳細介紹。
更多關於PHP相關內容感興趣的讀者可查看本站專題：《smarty模板入門基礎教程》、《PHP模板技術總結》、《PHP基於pdo操作數據庫技巧總結》、《PHP運算與運算符用法總結》、《PHP網絡編程技巧總結》、《PHP基本語法入門教程》、《php面向對象程序設計入門教程》、《php字符串(string)用法總結》、《php+mysql數據庫操作入門教程》及《php常見數據庫操作技巧匯總》
希望本文所述對大家基於smarty模板的PHP程序設計有所幫助。
