快捷導(dǎo)航

PHP模板引擎Smarty自定義變量調(diào)解器用法

更新時(shí)間：2016年04月11日 10:46:45 作者：ruxingli

這篇文章主要介紹了PHP模板引擎Smarty自定義變量調(diào)解器用法,較為詳細(xì)的分析了smarty變量調(diào)節(jié)器的用法與自定義變量調(diào)節(jié)器的實(shí)現(xiàn)技巧,需要的朋友可以參考下

本文實(shí)例講述了PHP模板引擎Smarty自定義變量調(diào)解器用法。分享給大家供大家參考，具體如下：

在 PHP 中，有很多處理文本的函數(shù)，您可以把要處理的文本通過函數(shù)處理之后，再調(diào)用 Smarty 模板引擎中的 assign() 賦值給變量，分配到模板中進(jìn)行顯示。

Smarty 中的變量調(diào)解器和 PHP 中處理文本的函數(shù)相似，不過語法不相同，在 Smarty 中，是通過 "|" 后面直接跟調(diào)解器函數(shù)名，如果有參數(shù)，得加在 ":" 后面，多個參數(shù)的話，累加即可。

格式：{$var|modifier1:"參數(shù)1":"參數(shù)2":參數(shù)3|modifier2|modifier3|...}

定義調(diào)解器的文件必須放置在 Smarty 中，具體路徑是：libs/plugins/。其文件名稱，必須按照 Smarty 的格式 modifier.調(diào)解器名.php

下面通過一個實(shí)例演示 Smarty 中，自定義變量調(diào)解器的使用

程序思路：做兩個變量調(diào)解器，功能是：一個轉(zhuǎn)換文本；一個截取文本。

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

<?php
  define('ROOT_PATH', dirname(__FILE__)); //設(shè)置網(wǎng)站根目錄
  require ROOT_PATH.'/libs/Smarty.class.php'; //加載 Smarty 模板引擎
  $_tpl = new Smarty(); //創(chuàng)建一個實(shí)例對象
  $_tpl->template_dir = ROOT_PATH.'/tpl/'; //設(shè)置模板文件目錄
  $_tpl->compile_dir = ROOT_PATH.'./com/'; //設(shè)置編譯文件目錄
  $_tpl->left_delimiter = '<{'; //設(shè)置左定界符
  $_tpl->right_delimiter = '}>'; //設(shè)置右定界符
?>

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)); //字符串全部轉(zhuǎn)換為小寫賦給str1
  $_tpl->assign('str2',strtoupper($_str)); //字符串全部轉(zhuǎn)換為大寫賦給str2
  $_tpl->assign('str3',ucfirst($_str)); //字符串首字母轉(zhuǎn)換為大寫賦給str3
  $_tpl->assign('str4',substr($_str, 0,15).'...'); //截取字符串前15個字符，后面的用'...'代替，并賦給str4
  $_tpl->assign('str5',strtoupper(substr($_str, 0,15)).'...'); //截取字符串前15個字符轉(zhuǎn)換為大寫，后面的用'...'代替，并賦給str4
  $_tpl->display('index.tpl'); //引入模板
?>

tpl/index.tpl

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Smarty 中的變量調(diào)解器</title>
</head>
<body>
  <{$str}><br />   <!-- 輸出字符串原形 -->
  <{$str1}><br />  <!-- 輸出字符串轉(zhuǎn)換為小寫-->
  <{$str2}><br />  <!-- 輸出字符串轉(zhuǎn)換為大寫 -->
  <{$str3}><br />  <!-- 輸出字符串首字母大寫 -->
  <{$str4}><br />  <!-- 截取字符串，截取15個字符串，后面的用'...'代替 -->
  <{$str5}><br />  <!-- 截取字符串，截取15個字符串，轉(zhuǎn)換為大寫，后面的用'...'代替 -->
  <!--
    您會發(fā)現(xiàn)，使用賦值過來的變量，使用起來不是很靈活，
    如果需要處理字符串，就必須得在主文件中設(shè)立一個新變量，并把值賦給這個新變量。
    使用變量調(diào)解器，可靈活的處理字符串
   -->
  <{$str|transform}><br />      <!-- 輸出字符串原形-->
  <{$str|transform:"lower"}><br />  <!-- 輸出字符串轉(zhuǎn)換為小寫-->
  <{$str|transform:"upper"}><br />  <!-- 輸出字符串轉(zhuǎn)換為大寫 -->
  <{$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(轉(zhuǎn)換文件調(diào)解器)

<?php
  /**
   * smarty_modifier_transform
   * 字符串轉(zhuǎn)換的變量調(diào)解器函數(shù)
   * @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(截取文本調(diào)解器)

<?php
  /**
   * smarty_modifier_subString
   * 處理截取字符串調(diào)解器
   * @param string $string  處理字符串
   * @param int $start_num  開始位置，默認(rèn)從頭開始
   * @param int $end_num   結(jié)束位置，默認(rèn)20
   * @param string $addTo   追加字符串，默認(rèn)'...'
   */
  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;
  }
?>

執(zhí)行結(jié)果：

通過上面的實(shí)例，表明調(diào)解器文件必須放在 Smarty 的插件目錄 plugins 下，并且命名必須遵循 Smarty 的規(guī)則，這樣，才能調(diào)用到您編寫的調(diào)解器函數(shù)。還有一點(diǎn)需要說明，定義的函數(shù)名稱也必須符合 Smarty 內(nèi)定的命名規(guī)則，例如：smarty_modifier_XXX，并且一個調(diào)解器文件，只能放一個函數(shù)，不能放置多個。

好了，自定義調(diào)解器先介紹到這里， Smarty 中有很多已經(jīng)寫的調(diào)解器函數(shù)，可以拿來直接調(diào)用或修改成您自己喜歡的風(fēng)格。關(guān)于 Smary 內(nèi)置的調(diào)解器，后續(xù)章節(jié)會有詳細(xì)介紹。