PHP + Smarty构建Wap应用

一 简介
    Smarty是一个PHP编写的模板引擎(template engine)，主要用于构建web应用程序的表示层。Smarty的主页是http://smarty.php.net, 目前的新版本是2.6.18。Smarty主页上有详细的开发文档，包括在线阅读版本和可供下载的pdf版本，以及一个guestbook的样例程序，为我们开发人员学习smarty提供了极大的方便。
    使用smart编写的模板将被smarty编译成php代码，由于编译过程只在模板文件被修改后发生一次，所以使用smarty模板引擎编写的php代码运行速度几乎没有什么损失。
    我曾使用smarty库做Web应用开发，最近发现，smarty库也可以用于构建Wap应用。原理上与Web开发是一样的。本文将利用php+smarty创建一个简单的wap页面，以介绍用php+smarty构建Wap应用的一般方法。

 二 下载安装
1.php
    php的安装过程可以参考：http://www.php.net/manual/en/install.php，本文不再详细叙述。
2.smarty
    首先，下载最新版本的smarty：http://smarty.php.net/do_download.php?download_file=Smarty-2.6.18.tar.gz
    下载后，找到压缩包内的libs目录，将该目录解缩到apache的document root下。
    libs目录下对于开发最重要的文件是Smarty.class.php，其中定义了Smarty类。我们将通过继承这个类来配置自己的模板引擎。

三 配置smarty

1. 配置

    Smarty的配置是通过继承Smarty类并改写其中的成员变量来完成。

    在document root目录下创建mySmarty.class.php文件，输入以下代码：

 

<?php        require_once("libs/Smarty.class.php");        class MySmarty extends Smarty        {               function MySmarty()               {                      $this->Smarty();                      $this->template_dir = 'template';                      $this->compile_dir = 'compile';               }        }               $smarty = new MySmarty(); ?>

    下面我们来解释上述配置的含义：

    template_dir指定模板文件存放的位置。模板文件一般以.tpl作为后缀。使用smarty的display方法显示模板时，smarty会到这个目录中查找指定的模板。

    compile_dir:每一个模板都会被smarty编译，编译生成的php代码存放在compile_dir中，需要注意的是，如果在Liunx系统上，要确保php对这一目录具有写权限。

    最后一行创建了一个MySmarty对象，这样我们的php代码中只要包含mySmarty.class.php就可以通过$smarty对象操作smarty了。

2.创建相应的目录

    在document root下创建相应的template和compile目录。

    目录结构如下所示：

www

|-----libs

|-----template

|-----compile

|-----mySmarty.class.php

四 创建wml文件的tpl模板

创建如下的模板：index.tpl

<?xml version="1.0"?> <!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN" "http://www.wapforum.org/DTD/wml_1.1.xml"> <wml>        <card title="WAP with smarty">               <p>                      {$welcome_message}               </p>               <p>                      <table columns="1">                      {foreach from=$message_list item=message}                      <tr><td>{$message}</td></tr>                      {/foreach}                      </table>               </p> </card> </wml>

 

    Smarty模板的结构与一般的XHTML文件非常类似，但是在其中加入了smarty的标签。默认情况下，smarty标签包含在{}里。

    如{$welcome_message}表示此处以smarty变量$welcome_message的值代替。

    {foreach}标签相当于一个循环语句，在构造表格这类元素时相当的有用。如上述代码表示遍历message_list数组，数组中的每一元素命名为message，表格中每一行显示message_list中的一个元素。

    详细的标签列表请参见smarty的开发文档。

    由于wml是严格的xml文档，在编写模板时一定要注意符合xml文档的格式。

五 编写php代码

编写如下的php代码index.php

<?php        require_once("mySmarty.class.php");        header("Content-type: text/vnd.wap.wml");        $smarty->assign("welcome_message", "Welcome smarty!");        $list[0] = "Message 1";        $list[1] = "Message 2";        $list[2] = "Message 3";        $smarty->assign("message_list", $list);        $smarty->display("index.tpl"); ?>

    上述代码中，header("Content-type: text/vnd.wap.wml") 一行非常重要，它告诉浏览器这是一个wml文档。assign方法为模板变量赋值。我们看到，模板变量可以是字符串，也可以是数组，事实上，任意类型的php变量都可以赋值给模板。

    最后的display方法显示index.tpl模板，模板中的变量将被我们赋于的实际值取代。再次提醒一下的是，smarty将会到template目录中查找index.tpl文件，所以模板文件一定要保存在template目录中。

    以下是使用Openwave仿问示例程序的效果：