论坛 › 网站开发技术与项目孵化 › [原创]Smarty中section的简单使用

涩兔子 发表于 2004-12-31 15:53:00

[原创]Smarty中section的简单使用

可以下载压缩的zip文档

Smarty中section的简单使用
作者：翟翔
Email：[email protected]

什么是section？
就像在Smarty官方手册里提到的，模板section是用来循环数组里的数据的。所有的section标签必须和/section标签成对儿使用。必须使用的参数是name和loop。section的name可以随你所好，可以是由字母、数字和下划线组成的。section可以嵌套使用，互相嵌套的section它们的name必须与众不同。变量loop（通常是数组的值）决定着section将要循环的次数。当用section显示一个变量时，section的name必须紧跟在变量名的后面，并用中括号 [] 括起来。当loop变量没有值时，sectionelse就会运行。
下面就是一个name为left_block，loop为$LEFT_BLOCK_BODY的section，注意到<div class=”left_block”></div>当中显示变量的方法了么？section的name也就是left_block紧跟在$LEFT_BLOCK_BODY的后面，并用中括号 [] 括起来了。
<{section name=left_block loop=$LEFT_BLOCK_BODY}>
<div class="left_block"><{$LEFT_BLOCK_BODY}></div>
<{/section}>

为什么要使用section？
就像phpBB2的成员列表，如下图，显示的内容
当你设计成员列表时（如下图所示），你要用到section。

因为你无法确认有多少个用户注册，即使确认就100个限制用户注册，用传统的table设计网页你需要作的是牲口般的工作，所以把这些交给section来处理吧。
其实还有很多地方可以用到section。比如用div来作网页布局的时候，左、中、右区域的区块儿和模块儿都是由后台数据库的block management来管理的，网页设计者根本就不知这些动态浮动的区块儿、模块儿在什么地方、什么时候、什么样式、什么内容出现，或者这些区块儿和模块儿压根儿就不让你看见（管理员控制面板对一般用户就是隐藏的），section可以轻松地管理登陆框、导航栏、新闻发布、谁在线、语言选择等区块儿和模块儿。

如何使用section？
Smarty中的section和PHPLib中template的block很相似，但section更为smart。如果你使用过PHPLib的block很快你就会过渡到section，如果你以前压根儿就没有听说过这些事儿， 反而更容易掌握section的概念，因为什么都不知道嘛。Just kidding^_^
来个简单的导航栏元素设计的例子。传统的导航栏设计很实诚（如下图），

有多少个链接就用dreamweaver设计几个，有千千万万个怎么办呢？而且还要随时变化怎么办呢？你只用设计一个链接其他的就让section去循环显示好了。用dreamweaver设计一个名为navigation.htm的页面（只保留了table当中要用到的元素，其余的html元素在不影响显示的前提下均以省略），如下面html代码。
<table width="100%"border="0" cellspacing="0" cellpadding="0">
<tr>
    <td><h2><{$L_TITLE_NAVIGATION}></h2></td>
</tr>
<{section name=navigation loop=$l_navigation}>
<tr>
<td><img src="<{$IMG_DOT}>" width="12" height="12">
<a href="<{$u_navigation}>"><{$l_navigation}></a></td>
</tr>
<{/section}>
</table>
其中<a href="<{$u_navigation}>"></a>就定义了超链接变量，<{$l_navigation}>就定义了超链接的名称，用<{section name=navigation loop=$l_navigation}>和<{/section}>框住要循环显示的部分，一个自动化的导航栏的表现层就设计好了。（请参看MVC模型）
光有皮肤没有骨架是支撑不起导航栏来的，所以让我们看看如何用PHP代码控制显示导航栏的。写一个名为navigation.php的PHP文件，代码如下：
$template->assign("l_navigation", array(
        //要在其他地方给$lang[' …… ']负值
$lang['index'],
        $lang['your_account'],
        $lang['downloads'],
        $lang['submit_news'],
        $lang['topics'],
        $lang['top10']
        )
);

