Smarty 模板引擎简介

时间  2019-11-11
标签 smarty 模板 引擎 简介 繁體版
原文   原文链接

前言

Smarty是一个使用PHP写出来的模板引擎，是目前业界最著名的PHP模板引擎之一。它分离了逻辑代码和外在的内容，提供了一种易于管理和使用的方法，用来将本来与HTML代码混杂在一块儿PHP代码逻辑分离。简单的讲，目的就是要使PHP程序员同前端人员分离，使程序员改变程序的逻辑内容不会影响到前端人员的页面设计，前端人员从新修改页面不会影响到程序的程序逻辑，这在多人合做的项目中显的尤其重要。做为一个前端工程师了解Smarty也颇有必要，本文是从官方文档上概括出来的简明教程，以备快速查阅。javascript

1.基本语法

全部的smarty模板标签都被加上了定界符。默认状况下是 { 和}，但它们是可被改变的，能够进行自定义设置。php

Comments[注释]

示例：css

{* Smarty *}

Functions[函数]

每个smarty标签输出一个变量或者调用某种函数。在定界符内 函数（用'{'包住）和其属性（用界符包住）将被处理和输出。html

示例：前端

{config_load file="colors.conf"}

{include file="header.tpl"}

{if $highlight_name}
    Welcome, <font color="{#fontColor#}">{$name}!</font>    
{else}
    Welcome, {$name}!
{/if}

{include file="footer.tpl"}

Attributes[属性]

大多数函数都带有本身的属性以便于明确说明或者修改他们的行为。smarty函数的属性很像HTML中的属性。静态数值不须要加引号，可是字符串建议使用引号。 若是用变量做属性,它们也不能加引号。java

示例：ios

{include file="header.tpl"}

{include file=$includeFile}

