标签：
Smarty是一个使用PHP写出来的模板引擎，是目前业界最著名的PHP模板引擎之一。它分离了逻辑代码和外在的内容，提供了一种易于管理和使用的方法，用来将原本与HTML代码混杂在一起PHP代码逻辑分离。简单的讲，目的就是要使PHP程序员同前端人员分离，使程序员改变程序的逻辑内容不会影响到前端人员的页面设计，前端人员重新修改页面不会影响到程序的程序逻辑，这在多人合作的项目中显的尤为重要。作为一个前端工程师了解Smarty也很有必要，本文是从官方文档上归纳出来的简明教程，以备快速查阅。
所有的smarty模板标签都被加上了定界符。默认情况下是 { 和}，但它们是可被改变的，可以进行自定义设置。
示例：
{* Smarty *}
每一个smarty标签输出一个变量或者调用某种函数。在定界符内 函数（用‘{‘包住）和其属性（用界符包住）将被处理和输出。
示例：
{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"}
大多数函数都带有自己的属性以便于明确说明或者修改他们的行为。smarty函数的属性很像HTML中的属性。静态数值不需要加引号，但是字符串建议使用引号。 如果用变量作属性,它们也不能加引号。
示例：
{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>
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
数学运算可以直接应用到变量。
{$foo+1}
{$foo*$bar}
{$foo->bar-$bar[1]*$baz->foo->bar()-3*7}
{$foo|truncate:"`$fooTruncCount/$barTruncFactor-1`"}
{assign var="foo" value="`$foo+$bar`"}
在Smarty模版，如果‘｛’和‘｝’大括号里包含有空格那么整个{}内容会被忽略，你可以设置Smarty类变量$auto_literal=false来取消这种规则。
{literal}...{/literal}块被用来忽略模版语法的解析，你也可以用{ldelim}、{rdelim}标签或{$smarty.ldelim}、{$smarty.rdelim}变量来忽略个别大括号（译注：后面两种方法主要用来在模版中输出左右大括号）。
Smarty默认定界符‘｛’和‘｝’简洁地描述具体的内容，然而如果你有更好的定界符设置，也可以用Smarty的$left_delimiter和$right_delimiter设置相应的值。
调用从PHP分配的变量需在前加"$"符号，调用模板内的assign函数分配的变量也是这样。
要想引用关联数组变量，可以用‘.‘取得对应key的value。
{$Smarty.example}
可以通过变量的下标取得对应的位置的元素。
{$Smarty[index]}
对象的属性可以通过“->”符号引用。
{$Smarty->key}
你可以选择为主要的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>
变量调节器用于变量，自定义函数和字符串。 请使用‘|’符号和调节器名称应用调节器。 变量调节器由赋予的参数值决定其行为。 参数由‘：’符号分开。
示例：
{* 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"}
对于同一个变量，你可以使用多个修改器。它们将从左到右按照设定好的顺序被依次组合使用。使用时必须要用"|"字符作为它们之间的分隔符。
示例：
{$Smarty|lower|spacify|truncate:30:". . ."}
这是{assign}函数的简写版，你可以直接赋值给模版，也可以为数组元素赋值。
{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 var="name" value="Bob" nocache}
{assign "name" "Bob" nocache} {* short-hand *}
{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}用来调用{function}标签定义的模板函数，类似于插件函数。
另外你可以在模板中直接使用{funcname...}函数。
属性：
选项标签：
示例：
{* 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 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}
属性：
{debug}跳转到调试控制页面。不管php脚本中如何设置debug，它都会工作，因为它在运行时就执行，它只能够显示分配的变量值；而不是（显示）正在使用的模版。然而，你可以看到变量作用域内的所有变量值。
如果cacheing设置为true，页面从缓存{debug}中加载，那么你只能看到缓存过的变量。
{extends}标签用在模板继承中子模版对父模板的继承。
示例：
{extends file=‘parent.tpl‘}
{extends ‘parent.tpl‘} {* short-hand *}
{for}、{forelse}标签用来创建一个简单循环，支持以下不同的格式：
当循环无迭代时执行{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}用来遍历数据数组，{foreach}与{section}循环相比更简单、语法更干净，也可以用来遍历关联数组。
{foreach $arrayvar as $itemvar}
{foreach $arrayvar as $keyvar=>$itemvar}
示例：
<?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}用来在模板中创建函数，可以像调用插件函数一样调用它们。取代在插件中写表象内容的函数，让模板保持一致性通常是个更好的选择。它也简化了对数据的遍历，例如深度的嵌套菜单。另外你可以在模板中直接使用{funcname...}函数。
示例：
{* 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}
随着一些特性加入到模版引擎，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 ‘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}在Smarty新版本中已被废弃，可使用插件恰当地解决从（php）代码分离html的问题。
{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}用来转义模版定界符，默认值为“{”和“}”。你也可以用{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}标签区域内的数据将按字面意思处理，代表性地是用在javascript/css语块周围，不然这些语言使用的花括号‘{’、‘}’会干扰模版定界符语法。{literal}{/literal}标签里面的所有符号不会被解释，全部按原样输出。如果有需要在{literal}块里使用模版标签，可以考虑使用{ldelim}{rdelim}转义单独的分隔符。
{nocache}用来禁止模版块缓存，每个{nocache}应与{/nocache}成对出现。当从缓存中加载页面时应确定无缓存块使用的变量为php变量（而非模板中定义的变量）。
示例：
Today‘s date is
{nocache}
{$smarty.now|date_format}
{/nocache}
{php}已被Smarty弃用，不应再使用。还是用你自己编写的php脚本或插件函数来代替它吧！
不同于{foreach}遍历单层关联数组，{section}支持循序索引遍历数组中的数据（支持一次性读取多维数组）。每个{section}标签必须与闭合标签{/section}成对出现。
注：{foreach}可以做{section}能做的所有事，而且语法更简单、更容易。它通常是循环数组的首选。{section}循环不能遍历关联数组，（被循环的）数组必须是数字索引，像这样（0，1，2，...）。对于关联数组，请用{foreach}循环。
属性：
选项标签：
随着一些特性加入到模版引擎，Smarty的{while}循环与php的while语句一样富有弹性。每一个{while}必须与一个{/while}成对出现，所有php条件和函数在它身上同样适用，诸如||、or、&&、and、is_array()等等。
下面是一串有效的限定符，它们的左右必须用空格分隔开，注意列出的清单中方括号是可选的，在适用情况下使用相应的等号（全等或不全等）。
示例：
{while $foo > 0}
{$foo--}
{/while}
用于输出一个记数过程。{counter}保存了每次记数时的当前记数值。用户可以通过调节间隔（skip）和方向（direction）计算该值。也可以决定是否输出该值。如果需要同时运行多个计数器，必须为它们指定不同的名称。如果没有指定名称，模板引擎使用 "default" 作为缺省值。
如果指定了 "assign" 这个属性，该计数器的输出值将被赋给由assign指定的模板变量，而不是直接输出。
属性：
示例：
{* initialize the count *}
{counter start=0 skip=2}<br />
{counter}<br />
{counter}<br />
{counter}<br />
Cycle用于交替使用一组值。该特性使得在表格中交替输出多种颜色或循环使用数组中的值变得更容易。
属性：
示例：
{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>
将变量作为一个模板求值。该特性用于诸如将模板标签/变量嵌入至另一变量，或将标签/变量嵌入至配置文件中的变量的情形。如果指定了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}
用于从本地文件系统、HTTP或FTP上检索文件并显示其内容。
注：{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}根据给定的数据创建复选按钮组。该函数可以指定哪些元素被选定。
属性：
示例：
<?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标签。如果没有提供高度和宽度值，将根据图象的实际大小自动取得。
属性：
自定义函数{html_options}根据给定的数据创建<select><option>选项组。它会留意哪个选项在默认情况下被选中。
属性：
自定义函数{html_radios}根据给定的数据创建html单选按钮组，该函数可以指定哪个元素被选定。
属性：
自定义函数{html_select_date}用于创建日期下拉列表，它可以显示任意年月日。下述列表中没有说明的参数会在相应的年、月、日<select>标签中以名/值的键值对形式显示出来。
属性：
自定义函数{html_select_time}用于创建时间下拉菜单，它可以显示任意时、分、秒和正午界。此时间属性可以有不同的形式，可以是一个独特的时间戳，也可以是YYYYMMDDHHMMSS（年月日时分秒毫秒）形式，或者php的strtotime()解析的字符串形式。
属性：
自定义函数{html_table}将数组中的数据填充到HTML表格中。
属性：
{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">m&..snipped...#x6f;m</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}允许模板设计者在模板中进行数学表达式运算。
注：由于使用了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}用于格式化文本。该函数主要清理空格和特殊字符，对段落按单词边界换行和行缩进等段落格式化处理。用户可以明确设置参数，或使用预处理风格。目前只有唯一可用风格"email"。
属性：
标签：
原文地址：http://www.cnblogs.com/syfwhu/p/5258808.html
