smarty

 

 

 

配置：

<?php

/**

 *

 * @version $Id: index.php

 * @package 

 * @author www.php100.com

 * @action 显示实例程序

*/

include_once("./Smarty/Smarty.class.php"); //包含smarty类文件

 

$smarty = new Smarty(); //建立smarty实例对象$smarty

$smarty->templates("./templates"); //设置模板目录

$smarty->templates_c("./templates_c"); //设置编译目录

$smarty->cache("./cache");       //缓存目录

$smarty->cache_lifetime = 0;     //缓存时间

$smarty->caching = true;         //缓存方式

 

$smarty->left_delimiter = "{#";

$smarty->right_delimiter = "#}";

$smarty->assign("name", "zaocha"); //进行模板变量替换

$smarty->display("index.htm");     //编译并显示位于./templates下的index.htm模板

?>

 

 

二：解释smarty的程序

 

我们可以看到，smarty的程序部分实际就是符合php语言规范的一组代码，我们依次来解释一下：

1：/**/语句：

包含的部分为程序篇头注释。主要的内容应该为对程序的作用，版权与作者及编写时间做一个简单的介绍，这在smarty中不是必需的，但从程序的风格来讲，这是一个好的风格。

 

2：include_once语句：

它将安装到网站的smarty文件包含到当前文件中，注意包含的路径一定要写正确。

 

3：$smarty = new Smarty():

这一句新建一个Smarty对象$smarty,简单的一个对象的实例化。

 

4：$smarty->templates(""):

这一句指明$smarty对象使用tpl模板时的路径，它是一个目录，在没有这一句时，Smarty默认的模板路径为当前目录的templates目录，实际在写程序时，我们要将这一句写明，这也是一种好的程序风格

 

。

 

5：$smarty->templates_c(""):

这一句指明$smarty对象进行编译时的目录。在模板设计篇我们已经知道Smarty是一种编译型模板语言，而这个目录，就是它编译模板的目录，要注意，如果站点位于linux服务器上，请确保

 

teamplates_c里定义的这个目录具有可写可读权限，默认情况下它的编译目录是当前目录下的templates_c，出于同样的理由我们将其明确的写出来。

 

6：$smarty->left_delimiter与$smarty->right_delimiter:====自定义界定符：

指明在查找模板变量时的左右分割符。默认情况下为"{"与"}"，但在实际中因为我们要在模板中使用<script>,Script中的函数定义难免会使用{}，虽然它有自己的解决办法，但习惯上我们将它重新定义

 

为"{#"与"#}"或是"<!--{"与"}-->"或其它标志符，注意，如果在这里定义了左右分割符后，在模板文件中相应的要使每一个变量使用与定义相同的符号，例如在这里指定为"<{"与"}>"，htm模板中也要

 

相应的将{$name}变成<{$name}>,这样程序才可以正确的找到模板变量。

7：$smarty->cache("./cache"):

告诉Smarty输出的模板文件缓存的位置。上一篇我们知道Smarty最大的优点在于它可以缓存，这里就是设置缓存的目录。默认情况下为当前目录下的cache目录，与templates_c目录相当，在linux系统中

 

我们要确保它的可读可写性。

 

8： $smarty->cache_lifetime = 60 * 60 * 24:

 

这里将以秒为单位进行计算缓存有效的时间。第一次缓存时间到期时当Smarty的caching变量设置为true时缓存将被重建。当它的取值为-1时表示建立起的缓存从不过期，为0时表示在程序每次执行时缓

 

存总是被重新建立。上面的设置表示将cache_lifetime设置为一天。

 

9： $smarty->caching = 1:

这个属性告诉Smarty是否要进行缓存以及缓存的方式。它可以取3个值，0：Smarty默认值，表示不对模板进行缓存；1：表示Smarty将使用当前定义的cache_lifetime来决定是否结束cache；2：表示

 

Smarty将使用在cache被建立时使用cache_lifetime这个值。习惯上使用true与false来表示是否进行缓存。

 

10：$smarty->assign("name", "zaocha")：

该数的原型为assign(string varname, mixed var),varname为模板中使用的模板变量，var指出要将模板变量替换的变量名；其第二种原形为assign(mixed var)，我们要在后面的例子详细的讲解这个成员函数的使用方法，assign是Smarty的核心函数之一，所有对模板变量的替换都要使用它。

 

11. $smarty->display("index.tpl"):

该函数原形为display(string varname),作用为显示一个模板。简单的讲，它将分析处理过的模板显示出来，这里的模板文件不用加路径，只要使用一个文件名就可以了，它路径我们已经在$smarty->templates(string path)中定义过了。

程序执行完后我们可以打开当前目录下的templates_c与cache目录，就会发现在下边多出一些%%的目录，这些目录就是Smarty的编译与缓存目录，它由程序自动生成，不要直接对这些生成的文件进行修改。

以上我简单的把Smarty程序中的一些常用的基本元素介绍了一下，在后边的例子中你可以看到将它们将被多次的使用。

 

