PHP模板引擎Smarty内建函数foreach,foreachelse用法分析

这篇文章主要介绍了PHP模板引擎Smarty内建函数foreach,foreachelse用法,结合实例形式分析了foreach,foreachelse的功能与具体使用技巧,需要的朋友可以参考下。

本文实例讲述了PHP模板引擎Smarty内建函数foreach,foreachelse用法,分享给大家供大家参考,具体如下:

在 Smarty 模板中,您可以使用 foreach 来重复一个区块。而在模板中则需要从 PHP 中分配过来一个数组。这个数组可以是多维数组。Smarty 中 {foreach} 标记和 PHP 中 foreach 相同,不同的是它们的一个在模板文件中使用,一个在 PHP 脚本中使用。因此,语法会不同。但是,它们的作用都是相同的,即遍历数组中的内容。与 {foreach} 标记相对的还有一个 {foreachelse} 标记,{foreachelse} 标记的作用是:如果数组为空,那么就执行该标记内的内容。 模板中 {foreach} 和 {/foreach} 必须是成对的出现,它有四个参数,其中, from 和 item 两个参数是必要的。关于它的参数请看下面列表:

属性 类型 是否必须 缺省值 描述

from string Yes n/a 待循环数组的名称

item string Yes n/a 当前处理元素的变量名称

key string No n/a

当前处理元素的键名

name string No n/a 该循环的名称,用于访问该循环

我们通过一个实例,来演示 Smarty 中 {foreach} 和 {foreachelse} 的使用。

实例思路:从数据库中取出内容,赋给一个数组变量 $_html ,再给这个数组变量分配给模板,然后在模板中进行该数组的遍历

test.sql (使用到的 SQL 数据)

  1. --
  2. -- 表的结构 `user`
  3. --
  4. CREATE TABLE IF NOT EXISTS `user` (
  5. `id` mediumint(8) unsigned NOT NULL auto_increment,
  6. `username` varchar(50) NOT NULL,
  7. `email` varchar(50) NOT NULL,
  8. `addTime` datetime NOT NULL default '0000-00-00 00:00:00',
  9. PRIMARY KEY (`id`)
  10. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 AUTO_INCREMENT=7 ;
  11. --
  12. -- 转存表中的数据 `user`
  13. --
  14. INSERT INTO `user` (`id`, `username`, `email`, `addTime`) VALUES
  15. (1, '苍井空', 'canjingkong@sina.com.cn', '2011-10-24 00:00:00'),
  16. (2, '樱木花道', 'ymhd@163.com', '2011-10-24 00:00:00'),
  17. (3, '赤木晴子', 'chimiqingzi@yahoo.com,cn', '2011-10-24 00:00:00'),
  18. (4, '流川枫', 'lcfeng@sina.com', '0000-00-00 00:00:00'),
  19. (5, '蜡笔小新', 'labixiaoxin@sina.com', '2011-10-24 00:00:00'),
  20. (6, '金刚葫芦娃', 'jghlw@sina.com', '2011-10-24 00:00:00');

init.inc.php (模板初始化文件)

  1. <?php
  2. define('ROOT_PATH', dirname(__FILE__)); //设置网站根目录
  3. require ROOT_PATH.'/libs/Smarty.class.php'; //加载 Smarty 模板引擎
  4. $_tpl = new Smarty(); //创建一个实例对象
  5. $_tpl->template_dir = ROOT_PATH.'/tpl/'; //重新指定模板目录
  6. $_tpl->compile_dir = ROOT_PATH.'./com/'; //重新指定编译目录
  7. $_tpl->left_delimiter = '<{'; //重新指定左定界符
  8. $_tpl->right_delimiter = '}>'; //重新指定右定界符
  9. ?>

index.php(主文件)

  1. <?php
  2. require 'init.inc.php'; //引入模板初始化文件
  3. global $_tpl;
  4. $_mysqli = new mysqli(); //创建一个 mysqli() 对象
  5. $_mysqli->connect('localhost','root','数据库密码','数据库名'); //连接数据库,请您自行设置
  6. $_mysqli->set_charset('utf8'); //设置编码
  7. $_result = $_mysqli->query("select username,email,addTime from user order by id asc");
  8. $_html = array();
  9. while (!!$_row=$_result->fetch_assoc()) {
  10. $_html[] = $_row;
  11. }
  12. $_tpl->assign('data',$_html); //把数组分配到模板中
  13. $_tpl->display('index.tpl'); //引入模板
  14. $_mysqli->close(); //关闭数据库,释放资源
  15. ?>

tpl/index.tpl(主文件 index.php 的模板文件)

  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  4. <title>foreach,foreachelse</title>
  5. </head>
  6. <body>
  7. <table align="center" width="800">
  8. <{foreach from=$data item="row" name="ls"}> <!-- 这个foreach 循环分配过来的数组有几行数据 -->
  9. <!-- 在此,我们做几个保留变量 $smarty.foreach 的操作 -->
  10. <!-- 当数据显示第一条的时候,第一行的表格背景为黄色,使用属性:first -->
  11. <!-- 当数据显示最后一条的时候,最后一行的表格背景为蓝色,使用属性:last -->
  12. <!-- 显示下分配过来的数组的总个数,使用属性:total -->
  13. <{if $smarty.foreach.ls.first}>
  14. <tr bgcolor="#FFFF00"> <!-- 第一行背景为黄色 -->
  15. <{elseif $smarty.foreach.ls.last}>
  16. <tr bgcolor="#0000FF"> <!-- 最后一行背景为蓝色 -->
  17. <{else}>
  18. <tr>
  19. <{/if}>
  20. <td><{$smarty.foreach.ls.iteration}></td><!-- 注意:这里是保留变量 $smarty.foreach 的使用,iteration:总是从 1 开始,每执行一次增加 1 -->
  21. <{foreach from=$row item="col" name="lsin"}> <!-- 这个foreach 循环数组内的内容,显示在表格的<td></td>标签里 -->
  22. <td><{$col}></td>
  23. <{/foreach}>
  24. </tr>
  25. <{foreachelse}> <!-- 如果分配过来的数组中没有数据,那么就执行下面的操作! -->
  26. <tr>
  27. <td>对不起!暂时没有数据。</td>
  28. </tr>
  29. <{/foreach}>
  30. <tr>
  31. <td colspan="4" align="center">分配数组的总记录数为:<{$smarty.foreach.ls.total}>条</td>
  32. </tr>
  33. </table>
  34. </body>
  35. </html>

最后总结下,主文件 index.php 中传递过去的数组 $_html 为二维数组。保留变量 $smarty.foreach 的使用都是基于 {foreach} 标记中的 name 属性,使用到的保留变量属性有:first(首条记录)、last(末条记录)、iteration(总是从 1 开始,每执行一次增加 1)、total(用于显示循环执行的次数)