PHP 中使用 Smarty 之四：自定义变量调解器_PHP教程

在PHP 中，有很多处理文本的函数，您可以把要处理的文本通过函数处理之后，再调用Smarty 模板引擎中的assign() 赋值给变量，分配到模板中进行显示。

        Smarty 中的变量调解器和PHP 中处理文本的函数相似，不过语法不相同，在Smarty 中，是通过"|" 后面直接跟调解器函数名，如果有参数，得加在":" 后面，多个参数的话，累加即可。

        格式：{$var|modifier1:"参数1":"参数2":参数3|modifier2|modifier3|...}

        定义调解器的文件必须放置在Smarty 中，具体路径是：libs/plugins/。其文件名称，必须按照Smarty 的格式modifier.调解器名.php

        下面通过一个实例演示Smarty 中，自定义变量调解器的使用

        程序思路：做两个变量调解器，功能是：一个转换文本；一个截取文本。

init.inc.php(Smarty初始化文件)

    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(主文件)

    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

/libs/plugins/modifier.transform.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(截取文本调解器)

    /**

     * 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 内置的调解器，下节介绍