欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2024-04-02 09:25:28
本文实例讲述了php模板引擎smarty自定义变量调解器用法。分享给大家供大家参考,具体如下: 在 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;
  }
?>

执行结果:

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

通过上面的实例,表明调解器文件必须放在 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程序设计有所帮助。