smarty 内建函数

 config_load :加载配置文件

   file= “配置文件名称”

   section=“区域名称”

 

  $tpl->configs=”./configs” //基准路径

  ./configs/dir_1/a.conf

 <{config_load file=” dir_1/a.conf” section=“one” }>

 

include ：

标签用于在当前模板中包含其它子模板.

当前模板中的变量在被包含的子模板中可用

  <{include  file=”header.tpl”}>

<{include  file=”footer.html”}>

 

 

capture

  捕获模板输出的数据并将其存储到一个变量里,而不是把它们输出到页面.

  任何在 {capture name="foo"}和{/capture}之间的数据将被存储到变量$foo中，该变量由name属性指定.
在模板中通过 $smarty.capture.foo 访问该变量.
如果没有指定 name 属性,函数默认将使用 "default" 作为参数.
{capture}必须成对出现，即以{/capture}作为结尾,该函数不能嵌套使用.

 

<{capture name=”自定义区域名”}>

aAaaaaaaaaaaaaa

<{$name}>

<{include  file=”head.tpl”}>

……

<{/capture}>

 

<{$smarty.capture.自定义区域名}>

 

foreach,foreachelse

  功能和语法与php当中类似，====foreach

  foreach($row as $key=>$value){

      …

}

• from和item是必要属性
• {foreach}循环的name可以是任何字母，数组，下划线的组合，参考PHP变量。

• {foreach}循环可以嵌套，嵌套的{foreach}的名称应当互不相同。
  

• The from attribute, usually an array of values, determines the number of times {foreach} will loop.

• from属性通常是值数组，被用于判断{foreach}的循环次数。
  

• {foreachelse} is executed when there are no values in the from variable.

• 在from变量中没有值时，将执行{foreachelse}。
  

• {foreach}循环也有自身属性的变量，可以通过{$smarty.foreach.name.property}访问，其中"name"是name属性。
  

  注意：name属性仅在需要访问{foreach}属性时有效，与{section}不同。访问未定义name的{foreach}属性不会抛出一个错误，但将导致不可预知的结果。
  

• {foreach} properties are index, iteration, first, last, show, total.

• {foreach}属性有index, iteration, first, last, show, total.

 

foreach详解：见http://blog.sina.com.cn/s/blog_629045ef0100f8mq.html。

 

section,sectionelse   （推荐）for

   功能和效率要比foreach好

   只针对索引数组

   section 显示二维数组 loop

   section 不能处理下标不连续的数组

  

1、section中的属性

name:（必选） 是section循环的名称只是标示循环唯一的名字没有特别意义，前面没有$符号；

loop: （必选）是在php声明中的变量名称，用来标示是循环哪一个数组（即要循环数组名）需要使用$；

start: （可选）循环执行的初始位置. 如果该值为负数，开始位置从数组的尾部算起. 例如：如果数组中有7个元素，指定start为-2，那么指向当前数组的索引为5. 非法值(超过了循环数组的下限)将被自动调整为最接近的合法值.

step: （可选）如其它语言的循环，是一个步长，如果为负数，则倒序循环；

max:（可选）循环的最大下标，如果是1则只循环1次，如果为2则循环2次；

show：（可选）默认为true即显示。如果设置了{sectionelse}。表示如果数组没有内容的时候显示这部分的内容；如果show为false则显示这部分。如果没有设置{sectionelse}则不输出该数组。

2、smarty中section中的变量

index:用于显示当前循环的索引，从0开始(如果指定了start属性，那么由该值开始)，每次加1(如果指定了step属性，那么由该值决定).如果没有指定step和start属性，此值的作用和iteration类似，只不过从0开始而已.

index_prev:用于显示上一个循环索引值. 循环开始时，此值为-1.

index_next:用于显示下一个循环索引值. 循环执行到最后一次时，此值仍然比当前索引值大1(如果指定了step，取决于此值).

iteration:用于显示循环的次数.iteration 不像index属性受start、step和max属性的影响，该值总是从1开始(index是从0开始的).rownum 是iteration的别名，两者等同.

first:如果当前循环第一次执行，first 被设置为true.

last:如果当前循环执行到最后一次，last 被设置为true.

rownum:用于显示循环的次数. 该属性是iteration的别名，两者等同.

loop:用于显示该循环上一次循环时的索引值. 该值可以用于循环内部或循环结束后.

show:是 section 的参数. show 取值为布尔值 true 或 false. 如果设置为 false，该循环将不显示. 如果指定了 sectionelse 子句，该字句是否显示也取决于该值.

total:用于显示循环执行总的次数. 可以在循环中或执行结束后调用此属性.

 

if,elseif,else

 

if语句和和条件同php差不多，

但每个词之间必须用空格分割开。

也有一些新的条件语句，列举如下：

eq相等，

ne、neq不相等，

gt大于，

lt小于，

gte、ge大于等于，

lte、le 小于等于，

not非，

 mod求模。

is [not] div by是否能被某数整除，

is [not] even是否为偶数，

$a is [not] even by $b即($a / $b) % 2 == 0，

is [not] odd是否为奇，

$a is not odd by $b即($a / $b) % 2 != 0 示例：

{if $name eq "Peter"}Welcome male.{elseif $name eq "Fengfeng"}Welcome female.{else} Welcome, whatever you are. {/if}