PHP模板引擎Smarty自定义变量调解器用法

5年以前 | 阅读数：311 次 | 编程语言：PHP

本文实例讲述了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程序设计有所帮助。