smarty入门教程六[使用phplib的DB类]

教程之四：---实例篇(使用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:[Copy to clipboard]
/*********************************************
*
* 文件名： index.php
* 作 用： 显示实例程序
*
* 作 者： 大师兄
* Email： [email][email protected][/email]

* 修 正： forest
*********************************************/
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, vcNewsTitle 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, vcNewsTitle 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, vcNewsTitle 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:[Copy to clipboard]
/*********************************************
*
* 文件名： news.php
* 作 用： 新闻显示程序
*
* 作 者： 大师兄
* Email： [email][email protected][/email]

* 修 正： forest
*********************************************/
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个打包文件中,由 “神仙姐姐” 测试过,大家可以边看边调试.