### 实例学习 PHP 之 FastTemplate 模板篇

如果你从来没有接触过 PHP,那么还是先看看这个吧，当然即使是你已经对 PHP 有所了解，但一本 PHP4 的的使用手册也还是需要的，：）。此外一本 HTML 语法手册当然也是不可缺少的啦。。。。。。。。。。
在网站开发过程中你是不是经常面对改版的苦恼？几百几千个文件因为版式上的一点小变化就需要全部重新处理，是不是让你头痛无比？唉，如果能够把内容和表现形式分开就好了，这可是我们一直翘首等待的。但可惜用于处理这个问题的 XML 还未完全的成熟。难道除此之外就没有办法了吗？正所谓东西是死的，人却是活的，我们今天要学习的这个 php 库，就可以帮助我们在一定程度上处理这个问题。：））
FastTemplate 是什么？从 PHP 语言上来讲它是一个 PHP 库；从它的起源来说它源于一个同样名称的 Perl 软件包；从用途上来讲是一个可以让你在几秒内改变整个站点外观的实用工具。用最通俗的语言来说，它就是一个模板，一个类似 DreamWaver 中的模板。现在 FastTemplate 在你心里是一个问号？还是一个感叹号？又或是一个句号？（编辑：靠，在这骗稿费呀，我扁!）算了，不管那么多，你只要知道他是好东西就成，：）
首先在我们使用这个库以前当然要先下载它（编辑：'废话，又骗稿费啊' 。地藏：'好吧，好吧，我不说了。：（ '。），大家可以在下面这个网址 http://www.thewebmasters.net/php/下载它。下载之后呢把它解压缩到你的 web 服务器的一个目录上，下面是解压缩后的目录结构
FastTemplate-1.1.0/
FastTemplate-1.1.0/README < - 这个文件就不用说了吧？
FastTemplate-1.1.0/class.FastTemplate.php3 < - 这个文件最重要，它就库文件，核心耶！
FastTemplate-1.1.0/example_1.phtml < - 一个例子
FastTemplate-1.1.0/example_2.phtml < - 第二个例子
FastTemplate-1.1.0/example_3.phtml < - 第三个例子
FastTemplate-1.1.0/dynamic_example.phtml < - 第四个例子
FastTemplate-1.1.0/docs/ < - 文档目录
FastTemplate-1.1.0/docs/FastTemplate.3 < - Unix man page
FastTemplate-1.1.0/docs/FastTemplate.html < - HTML documentation
FastTemplate-1.1.0/templates/ < - 模板例子的目录
FastTemplate-1.1.0/templates/begin.tpl
FastTemplate-1.1.0/templates/header.tpl
FastTemplate-1.1.0/templates/main.tpl
FastTemplate-1.1.0/templates/row.tpl
FastTemplate-1.1.0/templates/test.tpl
FastTemplate-1.1.0/templates/footer.tpl
FastTemplate-1.1.0/templates/htaccess.tpl
FastTemplate-1.1.0/templates/middle.tpl
FastTemplate-1.1.0/templates/table.tpl
注意哟，这个目录一定要是 php 程序可以访问的目录哟，换句话说就是 php.ini 里那个 include 目录。然后呢，使用 php4 编程的朋友注意了，你现在还不能直接使用这个库，还需要人工做些修改！等下注意看下面。php3 的读者就不用管那么多，现在就可以试一下它带的那几个例子了，（嘿嘿，不过呢，它那些例子的后缀名全是 phtml，如果你没办法设置 web 的话。你可以尝试把后缀名改改看，应该也可以用，地藏没有试过不敢打包票。）那！接着呢，php4 的兄弟可千万要注意哟，如果不你不按下面的修改的话，这个库可是没有办法用的哟！！
--- class.FastTemplate.php3 Sun Jun 27 13:44:47 1999
+++ php4.FastTemplate.php3 Tue Jul 20 10:49:25 1999
@@ -196,8 +196,10 @@
settype($val,"string");
}
- $template = ereg_replace("{$key}","$val","$template");
- //$template = str_replace("{$key}","$val","$template");
+ // php4 doesn't like '{$' combinations.
+ $key = '{'."$key".'}';
+ $template = ereg_replace("$key","$val","$template");
+ //$template = str_replace("$key","$val","$template");
}
}
@@ -410,7 +412,7 @@
}
if($end)
{
- $newParent .= "{$MacroName}
";
+ $newParent .= '{'."$MacroName}
";
}
// Next line please
if($end) { $end = false; }
大家用文本编辑器打开 class.FastTemplate.php3 文件，找到上面的部分。'-'减号代表消除这行，'+'加号代表加入这行。另外 windows 系统下的朋友注意哟！你们还需要改点小东西，把下面的那个$win32 变量的值改成 true，不改的话，用不了可别骂我，；）。
var $WIN32 = true; // Set to true if this is a WIN32 server
改好后，大家就可以试试他的那几个例子了。 如何？成功了吧。嘿嘿嘿嘿~~~，地藏不会骗大家的啦。
OK，现在这个库已经可以用啦，我们准备进行下面的学习吧，：）
如何使用这个库？简单哟，首先要把这个库包含进来。也就是说呢，要 include "class.FastTemplate.php3"; 然后？呵呵…… 然后我也不知道啦！（编辑："嘿！找扁啊，你！"）啊，啊…！Sorry，我想起来了（在地藏被众编辑海扁一顿之后）。然后是学习这个库的使用原理。在这里呢我们先做个假设。
我们假设一个页面是由很多的小的部分组成（比如：每个网站都有分栏目导航等等），而且每个小的部分都有一个唯一的标识符（比如：我们把分栏每个小项定义为一个名字）
我们首先以这个库自带的 example_1 为例，让大家可以尽快的学会这个库的基本用法，；），不过大家要注意哟，这几个文件在服务器上的位置要按解压时的相对路径来存，千万不要忘记，就象不要忘记你女朋友的生日一样。呵呵~~~~
< ?
// Example FastTemplate Demo #1 - The example from the man page
Header("Content-type: text/plain");
include("class.FastTemplate.php3");
$tpl = new FastTemplate("./templates");
$tpl- >define(
array(
main = > "main.tpl",
table = > "table.tpl",
row = > "row.tpl"
)
);
$tpl- >assign( array( TITLE = > "FastTemplate Test") );
for ($n=1; $n < = 3; $n++)
{
$Number = $n;
$BigNum = $n*10;
$tpl- >assign(
array(
NUMBER = > $Number,
BIG_NUMBER = > $BigNum
)
);
$tpl- >parse(ROWS,".row");
}
$tpl- >parse(MAIN, array("table","main"));
$tpl- >FastPrint();
exit;
? >
< !-- NAME: main.tpl -- >
< html >
< head >< title > {TITLE} < /title >
< /head >
< body >
{MAIN}
< /body >
< /html >
< !-- END: main.tpl -- >
< !-- NAME: table.tpl -- >
< table border='1' >
{ROWS}
< /table >
< !-- END: table.tpl -- >
< !-- NAME: row.tpl -- >
< tr >
< td >{NUMBER}< /td >
< td >{BIG_NUMBER}< /td >
< /tr >
< !-- END: row.tpl -- >
使用这个库首先要如前面所说的 include "class.FastTemplate.php3"; 然后是定义模板所在目录$tpl = new FastTemplate("./templates")；注意哟！这里因为我是在 windows 系统运行，所以用的是"./templates"，在 Linux 或 UNIX 中可能不一样，大家根据具体情况来设定。然后呢，我们对应不同的模板，定义下面这个矩阵数组。$tpl- >define( array( main = > "main.tpl", table = > "table.tpl", row = > "row.tpl" ) ); define 是这个类中的一个函数。下面是它的语法：define( array( key,value pairs) ) ，define（）函数映射一个名字到模板文件上，这个新的名字将是你用来代表模板的唯一名字，因为除此之外再不会有模板文件名出现。而且大家注意，这是使用类时决不能缺少的步骤，不能少的哟，如果少了那就和你不带生日礼物去你女朋友的生日 Party 有异曲同工之妙，嘿嘿嘿~~~~
现在！关键的，最有个性的东西来了！assign( (key,value pair) 或 assign ( array(key value pairs) ) 这个函数将把你在模板中定义的标识符定义为你网页上真正想要的东西。比如就象是上面$tpl- >assign( array( TITLE = > "FastTemplate Test") ); 这句，将模板 main.tpl 里的{TITLE}替换为 FastTemplate Test 看不懂想不明的朋友多看看上面的那些代码。接着呢！接着是另外一个很有特色的东东。parse(RETURN, FileHandle(s) ) 将一个已定义模板插入的定义到另外一个模板文件中。大家仔细研究下面的代码，相信会比较容易了解。
for ($n=1; $n < = 3; $n++)
{
$Number = $n;
$BigNum = $n*10;
$tpl- >assign(
array(
NUMBER = > $Number,
BIG_NUMBER = > $BigNum
)
);
$tpl- >parse(ROWS,".row");
}
parse 这个函数有三种用法
$tpl- >parse(MAIN, "main"); // 标准
$tpl- >parse(MAIN, array ( "table", "main") ); // 简洁
$tpl- >parse(MAIN, ".row"); // 增加
其中以第三种最有意思，它表示的是在原来已经有的基础上再加上一个新数据。呵呵，这么说大家可能无法明白，我们还是看看再多研究一下上面的源代码吧，毕竟编程这东西有很多是只可意会不可言传的！（下面附上英文的说明，不是地藏想偷懒不翻译，实在是有些东西看原味的比翻译的更加容易理解呀，
In the regular version, the template named ``main'' is loaded if it hasn't been already, all the variables are interpolated, and the result is then stored in FastTemplate as the value MAIN. If the variable '{MAIN}' shows up in a later template, it will be interpolated to be the value of the parsed ``main'' template. This allows you to easily nest templates, which brings us to the compound style.
The compound style is designed to make it easier to nest templates.
The following are equivalent:
$tpl- >parse(MAIN, "table");
$tpl- >parse(MAIN, ".main");
// is the same as:
$tpl- >parse(MAIN, array("table", "main"));
// this form saves function calls and makes your code cleaner
It is important to note that when you are using the compound form, each template after the first, must contain the variable that you are parsing the results into. In the above example, 'main' must contain the variable '{MAIN}', as that is where the parsed results of 'table' is stored. If 'main' does not contain the variable '{MAIN}' then the parsed results of 'table' will be lost. The append style allows you to append the parsed results to the target variable. Placing a leading dot . before a defined file handle tells FastTemplate to append the parsed results of this template to the returned results. This is most useful when building tables that have an dynamic number of rows - such as data from a database query. ）
最后在完成上面的过程后，就可以进行输出了，FastTemplate 库使用使用 FastPrint(HANDLE) 来进行输出。
$tpl- >FastPrint();
在经过上面的这些步骤后，大家对使用 FastTemplate 库的过程是否清楚明白呢？地藏试试把上面的过程总结一下，看看对各位朋友是否有帮助：
首先：将库用 include 加进来
其次：定义一个类变量，在上例中是$tpl
再次：定义各种最小元素，比如上面的$tpl = new FastTemplate("./templates");
然后：利用 parse 函数将各种最小元素进行组合起来
最后：用 FastPrint()进行输出