Smarty:foreach函数

{foreach}用于循环数组。 {foreach}的语法比{section}循环要更简单和清晰，并且可以使用非数字下标的数组。

{foreach $arrayvar as $itemvar}

{foreach $arrayvar as $keyvar=>$itemvar}

foreach的语法可以接受没有名称的属性，该语法是Smarty 3新增的。然而Smarty 2语法 {foreach from=$myarray key="mykey" item="myitem"}也同样支持。

{foreach} 循环可以被嵌套使用.

array变量，一般是数组的值，决定了{foreach} 循环的次数。你也可以传递一个任意的整数来控制循环次数。

如果array数组变量中，没有值的情况下， {foreachelse}将执行。

{foreach}的属性： @index, @iteration, @first, @last, @show, @total.

{foreach}的语法命令： {break}, {continue}.

代替指定key变量，你可以通过 {$item@key}来使用循环的当前key。(见下面的例子).

$var@property的语法是Smarty 3新增的。然而Smarty 2风格的语法{foreach from=$myarray key="mykey" item="myitem"},$smarty.foreach.name.property也是支持的。

即使你在循环语法里{foreach $myArray as $myKey => $myValue} 已经指定了key的变量名，但循环体内$myValue@key还是可用的。

可选标记:

Example 7.30. 简单的{foreach} 循环

模板将顺序输出$myColors。

输出：

Example 7.31. 使用key变量的例子

模板将以键值对的方式输出$myArray

输出：

Example 7.32. 多维数组通过item 和 key来嵌套使用{foreach}

多维数组的键一般会对应另一个数组。

模板将输出$contact.

上面两个例子都会输出：

Example 7.33. {foreachelse}的数据库例子

循环显示数据库（PDO）结果。例子是循环了一个PHP的迭代器（iterator）而不是一个数组（array）。

上面的例子显示了查询结果id 和 name两个字段的内容。

迭代器和数组循环哪个更高效呢？数组而言，每次循环之前全部的数组数据都会被先放到内存堆栈内，然后再进行循环。 而迭代器每次迭代循环时，都会载入并释放结果内容，这样可以节省运行时间和内存，尤其是当结果集非常大的时候。

index是当前数组索引，从0开始计算。

Example 7.34. index 例子

iteration是当前循环的次数，和index不同，iteration是从1开始。 iteration在每次循环的时候都会加一。

Example 7.35. iteration 例子: is div by

"is div by"运算可以对循环次数做一些特殊的判断。 下面我们将每4次循环就输出一次粗体的名称。

Example 7.36. iteration 例子: is even/odd by

"is even by" 和 "is odd by"可以用于在循环中奇偶交替进行一些操作。在开始的时候可以选择奇或偶的循环。 下面是每三次循环会改变一次字体颜色。

输出：

当循环{foreach}是首次循环时，first将为TRUE 下面我们用first来显示一个表格的表头。

Example 7.37. first例子

当{foreach}循环到了最后一次时， last将为TRUE。 下面我们将在循环的最后插入一条水平线。

Example 7.38. last例子

show属性是在{foreach}循环执行之后， 检测循环是否显示数据的判断。 show是一个布尔值。

Example 7.39. show例子

total是整个{foreach}循环的次数。 total可以在{foreach}内部，或者之后使用。

Example 7.40. total例子

参见{section}, {for} 和 {while}

{break}停止循环。

Example 7.41. {break} 例子

{continue}将跳过当前本次循环并进入下一次循环。

Example 7.42. {continue} 例子