smarty实例教程五

在使用的时候,你可以往每个数据表中输入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"}>
=================================================
不用说大家都明白了，就是包含一个页脚文件。

再看看国内新闻部分的模板代码：

=================================================
         

          
             
             
           
         

<{section name=loop loop=$News_CH}>               <{$News_CH[loop].NewsTitle}>             <{/section}>

     =================================================

 

大家关键看<{section}>与<{/section}>,它们之外的那一部分是为了更好的理解代码的意思而列出来的。能看明白吗？这里将以前讲过的内容复习一遍：定义了一个section循环模板块，名字叫loop, 要循环的是$News_CH这个数组，以处将为当前的新闻产生一个链接，地址为news.php?type=1&id=xxx,这里的xxx是从数据库里提取的iNewsID,指的是要在新闻显示页里显示编号为id的新闻。$News_CH[loop].NewsTitle这种表示形式来看的懂吧？看不懂的话看看上一节讲过的《Smarty实例教学 ---程序设计》部分中的<{section}>语法。
也许大家对<{}>感觉有点陌生，这里的<{}>为模板语句定义块，在前2节我们都使用{}，但因为这里是具体的应用，所以就不取{}了，使用大家习惯的<{}>来表示，当然这在.php文件中要设置的。

再看国际新闻与娱乐新闻的代码：

国际新闻：
     ================================================
            

                         
                           
                         
                       

                              <{section name=loop loop=$News_IN}>
               

<{$News_IN[loop].NewsTitle}>                             
                  <{/section}>
               

     ================================================

     娱乐新闻：
     ================================================
                       

                         
                           
                         
                       

                 <{section name=loop loop=$News_MU}>
                             

<{$News_MU[loop].NewsTitle}>
                 <{/section}>
                           

     ================================================

有没有看出有什么不同? loop部分不同，loop指的是要循环的数组，这里要注意的，不可将多个section的loop指定为同一个值，那样的话Smarty进行分析模板的时候就会将两个具有相同名字的section同时分析，生成两个一样的记录。

看到这里，有人就会产生疑问：循环块我已经有了，我怎么才能就它在当前位置只显示我们想要的记录数呢？这个问题简单，我们对Smarty的section循环块的循环次数控制是在.php文件中控制要替换这个循环块的数组来决定的，在设计模板时我们不用考虑。

其次，我们再来看看news.tpl:

1. 看这一句：

将要显示的新闻页的标题显示为新闻标题 + "----天骄信息网"
2. 新闻标题：

<{$NewsTitle}>

这里又设置了一个模板变量$NewsTitle,意思说要.php将$NewsTitle(包括标题栏)替换为数据库中当前新闻的标题。
3. 新闻内容：

<{$NewsContext}>

这一句也容易，在当前位置显示新闻内容。

当然，这里只是简单的将新闻列出来了，在实际应用时你还可以把文章出处，发表时间，作者，相关新闻一起列出来，这里就不作多的讨论了.

三、程序部分：

1. 大家先来看看index.php的源文件，然后我们再来慢慢分析它的作用：

     =============================================================
     index.php
     =============================================================
       1.  /*********************************************
       *
       * 文件名： index.php
       * 作  用： 显示实例程序
       *
       * 作  者： 大师兄
       * Email： 
       *
       *********************************************/
  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
     ========================================================
        /*********************************************
     *
     * 文件名： news.php
     * 作  用： 新闻显示程序
     *
     * 作  者： 大师兄
     * Email： 
     *
     *********************************************/
     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
===============================
     /*********************************************
      *
      * 文件名： index.php
      * 作  用： 显示实例程序
      *
      * 作  者： 大师兄
      * Email： 
      *
      *********************************************/
     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
   =================================================

以下为引用的内容：
       /*********************************************
      *
      * 文件名： news.php
      * 作  用： 新闻显示程序
      *
      * 作  者： 大师兄
      * Email： 
      *
      *********************************************/
      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 "没有新闻内容";
          }
     
   ?>

 

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,所以如果大家考虑执行效率的话就要认真想想了.不过说实话,它的功能还是很强大的,有很多的很实用的功能,使用它的这些功能,可以非常方便的实现我们想要的功能.所以对于那些老板没有特殊要求时大家不妨用用它