smarty变量调节器与函数

smarty自带了一些变量调节器与内置函数，都在libs/plugins目录下，变量调节器以modifier开头，函数以function开头，而且我们可以自定义变量调节器与函数，熟练运用之后会极大地提高我们的开发效率。

一、格式

自定义的时候必须严格按照smarty提供的书写格式：

1.自定义变量调节器:

文件名格式：modifier.方法名.php，如：modifier.fontcolor.php

方法格式：function smarty_modifier_方法名(参数，参数……){ 方法 },如：function smarty_modifier_fontcolor($str,$color='green'){}。

注意：文件名格式与方法格式的方法名一定要相同。

2.自定义函数：

文件名格式：function.方法名.php，如：function.fontcolor.php

方法格式：function smarty_function_方法名(参数，参数……){ 方法 },如：function smarty_function_fontcolor($args,$smarty){}。

注意：文件名格式与方法格式的方法名一定要相同。

二、应用示例

变量调节器在使用时用"|"分隔，变量在前，变量调节器在后面，参数用":"调用

1.capitalize： 使变量内容里的每个单词的第一个字母大写，两个布尔型参数，默认均为false，第一个为true，则将带数字的单词首字母大写，第二个为true，则将单词内其他字母变为小写

<?php
$smarty->assign("articleTitle","next x-men film x3 deLayed");
?>

模板：

<{$articleTitle}><br />
<{$articleTitle|capitalize}><br />
<{$articleTitle|capitalize:true}><br />
<{$articleTitle|capitalize:true:true}><br />

输出：

next x-men film x3 deLayed
Next X-Men Film x3 DeLayed
Next X-Men Film X3 DeLayed
Next X-Men Film X3 Delayed

2.lower：将变量值转成小写字母；upper： 将变量值转成大写字母。

<?php
$smarty->assign('articleTitle', "If Strike isn't Settled Quickly it may Last a While.");
?>

模板：

<{$articleTitle}><br />
<{$articleTitle|upper}><br />
<{$articleTitle|lower}>

输出：

If Strike isn't Settled Quickly it may Last a While.
IF STRIKE ISN'T SETTLED QUICKLY IT MAY LAST A WHILE.
if strike isn't settled quickly it may last a while.

3.truncate： 截取字符串到指定长度，默认长度是80. 第二个参数可选，指定了截取后代替显示的字符。 截取后的字符长度是截取规定的长度加上第二个参数的字符长度。 默认truncate会尝试按单词进行截取。如果你希望按字符截取（单词可能会被截断），需要设置第三个参数TRUE。

<?php
$smarty->assign('articleTitle', 'Two Sisters Reunite after Eighteen Years at Checkout Counter.');
?>

模板：

<{$articleTitle}><br />
<{$articleTitle|truncate}><br />
<{$articleTitle|truncate:30}><br />
<{$articleTitle|truncate:30:""}><br />
<{$articleTitle|truncate:30:"---"}><br />
<{$articleTitle|truncate:30:"":true}><br />
<{$articleTitle|truncate:30:"...":true}><br />
<{$articleTitle|truncate:30:'..':true:true}>

输出：

Two Sisters Reunite after Eighteen Years at Checkout Counter.
Two Sisters Reunite after Eighteen Years at Checkout Counter.
Two Sisters Reunite after...
Two Sisters Reunite after
Two Sisters Reunite after---
Two Sisters Reunite after Eigh
Two Sisters Reunite after E...
Two Sisters Re..ckout Counter.

4.复合变量调节器：

你可以联合使用多个修饰器。 它们会按复合的顺序来作用于变量，从左到右。 它们必须以| (竖线)进行分隔。

<?php

$smarty->assign('articleTitle', 'Smokers are Productive, but Death Cuts Efficiency.');

?>

模板：

<{$articleTitle}><br />
<{$articleTitle|upper|fontcolor|truncate}><br />

输出：

Smokers are Productive, but Death Cuts Efficiency.
SMOKERS ARE PRODUCTIVE, BUT DEATH CUTS...