samrty学习快速上手 教程+实例
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)与数据连接起来,读取数据数据,显示输出