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


  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值