smarty3:自定义变量调解器插件
如果有一些变量在模版中需要特殊处理,系统中默认的变量调节器又没有提供这样的功能,就可以自定义变量调节器。smarty提供了两种扩充插件的机制:
通过Smarty对象中的registerPlugin()方法,将PHP编写的函数,注册到Smarty对象中,并在模版中使用
像系统默认的变量调节器一样,在Smarty库文件所在目录下的Plugins目录中,创建一个特定的文件扩展插件。
registerPlugin()有三个参数:
使用字符串”modifier”指定插件的类型为修改器
插件的函数名称
定义的PHP回调函数
例如:在PHP脚本中声明一个函数为test(),将其注册为Smarty调解器”mystyle”,如下所示:
<?php
//加载smarty初始化文件
include "init.inc.php";
//向模版中分配一个字符串变量var
$smarty -> assign("var","这是一个字符串的数据,看看样式变量");
//使用registerPlugin()方法,将函数test()动态注册为模版中可以使用的修改器mystyle函数
$smarty->registerPlugin("modifier","mystyle","test");
//声明一个函数,为Smarty扩充修改器
function test ($var, $color, $size){
return '<font color="'.$color.'" size="'.$size.'">'.$var.'</font>';
}
$smarty->display("test.tpl");
/*模版中通过使用
{$var|mystyle:"red":7}{*自定义的变量调解器mysql,将变量$var的字体改为红色和7号字*}
*/
除了可以将自定义函数注册为变量调解器函数,也可以将PHP中的系统函数直接使用registerPlugin()方法注册为插件,不过要注意确保PHP系统该函数的第一个参数是要处理的变量。否则需要自定义一个函数调整参数位置。
<?php
//加载smarty初始化文件
include "init.inc.php";
//向模版中分配一个字符串变量var
$smarty -> assign("var","这是一个字符串的数据,看看样式变量");
//直接将PHP系统函数substr(),注册成变量调解器函数substr
$smarty->registerPlugin('modifier','substr','substr');
//因为PHP系统函数preg_match()函数的第一个参数不是要处理的变量,所以自定义demo()函数重新注册
function demo($var, $reg,$text){
return preg_match($reg,$text,$var);
}
$smarty->registerPlugin('modifier','regrep','demo');
$smarty->display('test.tpl');
由于使用registerPlugin()方法,函数在PHP程序中声明,但是不在PHP程序中使用,和PHP脚本的其他函数混杂在一起,会导致PHP程序逻辑混乱。可读性差,因此建议以特定的文件方式扩充插件。
需要遵循smarty定义的规则。包括插件声明位置、文件的命名,函数的命名,参数的规则等的约束。
插件声明位置
由于自带的默认插件都在smarty类库下的plugins目录下。所以最好用addPluginsDir()方法指明自定义插件的位置。
$smarty->addPluginsDir(ROOT."plugins");//自定义插件目录
文件命名方式
modifier.修改器名称.php //以modifier为前缀,中间使要声明的修改器名称,以php结束
函数命名规则
smarty_modifier_修改器名称() //函数名称要以smarty_modifier_为前缀,再加上修改器名称
参数说明
参数的第一个参数会自动传入要修改的变量。修改器中的其他参数从第二个参数开始。
修改上述的修改器:修改器文件命名为modifier.mystyle.php,放在由addPluginsDir()方法添加的插件目录下:
<?php
//自定义修改器mystyle,以后就可以直接在任意模版中使用了.例如:{$var|mystyle:"red":7}
function smarty_modifier_mystyle($var,$color,$size){
return '<font color="'.$color.'" size="'.$size.'">'.$var.'</font>';
}
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号