{include file=#includeFile#}

{html_select_date display_days=yes}

<SELECT name=company>
{html_options values=$vals selected=$selected output=$output}
</SELECT>

Embedding Vars in Double Quotes[双引号里值的嵌入]

Smarty能够识别嵌入在双引号中的变量，只要此变量只包含数字、字母、下划线和中括号[]。对于其余的符号（句号、对象相关的，等等）此变量必须用两个'`'(此符号和‘ ~ '在同一个键上，通常在ESC键下面一个键上)包住。程序员

SYNTAX EXAMPLES:
{func var="test $foo test"} <-- sees $foo
{func var="test $foo_bar test"} <-- sees $foo_bar
{func var="test `$foo.bar` test"} <-- sees $foo.bar

PRACTICAL EXAMPLES:
{include file="subdir/$tpl_name.tpl"} <-- will replace $tpl_name with value
{cycle values="one,two,`$smarty.config.myval`"} <-- must have backticks

Math[数学运算]

数学运算能够直接应用到变量。web

{$foo+1}

{$foo*$bar}
     
{$foo->bar-$bar[1]*$baz->foo->bar()-3*7}

{$foo|truncate:"`$fooTruncCount/$barTruncFactor-1`"}

{assign var="foo" value="`$foo+$bar`"}

Escaping Smarty Parsing[忽略Smarty解析]

在Smarty模版，若是‘｛’和‘｝’大括号里包含有空格那么整个{}内容会被忽略，你能够设置Smarty类变量$auto_literal=false来取消这种规则。正则表达式

{literal}...{/literal}块被用来忽略模版语法的解析，你也能够用{ldelim}、{rdelim}标签或{$smarty.ldelim}、{$smarty.rdelim}变量来忽略个别大括号（译注：后面两种方法主要用来在模版中输出左右大括号）。
Smarty默认定界符‘｛’和‘｝’简洁地描述具体的内容，然而若是你有更好的定界符设置，也能够用Smarty的$left_delimiter和$right_delimiter设置相应的值。

2.Variables [变量]

从PHP分配的变量

调用从PHP分配的变量需在前加"$"符号，调用模板内的assign函数分配的变量也是这样。

Associative arrays[关联数组]

要想引用关联数组变量，能够用'.'取得对应key的value。

{$Smarty.example}

Array indexes[数组下标]

能够经过变量的下标取得对应的位置的元素。

{$Smarty[index]}

Objects[对象]

对象的属性能够经过“->”符号引用。

{$Smarty->key}

Variable scopes [变量范围]

你能够选择为主要的Smarty对象做用域分配变量，createData()用来创建数据对象，createTemplate()用来创建模板对象。这些对象支持链式，在模板中能够查看全部模板自己的对象变量和全部分配给父对象链的变量。默认状况下，模板在执行$smarty->displaty(...)、$smarty->fetch(...)方法时已自动连接至Smarty对象变量范围。对于分配到单个数据或模板对象的变量，您能够彻底控制哪些变量在模板中可见。

// 为Smarty对象域分配变量
$smarty->assign('foo','smarty');

// 为数据对象域分配变量
$data = $smarty->createData();
$data->assign('foo','data');
$data->assign('bar','bar-data');

// 为其它数据对象域分配变量
$data2 = $smarty->createData($data);
$data2->assign('bar','bar-data2');

// 为模版对象域分配变量
$tpl = $smarty->createTemplate('index.tpl');
$tpl->assign('bar','bar-template');

从配置文件读取的变量

配置文件中的变量须要经过用两个"#"或者是smarty的保留变量"$smarty.config."来调用。配置文件的变量只有在它们被加载之后才能使用。

示例：

foo.conf:

pageTitle = "This is mine"
bodyBgColor = "#eeeeee"
tableBorderSize = "3"
tableBgColor = "#bbbbbb"
rowBgColor = "#cccccc"

index.tpl:

{config_load file="foo.conf"}
<html>
    <title>{#pageTitle#}</title>
    <body bgcolor="{#bodyBgColor#}">
        <table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}">
            <tr bgcolor="{#rowBgColor#}">
                <td>First</td>
                <td>Last</td>
                <td>Address</td>
            </tr>
        </table>
    </body>
</html>

{$smarty}保留变量

  • Request variables[页面请求变量，如get,post,server,session等]
  • {$smarty.now}[当前timestamp]
  • {$smarty.const}[直接访问PHP常量值]
  • {$smarty.capture}[capture函数的做用是捕获模板输出的数据并将其存储到一个变量里，而不是把它们输出到页面。]
  • {$smarty.config}[访问config文件的变量]
  • {$smarty.section}
  • {$smarty.foreach}
  • {$smarty.template}[包含正在处理的模板的名称]
  • {$smarty.current_dir}
  • {$smarty.version}
  • {$smarty.block.child}
  • {$smarty.block.parent}
  • {$smarty.ldelim}, {$smarty.rdelim}

3.Variable Modifiers [变量调节器]

变量调节器用于变量，自定义函数和字符串。 请使用‘|’符号和调节器名称应用调节器。 变量调节器由赋予的参数值决定其行为。 参数由‘：’符号分开。

示例：

{* Uppercase the title *}

<h2>{$title|upper}</h2>

{* Truncate the topic to 40 characters use ... at the end *}
Topic: {$topic|truncate:40:"..."}

{* format a literal string *}
{"now"|date_format:"%Y/%m/%d"}

{* apply modifier to a custom function *}
{mailto|upper address="me@domain.dom"}

调节器列表

  • capitalize[首字母大写]
  • count_characters[计算变量里的字符数，默认false，不计算空格，true计算空格]
  • cat[将cat里的值(string)链接到给定的变量后面]
  • count_paragraphs[计算变量里的段落数量]
  • count_sentences[计算变量里句子的数量]
  • count_words[计算变量里的词数]
  • date_format[格式化从函数strftime()得到的时间和日期]
  • default[为空变量设置一个默认值，变量为空或者未分配的时,将由给定的默认值替代输出]
  • escape[将变量按照指定转码方式编码，默认html，可选参数：html,htmlall,url,quotes,hex,hexentity,javascript]
  • indent[设置缩进字符，默认是4个字符。第二个可选参数，可指定缩进用什么字符代替。]
  • lower[将变量字符串小写]
  • nl2br[换行符替换成<br />]
  • regex_replace[寻找和替换正则表达式 ]
  • replace[简单的搜索和替换字符串，第一个参数是被替换字符，第二个是替换字符]
  • spacify[插空是一种在字符串的每一个字符之间插入空格或者其余的字符(串)]
  • string_format[一种格式化字符串的方法，使用sprintf语法格式化]
  • strip[用一个空格或一个给定字符替换全部重复空格，换行和制表符]
  • strip_tags[去除<和>标签，包括在<和>之间的任何内容]
  • truncate[从字符串开始处截取某长度的字符，默认是80个。参数:截取个数:追加字符:是否精确]
  • upper[将变量改成大写]
  • wordwrap[指定段落的宽度，默认为80。参数:字符个数:约束点字符:是否精确]

4.Combining Modifiers[组合修改器]

对于同一个变量，你可使用多个修改器。它们将从左到右按照设定好的顺序被依次组合使用。使用时必需要用"|"字符做为它们之间的分隔符。

示例：

{$Smarty|lower|spacify|truncate:30:". . ."}

5.Built-in Functions[内建函数]

{$var=}

这是{assign}函数的简写版，你能够直接赋值给模版，也能够为数组元素赋值。

{append}

{append}用于在模板执行期间创建或追加模板变量数组。

属性：

选项标签：

示例：

{append var='name' value='Bob' index='first'}
{append var='name' value='Meyer' index='last'}
// or 或者
{append 'name' 'Bob' index='first'} {* short-hand *} ｛* 简写 *｝
{append 'name' 'Meyer' index='last'} {* short-hand *}

{assign}

{assign}用来在模板运行时为模板变量赋值。

属性：

选项标签：

{assign var="name" value="Bob" nocache}
{assign "name" "Bob" nocache} {* short-hand *}

{block}

{block}用来定义一个命名的模板继承源区域。{block}的一个子模板源区将取代父模板中的相应区域。任意的子、父模板{block}区域能够彼此结合。能够利用子{block}定义中的append、prepend选项标记追加或预置父{block}内容。使用{$smarty.block.parent}可将父模板的{block}内容插入至子{block}内容中的任何位置。使用{$smarty.block.child}可将子模板{block}内容插入至父{block}内容中的任何位置。{block}能够嵌套。

属性：

选项标签：

示例：

parent.tpl
<html>
  <head>
    <title>{block name="title"}Title - {/block}</title>
  </head>
</html>
  
child.tpl
{extends file="parent.tpl"} 
{block name="title" prepend}
Page Title
{/block}
  
The result would look like
<html>
  <head>
    <title>Title - Page Title</title>
  </head>
</html>

{call}

{call}用来调用{function}标签订义的模板函数，相似于插件函数。

另外你能够在模板中直接使用{funcname...}函数。

  • {call}标签的属性名须包含模板函数的名称；
  • 变量值能够经过模板函数做为属性传递。

属性：

选项标签：

示例：

{* define the function *} {* 定义函数 *} 
{function name=menu level=0}
<ul class="level{$level}">
{foreach $data as $entry}
{if is_array($entry)}
<li>{$entry@key}</li>
{call name=menu data=$entry level=$level+1}
{else}
<li>{$entry}</li>
{/if}
{/foreach}
</ul>
{/function}

{* create an array to demonstrate *}{*建立一个演示数组*｝
{$menu = ['item1','item2','item3' => ['item3-1','item3-2','item3-3' =>['item3-3-1','item3-3-2']],'item4']}
{* run the array through the function *}
{call name=menu data=$menu}
{call menu data=$menu} {* short-hand *}

{capture}

{capture}用来捕获模板输出的数据并将其存储到一个变量里，而不是将它们输出到页面。任何在{capture name="foo"}和{/capture}之间的数据将被存储到变量$foo中，该变量由name属性指定。

属性：

选项标签：

注：当捕获{insert}输出时要很是当心！若是你开启了$caching缓存，但愿在缓存内容里运行{insert}命令。那么，请不要捕获{insert}里面的内容！由于{insert}内容老是不被缓存。

示例：

{* 咱们不想输出一个div标签，除非包含的内容是没法显示的 *}
{capture name="banner"}
{capture "banner"} {* short-hand *}
  {include file="get_banner.tpl"}
{/capture}
{if $smarty.capture.banner ne ""}
<div id="banner">{$smarty.capture.banner}</div>
{/if}

{config_load}

属性：

{debug}

{debug}跳转到调试控制页面。无论php脚本中如何设置debug，它都会工做，由于它在运行时就执行，它只可以显示分配的变量值；而不是（显示）正在使用的模版。然而，你能够看到变量做用域内的全部变量值。
若是cacheing设置为true，页面从缓存{debug}中加载，那么你只能看到缓存过的变量。

{extends}

{extends}标签用在模板继承中子模版对父模板的继承。

  • {extends}标签用在模版中的第一行；
  • 若是子模板用{extends}标签继承父模板，那么它只能包含{block}标签（内容），其它任何模板内容都将忽略；
  • 使用此语法为模板资源继承$template_dir目录外的文件。

示例：

{extends file='parent.tpl'}
{extends 'parent.tpl'}  {* short-hand *}

{for}

{for}、{forelse}标签用来建立一个简单循环，支持如下不一样的格式：

  • {for $var=$start to $end}步长为1的简单循环；
  • {for $var=$start to $end step $step}其它步长循环。

当循环无迭代时执行{forelse}。

示例：

<?php
$smarty->assign('to',10);
?>

<ul>
{for $foo=3 to $to max=3}
    <li>{$foo}</li>
{/for}
</ul>
  
The above example will output:
<ul>
    <li>3</li>
    <li>4</li>
    <li>5</li>
</ul>

{foreach},{foreachelse}

{foreach}用来遍历数据数组，{foreach}与{section}循环相比更简单、语法更干净，也能够用来遍历关联数组。
{foreach $arrayvar as $itemvar}
{foreach $arrayvar as $keyvar=>$itemvar}

  • {foreach}循环能够嵌套；
  • 数组变量一般是（另）一个数组的值，用来指导循环的次数，你能够为循环传递一个整数；
  • 当数组变量无值时执行{foreachelse}；
  • {foreach}的属性是@index(包含当前数组的下标，开始时为0)、@iteration(包含当前循环的迭代，老是以1开始，这点与index不一样。每迭代一次值自动加1。"is div by"操做符可能用来侦察特殊迭代，"is even by"和"is odd by"操做符能够用来在每多少迭代时交替什么什么...。)、@first(当{foreach}循环第一个时first为真)、@last(当{foreach}迭代到最后时last为真)、@show(用在检测{foreach}循环是否无数据显示，show是个布尔值（true or false）)、@total(total包含{foreach}循环的总数（整数），能够用在{forach}里面或后面)；
  • 能够用循环项目中的当前键（{$item@key}）代替键值变量。

示例：

<?php
$people = array('fname' => 'John', 'lname' => 'Doe', 'email' => 'j.doe@example.com');
$smarty->assign('myPeople', $people);
?>

Template to output $myArray as key/value pairs. //键值对 
<ul>
{foreach $myPeople as $value}
<li>{$value@key}: {$value}</li>
{/foreach}
</ul>

示例：

{foreach $myNames as $name}
{if $name@iteration is div by 4}
<b>{$name}</b>
{/if}
{$name}
{/foreach}

{function}

{function}用来在模板中建立函数，能够像调用插件函数同样调用它们。取代在插件中写表象内容的函数，让模板保持一致性一般是个更好的选择。它也简化了对数据的遍历，例如深度的嵌套菜单。另外你能够在模板中直接使用{funcname...}函数。

  • {function}标签必须包含模板函数名的name属性，该name标签名必须可以调用模板函数；
  • 默认变量值应能做为属性传递到模板函数，当模板函数被调用的时候，默认值应能被复写；
  • 在模板函数内部应能使用被调用模板的全部变量值，在模板函数中更改或新建变量的值必须具局部做用域，并且在执行模板函数后这些变量值在被调用模板内部应不可见。 

示例：

{* define the function *}
{function name=menu level=0}
{function menu level=0} {* short-hand *}
<ul class="level{$level}">
{foreach $data as $entry}
{if is_array($entry)}
<li>{$entry@key}</li>
{menu data=$entry level=$level+1}
{else}
<li>{$entry}</li>
{/if}
{/foreach}
</ul>
{/function}

{if},{elseif},{else}

随着一些特性加入到模版引擎，Smarty的{if}语句与php的if语句同样富有弹性。每个{if}必须与一个{/if}成对出现，容许使用{else}和{elseif}，全部php条件和函数在这里一样适用，诸如||、or、&&、and、is_array()等等。若是开启安全，只支持符合$php_functions的安全策略属性的php函数。

下面是一串有效的限定符，它们的左右必须用空格分隔开，注意列出的清单中方括号是可选的，在适用状况下使用相应的等号（全等或不全等）。

示例：

{if isset($name) && $name == 'Blog'}
     {* do something *}
{elseif $name == $foo}
    {* do something *}
{/if}
{if is_array($foo) && count($foo) > 0}
    {* do a foreach loop *}
{/if}

{include}

{include}标签用于在当前模板中包含其它模板。当前模板中的任何有效变量在被包含模板中一样可用。

  • 必须指定file属性，该属性指明模板资源的位置。
  • 设置assign属性选项能够指定{include}的输出贮存分配给哪一个模板变量，而不显示内容，相似于{assign}。
  • 变量能够做为属性参数传递给被包含模板，任何明确传递给被包含模板的变量只在被包含文件的做用域中有效。若是传递的属性变量在当前模板中有同名变量，那么传递的属性变量将覆盖当前模板变量。
  • 被包含模板内部可使用主模板的全部变量，但在被包含模板里面改变或新建的变量只有本地做用域，使用{include}语句后这些变量在主模板内部将不可见；有两种方法能够改变这种默认行为（变量做用域）：在{include}语句中使用scope属性对被包含模板的全部赋值变量有效，或在{assign}语句中使用scope属性改变个别变量做用域。后一特性在从被包含模板返回值给主模板时很是有用。
  • 包含$template_dir文件夹以外的模板请使用模板资源语法。

属性：

选项标签：

{include 'links.tpl' title='Newest links' links=$link_array}
{* body of template goes here *}
{include 'footer.tpl' foo='bar'}
  
The template above includes the example links.tpl below
<div id="box">
<h3>{$title}{/h3>
<ul>
{foreach from=$links item=l}
.. do stuff填充  ...
</foreach}
</ul>
</div>

{include_php}

{include_php}在Smarty新版本中已被废弃，可以使用插件恰当地解决从（php）代码分离html的问题。

{insert}

{insert}标签相似于{include}标签，不一样之处是即便打开caching，{insert}所包含的内容也不会被缓存，每次调用模板都会执行{insert}。 

示例：

banner.conf:
alt = come from baidu!
src = xxx.com/2351.gif
href = www.xxx.com
main.tpl:
{config_load file='banner.conf'}
{insert name="getBanner" lid=#title#}
test.php:
include_once('../libs/Smarty.class.php');
$smarty = new Smarty;
function insert_getBanner($arr,$smarty){
echo '<div><a href="'.$arr['href'].'"><img src='.$arr['src'].' alt='.$arr['alt'].'</div>';
}
$smarty->display('main.tpl');

{ldelim},{rdelim}

{ldelim}和{rdelim}用来转义模版定界符，默认值为“{”和“}”。你也能够用{literal}{/literal}转义文本块，例如javascript或css。

{ldelim}、{rdelim}用来输出左右delim的原义，即输出$smarty.ldelim和$smarty.rdelim的字面值。当使用{literal}{/literal}成对使用时，Smarty将忽略解释里面的代码，而按原字符输出。

示例：

<script language="JavaScript" type="text/javascript">
function myJsFunction(){ldelim}
alert("The server name\n{$smarty.server.SERVER_NAME}\n{$smarty.server.SERV
{rdelim}
</script>
<a href="javascript:myJsFunction()">Click here for Server Info</a>

{literal}

{literal}标签区域内的数据将按字面意思处理，表明性地是用在javascript/css语块周围，否则这些语言使用的花括号‘{’、‘}’会干扰模版定界符语法。{literal}{/literal}标签里面的全部符号不会被解释，所有按原样输出。若是有须要在{literal}块里使用模版标签，能够考虑使用{ldelim}{rdelim}转义单独的分隔符。

{nocache}

{nocache}用来禁止模版块缓存，每一个{nocache}应与{/nocache}成对出现。当从缓存中加载页面时应肯定无缓存块使用的变量为php变量（而非模板中定义的变量）。

示例：

Today's date is
{nocache}
{$smarty.now|date_format}
{/nocache}

{php}

{php}已被Smarty弃用，不该再使用。仍是用你本身编写的php脚本或插件函数来代替它吧！

{section},{sectionelse}

不一样于{foreach}遍历单层关联数组，{section}支持循序索引遍历数组中的数据（支持一次性读取多维数组）。每一个{section}标签必须与闭合标签{/section}成对出现。

注：{foreach}能够作{section}能作的全部事，并且语法更简单、更容易。它一般是循环数组的首选。{section}循环不能遍历关联数组，（被循环的）数组必须是数字索引，像这样（0，1，2，...）。对于关联数组，请用{foreach}循环。

属性：

选项标签：

  • 必须设置name和loop属性;
  • {section}的名称能够是你喜欢的任何字母、下划线、数字组合，与php变量（命名）相同；
  • {section}能够嵌套，但必须确保嵌套的{section}名称惟一；
  • loop属性一般是一个数组值，它决定{section}循环的次数。你也能够为loop提供一个具体的整数值；
  • 当须要在{section}内输出一个变量时，{section}的变量名必须用方括号括起并挨在该输出变量名的右边（译注：如$abc[mysection]）；
  • 当循环变量无值时执行{sectionelse}；
  • {section}一样有本身的变量处理{section}属性，能够经过调用{$smarty.section.name.property}访问这些属性，这里‘name’是个变量名；
  • {section}的属性有index(向前1步，若是给出了step变量则以该步长向前)、index_prev(为前一循环的索引值。 循环开始时，此值为-1)、index_next(index_next为下个循环的索引值。循环到最尾，此值仍然比当前索引值大1，若是设定了step，取决于该值)、iteration(iteration包含当前的迭代循环，开始值为1)、first(若是当前循环第一次执行，first被设置为true)、last(若是当前section迭代执行到最尾，last 被设置为true)、rownum(rownum包含当前循环迭代。从1开始。该属性是iteration的别名，二者是同样的)、loop(loop包含{section}上次循环时的最后索引值， 该值能够用于循环内部或循环结束后)、show(show是section的参数，为布尔值，若是设置为 false，该循环将不显示。若是存在{sectionelse}子句，该字句将交替显示)、total(total包含{section}循环执行总的次数，能够在{section}执行中/后调用此属性)。

{while}

随着一些特性加入到模版引擎，Smarty的{while}循环与php的while语句同样富有弹性。每个{while}必须与一个{/while}成对出现，全部php条件和函数在它身上一样适用，诸如||、or、&&、and、is_array()等等。
下面是一串有效的限定符，它们的左右必须用空格分隔开，注意列出的清单中方括号是可选的，在适用状况下使用相应的等号（全等或不全等）。

示例：

{while $foo > 0}
  {$foo--}
{/while}

8.Custom Functions[自定义函数]

{counter}

用于输出一个记数过程。{counter}保存了每次记数时的当前记数值。用户能够经过调节间隔（skip）和方向（direction）计算该值。也能够决定是否输出该值。若是须要同时运行多个计数器，必须为它们指定不一样的名称。若是没有指定名称，模板引擎使用 "default" 做为缺省值。
若是指定了 "assign" 这个属性，该计数器的输出值将被赋给由assign指定的模板变量，而不是直接输出。

属性：

示例：

{* initialize the count *}
{counter start=0 skip=2}<br />
{counter}<br />
{counter}<br />
{counter}<br />

{cycle}

Cycle用于交替使用一组值。该特性使得在表格中交替输出多种颜色或循环使用数组中的值变得更容易。

属性：

  • {cycle}能够交替多个值，但每一个{cycle}的name属性必须惟一。
  • 用户能够设置print属性为false强制不输出当前值，该特性能够很方便地略过某个值。
  • advance 属性用于重复使用某个值，当该属性设置为false时，下次调用{cycle}时将输出一样的值。
  • 若是指定了assign属性，{cycle}函数的输出内容将被赋给由assign指定的模板变量，而不是直接输出。

示例：

{section name=rows loop=$data}
<tr class="{cycle values="odd,even"}">
   <td>{$data[rows]}</td>
</tr>
{/section}
  
The above template would output:
<tr class="odd">
   <td>1</td>
</tr>
<tr class="even">
   <td>2</td>
</tr>
<tr class="odd">
   <td>3</td>
</tr>

{eval}

将变量做为一个模板求值。该特性用于诸如将模板标签/变量嵌入至另外一变量，或将标签/变量嵌入至配置文件中的变量的情形。若是指定了assign这个属性，{eval}函数的输出内容将被赋给由assign指定的模板变量，而不是直接输出。

  • 待求值的变量被看成模板来处理。它们遵循模板的转义方式和安全特性。
  • 待求值的变量每次调用时被重编译，不保存编译版本! 但当开启缓存时，该输出会将与余下的模板一块儿缓存。

属性：

示例：

The contents of the config file, setup.conf. 配置文件
emphstart = <strong>
emphend = </strong>
title = Welcome to {$company}'s home page!
ErrorCity = You must supply a {#emphstart#}city{#emphend#}.
ErrorState = You must supply a {#emphstart#}state{#emphend#}.

Where the template is: 模板 
{config_load file='setup.conf'}
{eval var=$foo}
{eval var=#title#}
{eval var=#ErrorCity#}
{eval var=#ErrorState# assign='state_error'}
{$state_error}

{fetch}

用于从本地文件系统、HTTP或FTP上检索文件并显示其内容。

  • 若是文件名称以"http://"开头，将抓取该网站页面并显示到浏览器。
  • 若是文件名称以"ftp://"开头，将从ftp服务器取得该文件并显示。
  • 对于本地文件，能够提供完整路径，也能够提供一个相对于php执行脚本的相对路径。
  • 若是指定了assign属性，该函数的输出值将被赋给由assign指定的模板变量，而不是直接输出。

注：{fetch}不支持重定向，使用前请肯定但愿抓取的网页地址以'/'结尾！若是开启了安全设置，当取本地文件时{fetch}只能取位于$decure_dir路径定义的安全文件夹下的资料。

属性：

示例：

{* include some javascript in your template *}
{fetch file='/export/httpd/www.example.com/docs/navbar.js'}
{* embed some weather text in your template from another web site *}
{fetch file='http://www.myweather.com/68502/'}
{* fetch a news headline file via ftp *}
{fetch file='ftp://user:password@ftp.example.com/path/to/currentheadlines.txt'}
{* as above but with variables *}
{fetch file="ftp://`$user`:`$password`@`$server`/`$path`"}
{* assign the fetched contents to a template variable *}
{fetch file='http://www.myweather.com/68502/' assign='weather'}
{if $weather ne ''}
  <div id="weather">{$weather}</div>
{/if}

{html_checkboxes}

自定义函数{html_checkboxes}根据给定的数据建立复选按钮组。该函数能够指定哪些元素被选定。

属性：

示例：

<?php
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array(
'Joe Schmoe',
'Jack Smith',
'Jane Johnson',
'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
?>

where template is
{html_checkboxes name='id' values=$cust_ids output=$cust_names
selected=$customer_id separator='<br />'}

{html_image}

自定义函数{html_image}产生一个图象的HTML标签。若是没有提供高度和宽度值，将根据图象的实际大小自动取得。

属性：

  • basedir是相对图象路径的基路径。若是没有给出该属性，将根据WEB服务器的根路径$ENV_DOCUMENT_ROOT为准。若是开启了模板的安全设置，图象的位置必须位于为安全文件夹下。
  • href是图象连接指向的位置。若是提供了连接，图象将被加至<a href="LINKVALUE"><a>标签里面，造成一个图象连接（最终形式为<a href...><img src=...></a>）。
  • 你能够给输出路径设置一个path_prefix可选字符前缀，若是你须要给图像提供一个不一样的服务器名，这种作法将很是有用。
  • 上述列表未提供的参数将以名/值的键值对形式提供在建立的<img>标签里。

{html_options}

自定义函数{html_options}根据给定的数据建立<select><option>选项组。它会留意哪一个选项在默认状况下被选中。

属性：

  • 要么必须指定values和ouput属性，要么指定options属性，二者二选一。
  • 若是指定了属性name，将会建立<select></select>标签，不然只产生选项列表<option>。
  • 若是给定values为数组，将做为html的<optgroup>处理，并显示该群组。<optgroup>支持递归。
  • 上表未提到的其它参数在 <select> 标签中以"名称/属性"对的方式显示。若是没有指定可选属性name这些参数将被忽略。
  • 全部输出兼容XHTML。

{html_radios}

自定义函数{html_radios}根据给定的数据建立html单选按钮组，该函数能够指定哪一个元素被选定。

属性：

  • 要么指定values和ouput属性，要么指定options属性，二者二选一。
  • 全部的输出与XHTML兼容。
  • 上表未提到的其它参数在<input>标签中以"名称/属性"对的方式显示。

{html_select_date}

自定义函数{html_select_date}用于建立日期下拉列表，它能够显示任意年月日。下述列表中没有说明的参数会在相应的年、月、日<select>标签中以名/值的键值对形式显示出来。

属性：

{html_select_time}

自定义函数{html_select_time}用于建立时间下拉菜单，它能够显示任意时、分、秒和正午界。此时间属性能够有不一样的形式，能够是一个独特的时间戳，也能够是YYYYMMDDHHMMSS（年月日时分秒毫秒）形式，或者php的strtotime()解析的字符串形式。

属性：

{html_table}

自定义函数{html_table}将数组中的数据填充到HTML表格中。

属性：

  • cols属性决定表格有多少列。
  • table_attr, tr_attr和 td_attr属性肯定表格中的<table>、<tr>和<td>标签。
  • 若是tr_attr或td_attr属性值为数组，将循环使用其中的值。
  • 若是指定了trailpad属性，将在表尾最后一行附加一些元素。

{mailto}

{mailto}自动生成电子邮件连接，并根据选项决定是否对地址信息进行编码。经编码后的email将使网络蜘蛛破解邮件地址变得更困难。

属性：

示例：

{mailto address="me@example.com"}
<a href="mailto:me@example.com" >me@example.com</a>
{mailto address="me@example.com" text="send me some mail"}
<a href="mailto:me@example.com" >send me some mail</a>
{mailto address="me@example.com" encode="javascript"}
<script type="text/javascript" language="javascript">
eval(unescape('%64%6f% ... snipped ...%61%3e%27%29%3b'))
</script>
{mailto address="me@example.com" encode="hex"}
<a href="mailto:%6d%65.. snipped..3%6f%6d">&#x6d;&..snipped...#x6f;&#x6d;</a>
{mailto address="me@example.com" subject="Hello to you!"}
<a href="mailto:me@example.com?subject=Hello%20to%20you%21" >me@example.com</a>
{mailto address="me@example.com" cc="you@example.com,they@example.com"}
<a href="mailto:me@example.com?cc=you@example.com%2Cthey@example.com" >me@example.
{mailto address="me@example.com" extra='class="email"'}
<a href="mailto:me@example.com" class="email">me@example.com</a>
{mailto address="me@example.com" encode="javascript_charcode"}
<script type="text/javascript" language="javascript">
<!--
{document.write(String.fromCharCode(60,97, ... snipped ....60,47,97,62))}
//-->
</script>

{math}

{math}容许模板设计者在模板中进行数学表达式运算。

  • 表达式中可使用任何数值类型的变量，结果在{math}标签的所在位置输出。
  • 表达式中使用的变量被当作参数传递给函数，能够是模板变量或静态值。
  • 目前可使用的运算符有:+, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, srans 和tan。关于数学函数的详细信息，请查看PHP文档。
  • 若是设定assign属性，{math}函数的输出将分配给模版变量，而不是在模版中直接输出。

注：因为使用了php的eval()函数，{math}函数的代价昂贵（性能较低），在PHP中作数学运算效率会更高一些，所以要尽量在PHP中作数学运算，将结果赋给模板变量。在相似{section}这样的循环中，应尽可能避免反复调用{math}函数。

属性：

示例：

{* $row_height = 10, $row_width = 20, #col_div# = 2, assigned in template *}
{math equation="height * width / division"
height=$row_height
width=$row_width
division=#col_div#}

The above example will output:
100

{textformat}

{textformat}用于格式化文本。该函数主要清理空格和特殊字符，对段落按单词边界换行和行缩进等段落格式化处理。用户能够明确设置参数，或使用预处理风格。目前只有惟一可用风格"email"。

属性：

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程