本文实例讲述了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 内置的调解器,后续章节会有详细介绍。
希望本文所述对大家基于smarty模板的PHP程序设计有所帮助。