PHP模板引擎Smarty自訂變數調解器的用法及實例分析-php教程-PHP中文網

這篇文章主要介紹了PHP模板引擎Smarty自訂變數調解器用法,較為詳細的分析了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(&#39;ROOT_PATH&#39;, dirname(__FILE__)); //设置网站根目录
  require ROOT_PATH.&#39;/libs/Smarty.class.php&#39;; //加载 Smarty 模板引擎
  $_tpl = new Smarty(); //创建一个实例对象
  $_tpl->template_dir = ROOT_PATH.&#39;/tpl/&#39;; //设置模板文件目录
  $_tpl->compile_dir = ROOT_PATH.&#39;./com/&#39;; //设置编译文件目录
  $_tpl->left_delimiter = &#39;<{&#39;; //设置左定界符
  $_tpl->right_delimiter = &#39;}>&#39;; //设置右定界符
?>

登入後複製

index.php(主檔案)

<?php
  define(&#39;CONST_VAR&#39;, &#39;ABC&#39;);
  require &#39;init.inc.php&#39;; //引入模板初始化文件
  global $_tpl;
  $_str = &#39;abcdEFGHigklmnOPQRSTuvwsYz&#39;; //定义一个字符串
  $_tpl->assign(&#39;str&#39;,$_str); //字符串赋值给str
  $_tpl->assign(&#39;str1&#39;,strtolower($_str)); //字符串全部转换为小写赋给str1
  $_tpl->assign(&#39;str2&#39;,strtoupper($_str)); //字符串全部转换为大写赋给str2
  $_tpl->assign(&#39;str3&#39;,ucfirst($_str)); //字符串首字母转换为大写赋给str3
  $_tpl->assign(&#39;str4&#39;,substr($_str, 0,15).&#39;...&#39;); //截取字符串前15个字符，后面的用&#39;...&#39;代替，并赋给str4
  $_tpl->assign(&#39;str5&#39;,strtoupper(substr($_str, 0,15)).&#39;...&#39;); //截取字符串前15个字符转换为大写，后面的用&#39;...&#39;代替，并赋给str4
  $_tpl->display(&#39;index.tpl&#39;); //引入模板
?>

登入後複製

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个字符串，后面的用&#39;...&#39;代替 -->
  <{$str5}><br />  <!-- 截取字符串，截取15个字符串，转换为大写，后面的用&#39;...&#39;代替 -->
  <!--
    您会发现，使用赋值过来的变量，使用起来不是很灵活，
    如果需要处理字符串，就必须得在主文件中设立一个新变量，并把值赋给这个新变量。
    使用变量调解器，可灵活的处理字符串
   -->
  <{$str|transform}><br />      <!-- 输出字符串原形-->
  <{$str|transform:"lower"}><br />  <!-- 输出字符串转换为小写-->
  <{$str|transform:"upper"}><br />  <!-- 输出字符串转换为大写 -->
  <{$str|transform:"firstdx"}><br /> <!-- 输出字符串首字母大写 -->
  <{$str|subString:0:15:"###"}><br /> <!-- 截取字符串，截取15个字符串，后面的用&#39;###&#39;代替 -->
  <{$str|subString:0:15:"@@@"|transform:"upper"}><br />  <!-- 截取字符串，截取15个字符串，后面的用&#39;@@@&#39;代替 -->
  <{$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 &#39;upper&#39; :
        $str = strtoupper($string);
        break;
      case &#39;lower&#39; :
        $str = strtolower($string);
        break;
      case &#39;firstdx&#39; :
        $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   追加字符串，默认&#39;...&#39;
   */
  function smarty_modifier_subString($string,$start_num=0,$end_num=20,$addTo=&#39;...&#39;) {
    $_str = &#39;&#39;;
    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，並且一個調解器文件，只能放一個函數，不能放置多個。

總結：以上就是這篇文章的全部內容，希望能對大家的學習有所幫助。