语法：

 

模板调用，index.php：

smarty->assign("模板变量", "值(数组/变量)");

$smarty->display("模板名称");  

例句：

 

$smarty->assign("name", "PHP100中文站"); //进行模板变量替换，替换后模板变量就是$name,切忌

$smarty->display("index.htm");  // 该文件就是模板文件，应该在模板目录下，显示文件

 

引入：

三种引入模式：

{include file="header.htm"}

 

{include file="D:/www/head.htm"}

 

{include file='head.htm' title="Main Menu"}

 

判断：

{if $name=='ok'}

 

{else}

 

{/if}

 

 

 

循环：

对于一维数组：经常使用

=======无键值数组

{foreach from=$name item=id}

id: {$id}<br>

{/foreach}

 

=======有键值数组

{foreach key=j item=v from=$name }

{$j}: {$v}<br>

{/foreach}

--*********item:内容｛键值｝，key：键值，from：数组

手册解释：

foreach 是除 section 之外处理循环的另一种方案(根据不同需要选择不同的方案).

foreach 用于处理简单数组(数组中的元素的类型一致)，它的格式比 section 简单许多，缺点是只能处理简单数组.

foreach 必须和 /foreach 成对使用，且必须指定 from 和 item 属性.

name 属性可以任意指定(字母、数字和下划线的组合).

foreach 可以嵌套，但必须保证嵌套中的 foreach 名称唯一.

from 属性(通常是数组)决定循环的次数.

foreachelse 语句在 from 变量没有值的时候被执行.

 

 

 

对于二维数组：

 

{section name=s loop=$stu}

 

{$stu[s].name}

 

{sectionelse} 

 

无内容

 

{/section}

------********

name: section的名称，不用加$，相当于给二维数组从新建立索引

$loop: 要循环的变量，在程序中要使用assign对这个变量进行操作

 

手册解释：

模板的 section 用于遍历数组中的数据. section 标签必须成对出现. 必须设置 name 和 loop 属性. 

名称可以是包含字母、数字和下划线的任意组合. 可以嵌套但必须保证嵌套的 name 唯一. 变量 loop (通常是数组)决定循环执行的次数.

 当需要在 section 循环内输出变量时，必须在变量后加上中括号包含着的 name 变量. sectionelse 当 loop 变量无值时被执行. 

 

输出：{$name}

采用｛｝界定符可以实现类似php

<?php ?>标签的功能

 

 

 

二、示例站点目录结构：

PHP代码:--------------------------------------------------------------------------------

+Web (站点根目录)

|

|----+comm (Smarty相关文档目录) 

| |

| |----+plugins (Smarty插件目录)

| |-----Config_File.class.php (Smarty配置文件)

| |-----Smarty.class.php (Smarty类主文件)

| |-----Smarty_Compiler.class.php (Smarty编译类文件)

|

|----+cache (Smarty缓存目录，*nix下保证读写权限)

|

|----+templates (站点模板文件存放目录)

| |

| |----header.tpl(页面页头模板文件)

| |----index.tpl(站点首页模板文件)

| |----foot.tpl(页面页脚模板文件)

| |----news.tpl (新闻页模板文件)

|

|

|----+templates_c (模板文件编译后存放目录，*nix下保证读写权限)

|

|----+css (站点CSS文件目录)

|

|----+image (站点图片目录)

|

|----+media (站点Flash动画存放目录)

|

|----indexbak.htm (首页原始效果图)

|

|----newsbak,htm (新闻页原始效果图)

|

|----index.php (Smarty首页程序文件)

|

|----news.php (Smarty新闻显示文件)

|

|----例程说明.txt (目录说明)

|

|----数据库建立文件.txt (数据库的建立文档)

 

 

 

与数据库的连接：

 

smarty_inc.php是引入samrty的文件，那么同理数据库也要配置一个类文件；mysql_inc.php

模板的强大之处在于与数据连接，然后读取数据，经过循环处理输出结果

index.php 代码：

include("smarty_inc.php");

include("mysql_inc.php");

 

$conn=db_connect($h,$p,$u,$db);

mysql_query("SET names 'UTF8'");

 

 

$sql="select id,board_name,board_desc from boards";

$res=mysql_query($sql);

 

if(mysql_num_rows($res)){

while($row=mysql_fetch_array($res)){

$time=$row['id'];

$array[]=array('id'=>$row['id'],'bname'=>$row['board_name'],'bdesc'=>$row['board_desc']);

}

}

$smarty->assign("name",$array); //进行模板变量替换

$smarty->display("index.htm");     //编译并显示位于./templates下的index.htm模板

 

 

--*****************************************************************

反思：如何学习模板：

1）配置：配置文件，其实就是引入模板的过程：注意事项：引入文件的路径正确与否，模板的基本参数设置，实例化一个

2）模板的使用，主要是语法类，和php语言一样他也有自身的一套处理机制，类比php，有四点：引入，判断，循环，输出 这个四个基本类的语法知识

3）与数据连接起来，读取数据数据，显示输出