smarty实例教程 —实例篇
一、使用PHP内置MYSQL函数
从本节开始我们来学习一下如果把Smarty应用到实际的例子中. 为了演示说明,我将以前写的一个站点作为实例来讲来下.先说明一下, 我本人的美术功底不是很强,所以设计出来的页面不太好看,大家就对付着看吧
在看本文之前，可以先看看indexbak.htm与newsbak.htm，它们是我们生成后的例图。
一、 首先来说明一下我们将要使用到的数据库,下面我先将数据库源文件给大家例出来:
======================================================================
Create DATABASE News;
USE News;
/****************************
*
* 表 名: tb_news_ch
* 用 途: 国内新闻表
*
****************************/
Create TABLE tb_news_ch
(
iNewsID interger(11) primary key auto_increment,
vcNewsTitle varchar(50) not null,
ltNewsContent longtext not null
);
/****************************
*
* 表 名: tb_news_in
* 用 途: 国际新闻表
*
****************************/
Create TABLE tb_news_in
(
iNewsID interger(11) primary key auto_increment,
vcNewsTitle varchar(50) not null,
ltNewsContent longtext not null
);
/****************************
*
* 表 名: tb_news_mu
* 用 途: 娱乐新闻表
*
****************************/
Create TABLE tb_news_mu
(
iNewsID interger(11) primary key auto_increment,
vcNewsTitle varchar(50) not null,
ltNewsContent longtext not null
);
======================================================================
我这里简单的将数据库说明一下.
第一个问题:
大家可以看到,其实3个数据表的字段名都一样,那么为什么不把它们合并成一个数据表呢,答案很简单:效率,在开发的时候我们可能感觉不出有什么可提高效率的地方,不过大家想想,当这个网站运行一段时间后,它的新闻数据量就会变的很大,而且考虑到如果将来网站做大后可能将各个类型分离出来形成类似china.xxx.com, international.xxx.com, music.xxx.com,将每一栏目独立分出去物理上做成一个单独的站点,到那时如果新闻还是合起来放置的话就会造成数据库瓶颈,所以针对当前的站点,我认为还是分开的比较合理.
第二个问题:
有人可能问了,你在字段前加的i, vc,lt干什么用?这里是按照字段类型来命名的, 这也是一种良好风格的体现,将类型前缀放在变量前,使用用户不用看字段定义就可以知道字段是什么类型,这是从微软的匈牙利命名法中参考过来的,在数据库设计时,我先将每种类型定义成1–3个字母,然后在每个字段前加相应的代码来代表它的类型.像上边,我将各个数据库字段类型定义为:
integer i
varchar vc
longtext lt
char c
….
在使用的时候,你可以往每个数据表中输入5条数据记录以备我们在调试实例时使用.
二、示例站点目录结构：
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 (数据库的建立文档)
详细情况请大家下载实例后对照结构图。
——————————————————————————–
三、模板中的实例片段：
1. index.tpl:
index.tpl是站点首页的模板类，打开它的源文件后我们可以首先看到这么二句：
==================================================
1. <{*下面这一句为本页面的页面头*}>
2. <{include file=”header.tpl”}>
==================================================
第 1 句大家都知道了，是模板注释
第 2 句表示在当前位置要包含另一个文件，什么文件呢，header.tpl，这里的这个header.tpl是页面的标准页头文件，把它单独拿出来是为将这一部分独立出来，以便在在其它页面进行重用，习惯上要把页头文件写在一个table中，但因为我的实例是早已做好的，所以有些不符合规范。
再来看最后一句：
=================================================
3. <{include file=”foot.tpl”}>
=================================================
不用说大家都明白了，就是包含一个页脚文件。
再看看国内新闻部分的模板代码：
<table width="100%" border="0" cellpadding="0" cellspacing="0" bgcolor="#B9E9FF">
<tr>
<td height="115" width="10"></td>
<td valign="top" width="295" bgcolor="#B9E9FF">
<{section name=loop loop=$News_CH}>
<li class="newsfont"><a href="news.php?type=1&id=<{$News_CH[loop].NewsID}>" class="newsfont"><{$News_CH[loop].NewsTitle}></a>
<{/section}>
</td>
</tr>
</table>
大家关键看<{section}>与<{/section}>,它们之外的那一部分是为了更好的理解代码的意思而列出来的。能看明白吗？这里将以前讲过的内容复习一遍：定义了一个section循环模板块，名字叫loop, 要循环的是$News_CH这个数组，以<a href=”xxxx”>处将为当前的新闻产生一个链接，地址为news.php?type=1&id=xxx,这里的xxx是从数据库里提取的iNewsID,指的是要在新闻显示页里显示编号为id的新闻。$News_CH[loop].NewsTitle这种表示形式来看的懂吧？看不懂的话看看上一节讲过的《Smarty实例教学 —程序设计》部分中的<{section}>语法。
也许大家对<{}>感觉有点陌生，这里的<{}>为模板语句定义块，在前2节我们都使用{}，但因为这里是具体的应用，所以就不取{}了，使用大家习惯的<{}>来表示，当然这在.php文件中要设置的。
再看国际新闻与娱乐新闻的代码：
国际新闻：
<table width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="295" height="115" valign="top">
<{section name=loop loop=$News_IN}>
<li class="newsfont"><a href="news.php?type=2&id=<{$News_IN[loop].NewsID}>" class="newsfont"><{$News_IN[loop].NewsTitle}></a>
<{/section}>
</td>
</tr>
</table>
娱乐新闻：
<table width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="296" height="115" valign="top">
<{section name=loop loop=$News_MU}>
<li class="newsfont"><a href="news.php?type=3&id=<{$News_MU[loop].NewsID}>" class="newsfont"><{$News_MU[loop].NewsTitle}></a>
<{/section}>
</td>
</tr>
</table>
有没有看出有什么不同? loop部分不同，loop指的是要循环的数组，这里要注意的，不可将多个section的loop指定为同一个值，那样的话Smarty进行分析模板的时候就会将两个具有相同名字的section同时分析，生成两个一样的记录。
看到这里，有人就会产生疑问：循环块我已经有了，我怎么才能就它在当前位置只显示我们想要的记录数呢？这个问题简单，我们对Smarty的section循环块的循环次数控制是在.php文件中控制要替换这个循环块的数组来决定的，在设计模板时我们不用考虑。
其次，我们再来看看news.tpl:
1. 看这一句：
<title><{$NewsTitle}> —-天骄信息网</title>
将要显示的新闻页的标题显示为新闻标题 + “—-天骄信息网”
2. 新闻标题：
<div align=”center” class=”NewsTitle”><{$NewsTitle}></div>
这里又设置了一个模板变量$NewsTitle,意思说要.php将$NewsTitle(包括标题栏)替换为数据库中当前新闻的标题。
3. 新闻内容：
<p><{$NewsContext}></p>
这一句也容易，在当前位置显示新闻内容。
当然，这里只是简单的将新闻列出来了，在实际应用时你还可以把文章出处，发表时间，作者，相关新闻一起列出来，这里就不作多的讨论了.
三、程序部分：
1. 大家先来看看index.php的源文件，然后我们再来慢慢分析它的作用：
=============================================================
index.php
=============================================================
<?php
1. /*********************************************
*
* 文件名： index.php
* 作 用： 显示实例程序
*
*********************************************/
2. include_once("./comm/Smarty.class.php"); //包含smarty类文件
3. define("NUM", 5); //定义每次显示的新闻条数
4. $smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->templates_dir = "./templates"; //设置模板目录
$smarty->compile_dir = "./templates_c"; //设置编译目录
$smarty->cache_dir = "./cache"; //设置缓存目录
$smarty->cache_lifetime = 60 * 60 * 24; //设置缓存时间
$smarty->caching = false; //这里是调试时设为false,发布时请使用true
$smarty->left_delimiter = "<{"; //设置左边界符
$smarty->right_delimiter = "}>"; //设置右边界符
5. $db = mysql_connect("localhost", "root", "");
mysql_select_db("News", $db);
//这里将处理国内新闻部分
6. $strQuery = "Select iNewsID, iNewsTitle FROM tb_news_CH orDER BY iNewsID DESC";
$result = mysql_query($strQuery);
$i = NUM;
7. while(($row = mysql_fetch_array($result)) && $i > 0)
{
$array[] = array("NewsID", substr($row["iNewsID"], 0, 40),
"NewsTitle", substr($row["vcNewsTitle"], 0, 40));
$i--;
}
8. $smarty->assign("News_CH", $array);
9. unset($array);
mysql_free_result();
10. //这里处理国际新闻部分
$strQuery = "Select iNewsID, iNewsTitle FROM tb_news_IN orDER BY iNewsID DESC";
$result = mysql_query($strQuery);
$i = NUM;
while(($row = mysql_fetch_array($result)) && $i > 0)
{
$array[] = array("NewsID", substr($row["iNewsID"], 0, 40),
"NewsTitle", substr($row["vcNewsTitle"], 0, 40));
$i--;
}
$smarty->assign("News_IN", $array);
unset($array);
mysql_free_result();
11. //这里将处理娱乐新闻部分
$strQuery = "Select iNewsID, iNewsTitle FROM tb_news_MU orDER BY iNewsID DESC";
$result = mysql_query($strQuery);
$i = NUM;
while(($row = mysql_fetch_array($result)) && $i > 0)
{
$array[] = array("NewsID", substr($row["iNewsID"], 0, 40),
"NewsTitle", substr($row["vcNewsTitle"], 0, 40));
$i--;
}
$smarty->assign("News_MU", $array);
unset($array);
mysql_free_result();
mysql_close($db);
//编译并显示位于./templates下的index.tpl模板
12. $smarty->display("index.tpl");
?>
为了方便说明，我把每一个要说明的地方都标了号，下面就来说说每一个部分的作用：
1. 程序注释, 风格问题,我多次在程序中加这个就是为了让读者也养成这种习惯.
2. 文件包含. 这一句意思是把Smarty的类文件包含到当前程序文件中.
3. 常数定义: 定义NUM为5,为新闻显示条数
4. 设置Smarty参数: 关于里边的参数大家可以参考上一节讲过的,这里只想特别说明一下$smarty->cache属性,在我们的程序调试过程中,要把它设置为false,正式发布的时候将它设计为true就可以实现我们的程序缓存效果.
5. 数据库连接: 这一部分我不用说吧?标准的PHP语句.
6. 进行国内新闻查找SQL语句: 标准的SQL语句,按新题编号降序排序.
7. while():
这一句控制将要显示的新闻行数.首先给$i赋值为NUM,NUM为我们在开始外定义的一个常量, 在while()的开始判断处使用$i>0 这个条件,while()每次循环时要将$i的值减1,这样,当它完成5次循环时while就会结束.
这里我们主要来看看$array[]这个数组:
$array[]在理论上为一个二维数组,也就是一个数组中的元素为另一个数组,像上例中,当while()语句结束时,$array就是一个包含5个数组元素的数组,而每一元素又是一个字符索引的数组.而这些字符索引正是在模板中定义section循环块的$news[loop]的属性值,大家一定要注意这里要与模板循环块的属性值相对应,否则将不能显示出来!
在构建这个二维数组时我们使用了一个substr()方法进行字符截取,这个方法在这里仅供参考,实际使用当中因为中文为全角字符,使用它时可能会造成乱码,在以后的例子中我们将使用另一个网友与的csubstr()函数来实现字符截取功能.
8. 对模板中的loop = $News_CH的section循环块进行解析.
大家要注意,使用$smarty->assign(“News_CH”, $array),assign的第一个参数为section中的loop的值, 第二个参数为上面所建立的数组.
9. 注销$array: $array[]在使用完后要注销,因为使用赋值语句对$array进行赋值时不会将它清空,而是将新数组作为它的一个元素增加,为了不产生副作用,这里使用unset()是必需的.
10. 国际新闻处理模块:
同国内新闻处理模块一样,大家可以对比一下模板与这一段,找找其中有什么关联之处.
11. 娱乐新闻处理模块:同上,大家找找其中的关系.相信大家看完会有收获的.
12. 处理并显示index.tpl.
2. 下面再来看看news.php的源文件:
========================================================
news.php
========================================================
<?php
/*********************************************
*
* 文件名： news.php
* 作 用： 新闻显示程序
*
*********************************************/
include_once("./comm/Smarty.class.php"); //包含smarty类文件
define("NUM", 5); //定义每次显示的新闻条数
$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->templates_dir = "./templates"; //设置模板目录
$smarty->compile_dir = "./templates_c"; //设置编译目录
$smarty->cache_dir = "./cache"; //设置缓存目录
$smarty->cache_lifetime = 60 * 60 * 24; //设置缓存时间
$smarty->caching = false; //这里是调试时设为false,发布时请使用true
$smarty->left_delimiter = "<{"; //设置左边界符
$smarty->right_delimiter = "}>"; //设置右边界符
$db = mysql_connect("localhost", "root", "") or die("数据库连接错误!");
mysql_select_db("News", $db);
$NewsID = $_GET["id"]; //获取新闻编号
$NewsType = $_GET["type"]; //要显示的新闻类型
switch($NewsType)
{
case 1:
$dbName = "tb_news_ch";
break;
case 2:
$dbName = "tb_news_in";
break;
case 3:
$dbName = "tb_news_mu";
break;
}
$strQuery = "Select vcNewsTitle, ltNewsContent FROM " . $dbName;
$result = mysql_query($strQuery) or die("数据库查询错误!");
if($row = mysql_fetch_array($result))
{
$smarty->assign("NewsTitle", $row["vcNewsTitle"]);
$smarty->assign("NewsContent", $row["ltNewsContent"]);
mysql_free_result($result);
$smarty->display("news.tpl");
}
mysql_close($db);
?>
这上面关于Smarty的程序语句主要只有3行:
==================================================================
$smarty->assign(“NewsTitle”, $row[“vcNewsTitle”]);
$smarty->assign(“NewsContent”, $row[“ltNewsContent”]);
mysql_free_result($result);
==================================================================
很简单的将新闻页中的NewsTitle, NewsContent替换成从数据库中查找出来的内容.
好了,关于这一讲的Smarty例程学习的初级部分就讲到这里,相信大家学完后会对Smarty的用法有个基本的了解,下一节还使用个这个例子来讲讲如何使用phplib中的DB类来实现对模板的控制.
=========================================================================================
Smarty实例教程 实例篇（二、使用phplib的DB类）
为什么要拿phplib中的DB类来讲呢？很多人在学习PHP时，可能最先接触到的模板就是phplib了，原因很简单：很多PHP学习资料中都介绍PHPLIB，phplib在PHP3的时候很火，原因之一就是它实现了在PHP3没有实现的session功能，直到现在还有很多人使用phplib的模板技术，原因就是它很简单。同时，phplib上的数据库操作类也以文件小、加载速度快而备受人们喜爱
。我喜欢它的语法，感觉很接近于PHP中的mysql语句。好了，废话不多说了，来看我们的程序。程序还以实例一中的那个站点一讲，关于数据库的建立与模板的建立这里就不多讲了，请参看上一节的介绍，这里主要来介绍一下在程序中新加入的东西。先来看目录表：
+Web (站点根目录)
|
|—-+comm (Smarty相关文档目录)
| |
| |—-+plugins (Smarty插件目录)
| |—–Config_File.class.php (Smarty配置文件)
| |—–Smarty.class.php (Smarty类主文件)
| |—–Smarty_Compiler.class.php (Smarty编译类文件)
| |—–db_mysql.inc.php (phplib中的DB类)
| |—–csub.inc.php (一个截取中文的函数)
|
|—-+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 (本文档)
这里主要在/comm/目录多出两个文件，一个是db_mysql.inc.php,在phplib中它的文件名叫db_mysql.inc,inc文件在默认情况下直接从浏览器中定位时会显示在浏览器中，所以为了安全我们将它的扩展名改为db_mysql.inc.php; 第二个文件是一个包含截取中文字符的一个函数
csubstr(),在用的时候我们将它的源码显示出来。
这里先将db_mysql.inc.php中定义的DB_Sql的主要成员变量与成员函数给大家简单介绍一下：
一、成员变量：
1. $Host: 主机名
2. $Database: 数据库名称
3. $User:用户名
4. $Password:密码
二、成员函数：
1. connect($Database=””, $Host=””, $User=””, $Password=””): 建立连接，返回连接ID
2. query($Query_String):进行查询，返回查询ID
3. free(): 释放当前查询ID资源
4. next_record(): 返回下一条返回集
5. num_rows(): 当前查询号中的数据行数
6. f($name): 当前字段的值
其它的函数在我们的程序中基本用不到，所以就不介绍了，感兴趣的读者可以自己查看相关资料。
PHP代码:——————————————————————————–
templates中的index.tpl与news.tpl与上一节的相当，不同的只是在index.php与news.tpl中，先来看看index.php:
===============================
index.php
===============================
<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 显示实例程序
*
*********************************************/
include_once("./comm/Smarty.class.php"); //包含smarty类文件
1. //=======================================
include_once("./comm/db_mysql.inc.php"); //包含数据库操作类
include_once("./comm/csubstr.inc"); //包含中文截取类
//=======================================
define("NUM", 5); //定义每次显示的新闻条数
$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->templates_dir = "./templates"; //设置模板目录
$smarty->compile_dir ="./templates_c"; //设置编译目录
$smarty->cache_dir = "./cache"; //设置缓存目录
$smarty->caching = false; //这里是调试时设为false,发布时请使用true
$smarty->left_delimiter = "<{"; //设置左边界符
$smarty->right_delimiter = "}>"; //设置右边界符
2. $db = new DB_Sql(); //实例化一个DB类
$db->Host = "localhost"; // 数据库主机名
$db->Database = "news"; //数据库名称
$db->User = "root"; //用户名
$db->Password = ""; //密码
$db->connet(); //进行数据库连接
//这里将处理国内新闻部分
$strQuery = "Select iNewsID, iNewsTitle FROM tb_news_CH orDER BY iNewsID DESC";
3. $db->query($strQuery);
$i = NUM;
4. while($db->next_record() && $i > 0)
{
5. $array[] = array("NewsID", csubstr($db->f("iNewsID"), 0, 20),
"NewsTitle", csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
$smarty->assign("News_CH", $array);
unset($array);
6. $db->free();
//这里处理国际新闻部分
$strQuery = "Select iNewsID, iNewsTitle FROM tb_news_IN orDER BY iNewsID DESC";
$db->query($strQuery);
$i = NUM;
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID", csubstr($db->f("iNewsID"), 0, 20),
"NewsTitle", csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
$smarty->assign("News_IN", $array);
unset($array);
$db->free();
//这里将处理娱乐新闻部分
$strQuery = "Select iNewsID, iNewsTitle FROM tb_news_MU orDER BY iNewsID DESC";
$db->query($strQuery);
$i = NUM;
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID", csubstr($db->f("iNewsID"), 0, 20),
"NewsTitle", csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
$smarty->assign("News_MU", $array);
unset($array);
$db->free();
//编译并显示位于./templates下的index.tpl模板
$smarty->display("index.tpl");
?>
老规矩，对于关键的地方我加了标号，来看这些地方：
1. 这里是将DB_Sql类文件包含进来，下面一行是将一个中文截取类包含到当前页
2. 实例化一个类，并设置类的Host, Database, User, Password属性, 最后connect数据库
3. 调用$db->query($strQuery)进行一次数据查询
4. $db->next_record()读取数据库查询返回值的下一行（注：调用query()返回数据集的第一条记录的前一个记录）
5. csubstr()是我们使用的一个中文截取类，类的源文件如下：
=====================================================
csubstr.inc.php
=====================================================
6.$db->free(): 释放当前的查询返回资源
好了，使用类进行数据库操作，可以极大程序上提高程序的可读性，同时也方便了对数据库的操作。
接下来我们再看看news.php:
=================================================
news.php
=================================================
<?php
/*********************************************
*
* 文件名： news.php
* 作 用： 新闻显示程序
*
*********************************************/
include_once("./comm/Smarty.class.php"); //包含smarty类文件
//=======================================
include_once("./comm/db_mysql.inc.php"); //包含数据库操作类
include_once("./comm/csubstr.inc"); //包含中文截取类
//=======================================
define("NUM", 5); //定义每次显示的新闻条数
$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->templates_dir = "./templates"; //设置模板目录
$smarty->compile_dir ="./templates_c"; //设置编译目录
$smarty->cache_dir = "./cache"; //设置缓存目录
$smarty->cache_lifetime = 60 * 60 * 24; //设置缓存时间
$smarty->caching = false; //这里是调试时设为false,发布时请使用true
$smarty->left_delimiter = "<{"; //设置左边界符
$smarty->right_delimiter = "}>"; //设置右边界符
$db = new DB_Sql(); //实例化一个DB类
$db->Host = "localhost"; // 数据库主机名
$db->Database = "news"; //数据库名称
$db->User = "root"; //用户名
$db->Password = ""; //密码
$db->connet(); //进行数据库连接
$NewsID = $_GET["id"]; //获取新闻编号
$NewsType = $_GET["type"]; //要显示的新闻类型
switch($NewsType)
{
case 1:
$dbName = "tb_news_ch";
break;
case 2:
$dbName = "tb_news_in";
break;
case 3:
$dbName = "tb_news_mu";
break;
}
$strQuery = "Select vcNewsTitle, ltNewsContent FROM " . $dbName;
1. $db->query($strQuery);
2. if($db->next_record())
{
$smarty->assign("NewsTitle", $db->f("vcNewsTitle"));
$smarty->assign("NewsContent", $db->f("ltNewsContent"));
$db->free();
$smarty->display("news.tpl");
}else
{
echo "没有新闻内容";
}
?>
大家可以看看1, 2两处，是不是比原来直接使用mysql函数要简单一些？
多余的话就不多说了，如果大家认真的看过上一篇实例，那么这一篇应该非常好理解的。
======================
后记:
模板部分我基本是以手册中的例子来讲的,把它具体化了一些,实际的精华在程序设计部分,要学它的话要看两个例程序,我把两个例程及先前提到的那些示例程序放入3个打包文件中,由 “神仙姐姐” 测试过,大家可以边看边调试.
=========================================================================================
Smarty实例教学 实例篇（三、使用ADODB连接数据库）
前两个月因为工作上的原因一直很忙,所以没有及时完成这个教程,正好今天周六不用加班,抽个空完成它吧! 在开始新的的教程的时候,我
先把以前的我写的那个教程中的一些错误的地方修改过来,在这里要感谢 nesta2001zhang兄弟,是他找出了文章中的一些错误,否则真的被别人
骂”误人子弟了”(说来真是惭愧,我的初稿发布后后就发现在一大堆的问题,后来一些时候发重新修改后的文件中居然也出现了错误,真是不应
该…)
在上几篇教程中的：
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID", csubstr($db->f("iNewsID"), 0, 20),
"NewsTitle", csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
应该更改为：
while($db->next_record() && $i > 0)
{
$array[] = array("NewsID" => $db->f("iNewsID"),
"NewsTitle" => csubstr($db->f("vcNewsTitle"), 0, 20));
$i--;
}
为什么这样改呢?因为第二种方法更清晰明了一些,实际上第一种方式所执行的效果与第二种方法没什么差别,而且那几个程序我都曾经调试过,
没有任何问题.
好了,那我们今天就先来说说ADODB.说到ADODB,可能做过ASP的都知道WINDOWS平台的ADO组件,但我们这里的ADODB不是微软的那个数据库操
作组件,而是由php语言写的一套数据库操作类库,先让我们来看看它倒底有什么样的优点.
1. 以标准的SQL语句书写的数据库执行代码在进行数据库移植时不用更改源程序,也就是说它可以支持多种数据库,包括ACCESS.
2. 提供与微软ADODB相似的语法功能.这一点对于从ASP转行到PHP的人们是一大福音,它的很多操作都与WINDOWS中的ADODB相似.
3. 可以生成Smarty循环需要的二维数组,这样会简化smarty开发.这一点是等会我给大家演示.
4. 支持数据库的缓存查询，最大可能的提高查询数据库的速度。
5. 其它的实用功能.
虽然说优点很多,但是由于这个类库非常的庞大,光它的主执行类就107K,所以如果大家考虑执行效率的话就要认真想想了.不过说实话,它的
功能还是很强大的,有很多的很实用的功能,使用它的这些功能,可以非常方便的实现我们想要的功能.所以对于那些老板没有特殊要求时大家不
防用用它
一、如何得到ADODB? 它的运行环境是什么？
从http://sourceforge.net/project/show…簆hp4.0.5以上。
二、如何安装ADODB?
解压下载回的压缩文件，注意：大家下载回来的格式为ADODB.tar.gz，这是linux的压缩格式，在windows下大家可以使用winrar对其进
行解压，解压完成后将目录拷贝到指定的目录的adodb目录下，像我在例子中将它拷贝到了/comm/adodb/中。
三、如何调用ADODB?
使用include_once (“./comm/adodb/adodb.inc.php”);这行就不用说了吧？包含ADODB的主文件。
四、如何使用ADODB?
1.进行初始化：
ADODB采用$conn = ADONewConnection();这样的语句进行初始化,对ADODB进行初始化有两种方式：
第一种方式为：传统方式。我暂时称它为这个名称。它使用的建立一个新连接的方式很像php中的标准连接方式：
$conn = new ADONewConnection($dbDriver);
$conn->Connect($host, $user, $passwd, $db);
简单吧？如果使用过phplib中的db类应该对它很熟悉的。
第二种方式：采用dsn方式，这样是将数据库的连接语句写成一条语句来进行初始化，dsn的写法有为：$dsn =
“DBType://User:Passwd@Host/DBName”; 其中DBType表示数据库类型，User表示用户名，Passwd为密码，Host为服务器名，DBName为数据库名
，像这样我使用oracle数据库，用户名：oracleUser,密码为oraclePasswd,数据库服务器为localhost, 数据库为oradb的dsn这样写：
$dsn = “oracle://oracleUserraclePasswd@localhost/oradb”;
$conn = new ADONewConnection($dsn);
这种方式可能从ASP转行来的程序员会更感兴趣。
这两种方式都可以使用，要看个人习惯来选用了.
2. 相关的概念：
使用ADODB有两个基本的类，一是是ADOConnection类，另一个是ADORecordSet类，使用过ASP的人看到这两个类会明白它的含义，
ADOConnection指的是数据库连接的类，而ADORecordSet指的是由ADOConnection执行查询语句返回的数据集类，相关的资料大家可以查询ADODB
类的手册。
3.基本的函数：
关于ADOConnection类的相关方法有：
1.Connect：数据库连接方法，上边我们介绍过的。对于mysql还有PConnect，与PHP语言中的用法一样
2.Execute($sql):执行查询语句结果返回一个ADORecordSet类。
3.GetOne($sql):返回第一行的第一个字段
4.GetAll($sql):返回所有的数据。这个函数可是大有用处，记得不记的我在以前的教程中写关于新闻列表的输入时要将需要在页面显示的
新闻列表做成一个二维数组？就是这样的语句：
=====================================================================================
while($db->next_record())
{
$array[] = array(“NewsID” => $db->f(“iNewsID”),
“NewsTitle” => csubstr($db->f(“vcNewsTitle”), 0, 20));
}
=====================================================================================
这一行是什么意思呢？就是将要显示的新闻例表生成
$array[0] = array(“NewsID”=>1, “NewsTitle”=>”这里新闻的第一条”);
$array[1] = array(“NewsID”=>2, “NewsTitle”=>”这里新闻的第二条”);
…
这样的形式，但如果我们不需要对标题进行控制，在ADODB中我们就有福了，我们可以这样写：
==================================================================================
$strQuery = “select iNews, vcNewsTitle from tb_news_ch”;
$array = &$conn->GetAll($strQuery);//注意这条语句
$smarty->assign(“News_CH”, $array);
unset($array);
==================================================================================
当然，这里的$conn应该进行初始化过了，不知大家看明白了没有？原来我要手工创建的二维数据在这里直接使用GetAll就行了！！！这也是为
什么有人会说ADODB+Smarty是无敌组合的原因之一了…
4.SelectLimit($sql, $numrows=-1, $offset=-1, $inputarrr=false): 返回一个数据集，大家从语句上也不难看出它是一条限量查询语
句，与mysql语句中的limit 有异曲同工之效，来一个简单的例子：
$rs = $conn->SelectLimit(“select iNewsID, vcNewsTitle from tb_news_CH”, 5, 1);
看明白了吗？$rs中保存的是数据库中从第一记录开始的5条记录。我们知道，在oracle数据库不支持在SQL语句中使用limit，但是我们如果使
用ADODB的话，那这个问题就容易解决多了！
5.Close():关闭数据库，虽然说PHP在页面结束时会自动关闭，但为了程序的完整大家还是要在页面结束进行数据库的关闭。
关于ADORecordSet.ADORecordSet为$conn->Execute($sql)返回的结果,它的基本函数如下:
1. Fields($colname):返回字段的值.
2. RecordCount():所包含的记录数.这个记录确定数据集的记录总数.
3. GetMenu($name, [$default_str=”], [$blank1stItem=true], [$multiple_select=false], [$size=0], [$moreAttr=”])非常好的一
个函数,使用它可以返回一个name=$name的下拉菜单(或多选框)!!!当然,它是一个HTML的字符串,这是一个令人激动的好东西,$name指的是
option的name属性,$default_str是默认选中的字串,$blank1stItem指出第一项是否为空,$multiple_select指出是否为多选框,而我们得到这个
字串后就可以使用$smarty->(“TemplateVar”, “GetMenuStr”)来在模板的”TemplateVar” 处输入一个下拉列表(或是多先框)
4. MoveNext():来看一段代码:
$rs = &$conn->Exceute($sql);
if($rs)
{
while($rs->EOF)
{
$array[] = array("NewsID" => $rs->fields["iNewsID"],
"NewsTitle" => csubstr($rs->fields["vcNewsTitle"]), 0, 20);
$rs->MoveNext();
}
}
明白了吗?很像MS ADODB中的那一套嘛!
5. MoveFirst(),MoveLast(), Move($to):一样的,看函数名大家就可以知道它是什么意思了.
6. FetchRow():返回一行,看代码:
$rs = &$conn->Exceute($sql);
if($rs)
{
while($row = $rs->FetchRow())
{
$array[] = array("NewsID" => $row["iNewsID"],
"NewsTitle" => csubstr($row["vcNewsTitle"]), 0, 20);
}
}
它实现了与4一样的功能,但看起来更符合PHP的习惯,而4的习惯看起来更像是MS ADODB的办法．
7.GetArray($num):返回数据集中的$num行数据,将其组合成二维数组.这个方法我们在例子index.php要用到.
8. Close():同mysql_free_result($rs);清除内容占用.
好了,初步的函数就介绍到这里,够我们用的啦!实际上ADODB还有很多实用的技术,包括格式化日期时间,格式化查询语句,输出表格,更高级
点的Cache查询,带参查询等等,大家可以自行查看手册.
下面我们开始学习我们的程序,同样还是那个Web程序,我将其中的comm目录重新组织了一下,同时为了提高效率对Smarty重新进行了封装
,mySmarty.class.php是封装后的类,它继承自Smarty,所以以后所有的程序文件中只调用新的类MySmarty,先来看看目录结构:
+Web (站点根目录)
|
|—-+comm (Smarty相关文档目录)
| |
| |—-+smarty (Smarty原始文件目录)
| |—-+adodb (adodb原始文目录)
| |—–mySmarty.class.php (扩展后的smarty文件)
| |—–csubstr.inc (截取中文字符)
|
|—-+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新闻显示文件)
|
|—-newsList.php (显示新闻列表)
|
|—-例程说明.txt (本文档)
相对于前两个教程,有将comm目录重新组织了一下,其它的文件结构没有变化,整个站点相对于上两个教程来讲,改变的地方只有comm目录与
index.php与news.php,同时增加了新闻列表,大家可以在index.php执行后的页面中点击”国内新闻”,”国际新闻”, “娱乐新闻”来分别查看各自的
新闻列表, 我们先来看看index.php:
======================================================
index.php
======================================================
<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 显示实例程序
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的扩展类文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主执行文件
include_once("./comm/csubstr.inc"); //包含中文截取类
define ("NEWS_NUM", 5); //定义新闻列表显示数目
$smarty = new MySmarty(); //建立smarty实例对象$smarty
1. $conn = ADONewConnection("mysql"); //初始化ADODB
2. $conn->Connect("localhost", "root", "", "News"); //连接数据库
//这里将处理国内新闻部分
3. $strQuery = "Select iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM tb_news_CH orDER BY iNewsID DESC";
4. $rs = &$conn->Execute($strQuery);
5. $smarty->assign("News_CH", $rs->GetArray(NEWS_NUM));
6. unset($rs);
//这里处理国际新闻部分
$strQuery = "Select iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM tb_news_IN orDER BY iNewsID DESC";
$rs = &$conn->Execute($strQuery);
$smarty->assign("News_IN", $rs->GetArray(NEWS_NUM));
unset($rs);
//这里将处理娱乐新闻部分
$strQuery = "Select iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM tb_news_MU orDER BY iNewsID DESC";
$rs = &$conn->Execute($strQuery);
$smarty->assign("News_MU", $rs->GetArray(NEWS_NUM));
unset($rs);
7. $conn->close();
//编译并显示位于./templates下的index.tpl模板
$smarty->display("index.tpl");
?>
同样,我在关键的地方加了数标,下面来说明一下它们的含义:
1. 建立一个连接对象$conn,大家在这里要注意的是它的初始不是以$conn = new ADONewConnection($dbType)这样的形式出现的,也就是说
,ADONewConnection不是一个class,你不能使用new 对它进行初始化.看看它的源码你就会明白,这只不过是一个函数.
2. 这个就不用说了吧?打开一个News的数据库,主机为:localhost, 用户名为root, 密码为””
3. 一个查询语句,注意,这里要将查询的字段使用AS关键字来重新标识,名称为你在模板中设置的模板变量的名称.
4. 使用Execute来执行这个查询,结果返回一个RecordSet数据集
5. 这里有个方法:$rs->GetArray($num) 这个在上边介绍过,它是要从$rs这个数据集中返回$num行,结果为一个可被Smarty所识别的二维数
据.这样ADODB就自动为我们构建起了这样的结构,而在我们以前的例子中,都是使用一个循环构建这样的数组的.
6. 这一句我看也不用说了吧?
7. 关闭内存中的相关资源.
大家可以看看,整个程序中再没有出现什么while语句,程序整体结构显的非常清楚,这就是为什么ADODB+Smarty是黄金组合的原因.不过话也
说回来了,简单有简单的问题,不知大家想过没有,这里对显示的新闻标题的长度没有控制,也就是说,如果某条新闻标题的长度超出一行显示的范
围,它就是自动折行到下一行,那么整个的版面就会变乱,所说大家自已适自己的情况来决定是否这样使用吧当然,你也可以使用像上一节中介
绍的那样,使用一个循环语句重构这个二维数组,使它符合你的用途,怎么做大家自己去想吧,参考PHPLIB中的做法,上节我介绍过了…
再来看看新闻页吧
=============================================================
news.php
=============================================================
<?php
/*********************************************
*
* 文件名： news.php
* 作 用： 新闻显示程序
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的扩展类文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主执行文件
$smarty = new MySmarty(); //建立smarty实例对象$smarty
$conn = ADONewConnection("mysql"); //初始化ADODB
$conn->Connect("localhost", "root", "", "News"); //连接数据库
$NewsID = $_GET["id"]; //获取新闻编号
$NewsType = $_GET["type"]; //要显示的新闻类型
switch($NewsType)
{
case 1:
$dbName = "tb_news_CH";
break;
case 2:
$dbName = "tb_news_IN";
break;
case 3:
$dbName = "tb_news_MU";
break;
}
$strQuery = "Select vcNewsTitle AS NewsTitle, ltNewsContent AS NewsContent FROM " . $dbName;
1. $row = &$conn->GetRow($strQuery); //返回一个一维数组,下标为模板变量名
$smarty->display($row);
unset($row);
$conn->Close();
?>
说明一下关键的地方,其实在news.php中也只有一个地方值的说明一下了.
1. $conn->GetRow($strQuery):这一句返回一个一维数组,返回的形式为:
$array = (“NewsTitle”=>”xxxx”, “NewsContent”=>”yyyyy…”)
明白如果使用$smarty($array)后Smarty会干什么吗?对了,就是相当于:
$smarty->assign(“NewsTitle”, “xxxx”);
$smarty->assign(“NewsContent”, “yyyyy…”);
简单吧,确实很简单
下面再来看看新闻列表:
================================================================
newsList.php
================================================================
<?php
/*********************************************
*
* 文件名： newsList.php
* 作 用： 新闻列表显示程序
*
*********************************************/
include_once("./comm/mySmarty.class.php"); //包含smarty的扩展类文件
include_once("./comm/adodb/adodb.inc.php"); //包含ADODB主执行文件
$smarty = new MySmarty(); //建立smarty实例对象$smarty
$conn = ADONewConnection("mysql"); //初始化ADODB
$conn->Connect("localhost", "root", "", "News"); //连接数据库
$NewsID = $_GET["id"]; //获取新闻编号
$NewsType = $_GET["type"]; //要显示的新闻类型
switch($NewsType)
{
case 1:
$tbName = "tb_news_CH";
break;
case 2:
$tbName = "tb_news_IN";
break;
case 3:
$tbName = "tb_news_MU";
break;
}
$strQuery = "Select iNewsID AS NewsID, vcNewsTitle AS NewsTitle FROM " . $tbName;
1. $rs = &$conn->GetAll($strQuery);
2. $smarty->assign("NewsType", $NewsType); //这一句为新闻列表中的链接服务
3. $smarty->assign("NewsList", $rs);
unset($rs);
$conn->close();
$smarty->display("newsList.tpl");
?>
分别来说明一下:
1. GetAll($strQuery):这个函数可是个好东东,它的作用是将$strQuery查询到的所有数据组合成为一个能够被Smarty所识别的二维数组,
记住:它返回的是一个二维数组而不是一个RecordSet,所在你可以程序中直接在3处使用.
2. 这里是为了给新闻标题做链接时要GET参数type=XX而做的
后记:
大家在使用ADODB时有几个地方要注意:
1. 初始化: 初始化的方式不是使用new,因为它不是一个对象
2. 方 法: 基本上每个方法都是以大写字母开头大小写混合的名称,这一点好像与*NIX的习惯有些不同,也不同于PHP的整体风格,所以
注意这里的大小写问题.
好了,这个Smarty的系列教程到这里就基本已经完成了