$template->assign("u_navigation",array(
        "./index.php",
        "./modules.php?name=Your_Account",
        "./modules.php?name=Downloads",
        "./modules.php?name=Submint_News",
        "./modules.php?name=Topics",
        "./modules.php?name=Top10"
        )
);
你肯定要惊叹：“really?”真的是这么简单呀^_^
首先，$template->assign是在调用Smarty的smarty类当中的assign函数，assign的意思就是赋值、分配、指派的意思。$template->assign给navigation.htm网页模板中的l_navigation变量赋了一个数组，并提供了6个变量型的数组值（你要在其他地方给它们负值，或者直接像给超链接地址负值一样用" …… "的形式）——用来显示超链接的名称，其中的数组键值用PHP默认的0、1、2……就省略了；还给u_navigation变量赋了一个数组，相对称的也是6个但已给出数值的变量——用来定义超链接的去向（其中运用了参数?name来判断转向哪个模块儿）。你可能会产生疑问：循环的次数在哪里定义的？loop变量名仅仅是$l_navigation数组呀！如果你有机会查看Smarty的代码，你会发现loop = count($l_navigation)，只是这个过程被封装了，你只用调用这个section接口就OK了。
然后，利用smarty类当中的display函数，就可以运行navigation.php查看你的导航栏了
$template->display(“navigation.htm”);

进一步使用section
就像我前面提到的，section主要在处理多个重复其不断变化的元素上优势明显。这里由于篇幅有限，就把思想和大家共享，把未完善的内容留给以后的文章。变化的数据来源于数据库，那么在$template->assign一个section变量的时候可以用到DB（是PEAR提供的对多种数据库操作的集成度很高的类，可以一次编写标准的SQL语句在大多数主流数据库上到处运行）和section的综合利用。
在网页中显示居于左侧的区块儿和模块儿
$sql = "SELECT block_value FROM sirtoozee_blocks
WHERE block_side = 'left' and block_visble = 'true'
ORDER BY 'weight ";
//用getCol这个API可以得到一维数组$block = array('','',...)
$block_value = $db->getCol($sql);
$template->assign("LEFT_BLOCK_BODY", $block_value)
你可以print_r($block_value)看看$block_value这个数组结构是不是就是array('' …… '', ... )的结构一模一样。其中具体的DB类的使用和网页layout布局我会在以后的文章中详细讲解。

如果大家对调用Smarty不熟悉，我在这里也简单介绍安装配置Smarty的方法：
到http://smarty.php.net 下载stable版本的smarty，将压缩包里./libs文件夹里的所有文件解压缩到Smarty（需要自己新建）文件夹中，并将你设计的网页模板文件，如navigation.htm放在templates（需要自己新建）文件夹下，还需要为Smarty新建config、cache、templates_c文件夹用来编译生成临时文件，最后形成如下的文件目录结构：
./
./Smarty/internals
./Smarty/plugins
./Smarty/Config_File.class
./Smarty/debug
./Smarty/Smarty.class
./Smarty/Smarty_Compiler.class
./templates
./templates_c
./config
./cache
用如下代码调用Smarty类
//
//模板引擎配置，采用smarty-2.6.6
//
include("./Smarty/Smarty.class.php");
$template = new Smarty;
//安装并配置Smarty模板引擎
$template->template_dir = "./templates/ ";
$template->compile_dir = "./templates_c";
$template->config_dir = "./configs";
$template->cache_dir = "./cache";
//为了和javascript标签区别开来
$template->left_delimiter = "<{";
$template->right_delimiter = "}>";

ise 发表于 2005-3-22 14:57:06

涩兔子, 想请问一下我将smarty解压在/var/www/html下我的文件结构为：
class/Smarty.class.php
class/Config_File.class.php
class/Smarty_Compiler.class.php
//////////////////////////////////////////
smarty/conf/
smarty/templates/
smarty/templates_c
smarty/cache/
我按照安装说明来安装的，但是就是在编译是老是出现如下的问题：
error /var/www/html/smarty/templates_c can't be write , be sure the web server user is writeable for the directory. 我的templates_c 的文件的属性为：
templates_capache:apache 0771 能帮帮我吗？先行谢过了。

涩兔子 发表于 2005-3-22 16:28:08

呵呵，你使用chmod777 /var/www/html/smarty/templates_c:mrgreen:

ise 发表于 2005-4-2 00:43:30

不行，我用的是fc3后来看了可以用两种方法来解决：
1：由于我的fc3下的documentroot目录是/var/www/html user and group是apache 所以用如下命令： chown -R apache:apache /var/www/html
2：可以将在Smarty.class.php中设置compile_dir="/tmp/".

涩兔子 发表于 2005-4-2 08:19:00

解决了就是好方法 :mrgreen:

查看完整版本: [原创]Smarty中section的简单使用