订阅 |

上一篇 |

返回 |

Tech

PHPLIB Template 模板体系介绍及入门教程

作者: Aion 日期: 2006-05-19 09:41

字体大小: 小中大

phplib中的一些基本语法和函数

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

语法介绍：

phplib中常用的方法有set_file,set_block,set_var,parse,ppasre,p,get等。

声明：由于本系统采用的是phplib,如果页面中有大括号对，这将会替换成空白，所以在写此文章时，用"[[","]]"来替代大括号。大家在用的时候是用大括号便是，此处仅为写文章方便而作此约定。

set_file:是用来引入模板文件。
用法：

CODE:


 $t->set_file("show_main","main.htm");

[Copy to clipboard]

或

CODE:


 $t->set_file(array(
 "show_header"=>"header.htm",
 "show_main"=>"main.htm"
 ));

[Copy to clipboard]

set_block:用来声明一个区块
用法:

CODE:


 $t->set_block("show_main","rowlist","RL");

[Copy to clipboard]

稍微解释一下，show_main是用set_file取得的文件句柄，rowlist是模板页面中的区域标识一般如下方式来写

CODE:


 <table border=\"0\">     <tr>         <td>[[param]]</td>     </tr> </table>

[Copy to clipboard]

如上是将作为了一个区块，这样就可以用循环来生成多行的列表了
区块是可以嵌套的

CODE:


 <table border=\"0\">     <tr>         <td>[[param]]</td>     </tr> </table>

[Copy to clipboard]

如上所示，这声明一个嵌套区块，这在boeiBlog的像册部分采用了这种方式，有兴趣的朋友可以找出来看看
对于嵌套的模板，我们可以这样来使用
$t->set_block("show_main","rowlist","RL"); // 里面的参数从前向后依次是包含的关系，最后一个是别名，主要用来区块识别
$t->set_block("rowlist","collist","CL"); // 第一个参数是外层块的名称，第二个是自己的名乐，第三个是别名
循环这样的区块时要特别注意
如下：

CODE:


 $t->set_block("show_main","rowlist","RL");
 $t->set_block("rowlist","collist","CL");
 for($i=0;$i<5;$i++)
 {
 $t->set("CL");// 这里要对追加的列循环执行一次清理，否则会多出一堆东西
 for($ii=0;$ii<5;$ii++)
 {
 $t->set_var("param","boeiBlog");
 $t->parse("CL","collist",true);// true参数表明这是追加
 }
 $t->parse("RL","rowlist",true);// 这里的true也是表追加
 }

[Copy to clipboard]

上述代码将会产生一个5X5的表格，每个单元格里会出现一个boeiBlog

set_var:用来作变量替换
上述代码里的$t->set_var("param","boeiBlog");就是把模板中的param变量替换成boeiBlog这个字符串，当然也可以替换成变量，如：

CODE:


 $curdate = date("Y-m-d");
 $t->set_var("param",$curdate);

[Copy to clipboard]

set_var也有追加属性，如：

CODE:


 $curdate = date("Y-m-d");
 for($i=0;$i<10;$i++)
 {
 $t->set_var("param","
 ".$curdate,true);
 }

[Copy to clipboard]

这将产生十个连续的当前日期
有时候可以用set_var的追加属性来替代block的循环.

set_var是可以用数组的，如：

CODE:


 $t->set_var(array(
 "param"=>"boeiBlog",
 "title"=>"柏艾网络"
 ));

[Copy to clipboard]

模板如下:

CODE:


 <table border=\"0\">     <tr>         <td>[[param]],[[title]]</td>     </tr> </table>

[Copy to clipboard]

parse:用于解析文件
当我们将模板中的所有变量都处理完之后，可以用parse一将这个模板进行解析。这是模板处理的最后几道工序。
如:

CODE:


 $t->set_file("show_index","index.htm");
 $t->set_file("show_main","main.htm");
 $t->set_var("param","boeiBlog");
 $t->parse("main","show_main");

[Copy to clipboard]

我们所用的模板可能是:

CODE:


 main.htm
 <table border=\"0\">     <tr>         <td>[[param]]</td>     </tr> </table>

[Copy to clipboard]

如果此时还有另外一个模板，其结构如下：

CODE:


 index.htm
 <div>[[main]]</div>

[Copy to clipboard]

那么上述代码将会把main.htm中的变量替换成boeiBlog后再放到index.htm中的main处，最后形成一个在标签中的表格

解析完成之后便是输出页面，

p:用于输出页面
如：

CODE:


 $t->set_file("show_index","index.htm");
 $t->set_file("show_main","main.htm");
 $t->set_var("param","boeiBlog");
 $t->parse("main","show_main");
 $t->parse("index","show_index");
 $t->p("index");// 此处便会将整个index页面输出，注意main.htm已经被嵌入到index.htm，所以不用$t->p("main");

[Copy to clipboard]

pparse:同p一样也用来输出页面
如：

CODE:


 上述代码可以如下简化
 
 $t->set_file("show_index","index.htm");
 $t->set_file("show_main","main.htm");
 $t->set_var("param","boeiBlog");
 $t->parse("main","show_main");
 $t->pparse("index","show_index");// 此处将p和parse结合到一起，立即完成解析并输出

[Copy to clipboard]

get:用于获得文件内容
如：

CODE:


 $t->set_file("show_index","index.htm");
 $t->set_file("show_main","main.htm");
 $t->set_var("param","boeiBlog");
 $t->parse("main","show_main");
 $t->parse("index","show_index");
 $getstr = $t->get("index");
 echo $getstr;// 你将会看到这实际上和p是一样的。

[Copy to clipboard]

利用get，我们可以轻松的取得生成页面的内容，这可以用于静态页面的生成。可以看到phplib用来处理静态页面是非常方便的

PHPLIB Template入门系列（1）

===========
何谓"模板"技术
===========

我们的最初观察是将界面和实现代码分离开来,这样做的目的是将美工和程序员的工作分离开来.PHP的一个优点是可以把PHP代码嵌入HTML里面,这样你就不必再把大段HTML代码用函数print()输出来.

CODE:

print(" <table border=\"0\" cellspacing=\"1\" cellpadding=\"2\" width=\"100%\">     <tr>         <td>");
 print("我爱你 kiki");
 print("</td>     </tr> </table> ");

[Copy to clipboard]

这段代码对界面维护来说是相当困难的,除非程序员做这样事情且他对样式表,HTML非常精通.取而代之的我们用

CODE:

 <table border=\"0\" cellspacing=\"1\" cellpadding=\"2\" width=\"100%\">     <tr>         <td>
 <!--p print("我爱你 kiki ")-->
 </td>     </tr> </table>

[Copy to clipboard]

这样,做美工设计的只要不碰PHP代码,就可以很方便地改变这个表格的样式,如果使用dreamweaver等所见即所的工具,将会更加方便.

现在的一个问题是,如果美工正在修改的话,程序员仍需要把这个文件取回来,才能改变里面的PHP代码,修改完后再交给美工,这样循环往复,往往要花费大量的时间和精力,如果你所在公司是采取这种模式的话,恐怕老板为了节省时间,会把很多界面设计也交给程序员来做,毕竟他不会让你们任何一个闲座着等待.作为程序员的你此时可能会梦想:如果程序员只要负责写程序代码,不理会令人烦躁的界面,那就太好了.

或许Fast Template诞生那刻起(我不敢确定它是最早的PHP模板处理类,但用起来确实很方便),你的梦想就几近实现.策划们把东西交给你,当然里面的元素都写好了的,形如以下tpl.html

CODE:

 <table border=\"0\" cellspacing=\"1\" cellpadding=\"2\" width=\"100%\">     <tr>         <td>
 我爱你
 </td>     </tr> </table>

[Copy to clipboard]

你只需要在程序里给这些元素(MY_LOVE)赋值就行了tpl.php
$tpl->assign("MY_LOVE", "kiki");
你基本上不用管这些元素的样式(比如字体,宽度,高度等),所在位置,甚至这些元素将来可能不再使用了.与此同时,美工那边把元素放进一个HTML页面里(这个页面就是我们所说的"模板"),他也不用担心会不小心把你的程序给搞坏了.然后做完后交给一个专门负责程序和美工结合的人(当然在国内也是程序员做这样事情),他很可能只需要很小的几个修改就可以把两者结合的很好.这样对你,对美工,都大大提高了工作效率,老板自然也会很高兴啦.

所以我这里所说的"模板"技术,就是可以将程序和美工分离的技术,注意不是逻辑抽象层与表现层的分离.一来,那样将会让人不知所云,因为"逻辑抽象"这四个字就已经太抽象了,且表现层并只是美工所做的模板.所以,很多人试图把Fast Template,PHPLIB Template两个与Smarty相比较,在我看来,这是明显不对的.

PHPLIB Template类也是一个用PHP代码处理模板的一个类.也是本文要将要阐述的一个模板类.同上面讲的一样,它能把模板中的"元素"替换为你为它设定的值",且处理的很很好,也容易扩展,由于使用了preg_函数,所以速度也比较快.很多人都会提出一个意见:使用模板会让你的代码运行的更慢,确实是这样的,如果你使用嵌入式写法,会快一些,如果把PHP连同HTML全部写入PHP里(用 print(""); ),可能会更快.但如果综合考虑整个项目的开发效率,以及后期维护性的话,这些代价是可以承受的,而且慢也不会慢哪里去,真正的问题所在可能是你的模板实在是太大了.当然,你也可以改进这个模板类,让它运行的更快.

可以从这里下载
http://www.sanisoft.com/phplib/download.php PHPLIB
然后从压缩包中php目录下取出template.inc,就可以供我们使用了.
可以下载它的PEAR集成版本
http://pear.php.net/package/HTML_Template_PHPLIB/download
不过你的PHP版本需要在4.3.0以上.

PHPLIB Template入门系列（2）

=============
第一个应用
=============

一个封装很好的类对使用者(可能不是开发者本人)来说,最大的好处就是,你无需知道类内部是怎么运作的,只需知道如何利用它提供的接口做你想做的事情即可.所以,本文不打算具体讲述PHPLIB Template(以下简称Template)是如何将"元素"转换成"值"的,你需要了解的是"它能这样做",而不是"它为什么能这样做".
好了,下面我们就开始它的第一个应用了.

先在我们要测试的网站的目录下建两个文件夹inc和template.目录inc下放引用文件,比如类库,函数库等,这里我们就把template.inc放如该目录下.tempate下放模板文件,我们先建一个模板文件first.html,内容如下

CODE:


 
 
 
 
 
 
 
 真想对你说：我爱你 {lover} ，但我却不敢说，因为我知道你爱的人是 {man}.
 <p>
 <font color=\"#0000ff\">{author}</font> 于 {date}

[Copy to clipboard]

用inc,template命名文件目录,都是我的个人习惯,你完全可以采取不同的方式.我用扩展名为.html的名称命名模板文件,是为了方便美工用frontpage或者dreamweaver修改,但这完全取决于你自己的习惯.

first.html模板中的{lover},{man},{author}可以称为"模板变量",用花括号({})把变量名称括住即组成一个模板变量.模板变量就是模板元素的一种。你可能会担心它的命名问题,其实除了空格(" "),回车换行(" ", " "),tab( )外它都被视为是正确的.所以
{your-lover}
也是正确的.这点有时可能会令你很痛苦,因为模板里的有些javascript代码可能无意间变没有了,比如
if(a>b){document.write("i love u");}
中的
{document.write("i love u");}
也被视为一个变量了.上面的代码在你选的模板处理方式下,可能会变成if(a>b){},从而导致javascript错误.为什么会"变没"了呢?稍后将做解释.

上面我们定义的三个变量{lover},{man},{author}的原因是,我们想随时改变它们的值.下面我们就来做这个工作.新建first.php文件,内容如下:

CODE:


 
 <!--p <-->//包含进模板类 template.inc
 require "inc/template.inc";
 
 //创建一个实例
 $tpl = new Template("template", "keep"); //注1
 
 //将整个文件读进来
 $tpl->set_file("main", "first.html"); //注2
 
 //给文件中的模板变量赋值
 $tpl->set_var("lover", "kiki"); //注3
 $tpl->set_var("man", "ccterran"); //注4
 $tpl->set_var("author", "iwind"); //注5
 
 //完成替换
 $tpl->parse("mains", "main"); //注6
 
 //输出替换的结果
 $tpl->p("mains"); //注7
 
 ?>

[Copy to clipboard]

浏览器中浏览这个文件,你就会发现输出

CODE:


 
 真想对你说：我爱你 kiki ，但我却不敢说，因为我知道你爱的人是 ccterran.
 
 iwind 于 {date}

[Copy to clipboard]

这一切正如我们所期望的(除了{date}).注1

CODE:


 $tpl = new Template("template", "keep");

[Copy to clipboard]

是创建一个Template类的实例对象.它有两个参数,都是可选的.

第一个参数是模板所在目录,如果不设置则为"."(即当前目录),由于我们刚才把模板文件first.html放到template下了,所以这里为template.注意它一般使用相对路径,如果你用相对于根目录(比如 /phplib/test/template)的路径,就会出现

CODE:


 Template Error: set_root: /phplib/test/template is not a directory.
 Halted.

[Copy to clipboard]

的错误.

第二个参数是指定模板类对"未完成处理"变量的处理方式,所谓"未完成处理"指的是模板变量未赋值,块未完成替换工作(下面一节将讲到它),它有三个值可选,分别为"keep","comment","remove":
如果设为"keep",这些变量将原封不动的保留下来.
如果设为"comment",那么会在报错的同时,将未完成处理的变量全部转换成HTML的注释.
如果设为"remove",未完成处理的变量便会被删除(这也是默认的情况).

所以在上面的例子中,我指定的是"keep",于是{date}因为未赋值,所以还保留着.而缺省的情况下是"remove",所以,如果我这样创建实例对象

CODE:


 $tpl = new Template("template", "remove");

[Copy to clipboard]

或者

CODE:


 $tpl = new Template("template");

[Copy to clipboard]

的话,输出就变成了

CODE:


 
 真想对你说：我爱你 kiki ，但我却不敢说，因为我知道你爱的人是 ccterran.
 
 iwind 于

[Copy to clipboard]

可以看出{date}被删除了.如果是

CODE:


 $tpl = new Template("template", "comment");

[Copy to clipboard]

它的结果将是

CODE:


 
 真想对你说：我爱你 kiki ，但我却不敢说，因为我知道你爱的人是 ccterran.
 
 iwind 于

[Copy to clipboard]

看起来和"remove"方式一样,但查看源文件,我们会发现

CODE:


 
 
 
 
 
 
 
 真想对你说：我爱你 kiki ，但我却不敢说，因为我知道你爱的人是 ccterran.</p> <p>
 <font color=\"#0000ff\">iwind</font> 于 <!-- Template variable date undefined -->

[Copy to clipboard]

其中有的错误信息,告诉我们date变量未定义(赋值).

用"comment"或许对程序的调试很有帮助.

我们再回头看看

CODE:


 if(a>b){document.write("i love u");}

[Copy to clipboard]

中 {document.write("i love u");} 会"变没"的问题,是因为模板类视之为模板变量,但你没有给它指定值(当然会没有),且你没有指定"keep"方式来处理未定义变量,所以它就被"remove"了.

所以在模板使用过程中应该多多注意这些问题.

注2是将一个模板文件加载进来,事实上你可以一次加载多个模板(在第四节将讲到这个问题).你可以想象

CODE:


 $tpl->set_file("main", "first.html");

[Copy to clipboard]

把"first.html"内容给变量"main"(尽管很多人称之为"句柄",但本文决定不谈"句柄"),所以"main"的值就变成模板的内容了,包含着那些模板变量.

注3,注4,注5,是给模板变量赋值.值是什么,你自然可以随便定.比如你还可以

CODE:


 $tpl->set_var("lover", "kiki1");
 $tpl->set_var("man", "ccterran1");
 $tpl->set_var("author", "iwind_php");

[Copy to clipboard]

你也可以一次完成给一列的变量赋值.这样

CODE:


 $tpl->set_var(
 array("lover"=>"kiki", "man"=>"ccterran", "author"=>"iwind")
 );

[Copy to clipboard]

如果你想设置一个变量的值为空的话,可以

CODE:


 $tpl->set_var("man", "");

[Copy to clipboard]

或者

CODE:


 $tpl->set_var("man");

[Copy to clipboard]

注6,是执行将上面$tpl->set_var给模板变量指定的值替换掉模板中的模板变量这个操作,第一个参数即为模板分析的结果,也可以视为一个变量.

当然注7的 $tpl->p("mains"); 就将模板分析的结果如你所愿的输出啦.

喏,恭喜你,你的第一个模板类应用就完成了.你可能不小心弄错了哪个地方,模板类默认情况下会自动打印出错误提示的,根据这些提示,你就很容易就可以找出问题所在,在第6节将会具体讲到.

PHPLIB Template入门系列（3）

===========
块的应用
===========

在上一节中,我们知道模板元素的一种:模板变量,并知道如何在程序中给它赋值,使之呈现我们想要的东西.这对一般的简单网页来说,或许就已经够用了.现在我们设想一稍微复杂的一种情况,在template目录下新建一个second.html模板文件,内容为:

CODE:


 
 
 
 
 
 下面是一个列表</p> <ul>
 <li>张三 的成绩是 82
 </li><li>李四 的成绩是 90
 </li><li>王儿 的成绩是 60
 </li><li>麻子 的成绩是 77
 </li></ul>

[Copy to clipboard]

上面的列表中列出了"张三","李四","王二","麻子"四人的成绩.假设要用PHP代码嵌入HTML的方式输出的话,你可能是这样写的:

CODE:


 
 
 
 
 
 
 
 下面是一个列表
 <!--p <-->$result = mysql_query("Select username,score FROM my_tbl");
 ?>
 <ul>
 <!--p <-->while ($row = mysql_fetch_array($result))
 {
 ?>
 <li><!--row["username"-->的成绩是 <!--row["score"-->
 <!--p <-->}
 ?>
 </li></ul>

[Copy to clipboard]

这样写很适合PHP新手,但你很快发现你或者美工改这个列表样式的时候需要多么的小心翼翼,特别是美工,如果他不懂你写得PHP代码,那么他会终日生在恐惧之中!因为稍微的不小心,可能就会带来程序的运行错误.而且如果他想把这个列表从一个地方移到另一个地方,也是相当不容易的.于是作为程序员的你不得不把美工（虽然你做的可能性更大）修饰过的页面重新审查一次，无形中就造成费时费力。

现在好了,有了Template模板类,你可以把你的代码从模板中抽取出来了.你可能会这样修改second.html模板:

CODE:


 
 
 
 
 
 
 
 下面是一个列表
 <ul>
 <li>{username1} 的成绩是 {score1}
 </li><li>{username2} 的成绩是 {score2}
 </li><li>{username3} 的成绩是 {score3}
 </li><li>{username4} 的成绩是 {score4}
 </li></ul>

[Copy to clipboard]

显然,你采取了一个良好的命名方式,用1,2,3..来表示每一行数据,然后你在你的程序里循环给这些变量赋值,也是不难的,比如:(second.php)

CODE:


 <!--p <-->//包含进模板类 template.inc
 require "inc/template.inc";
 
 //创建一个实例
 $tpl = new Template("template");
 
 //将整个文件读进来
 $tpl->set_file("main", "first.html");
 
 //连接数据库，选择数据库略
 省略.....
 
 //查询结果
 $result = mysql_query("Select username,score FROM my_tbl");
 
 //给文件中的模板变量赋值
 $i=0;
 while ($row = $idb->fetch_array($result))
 {
 $i++;
 $tpl->set_var("username" . $i, $row["username"]);
 $tpl->set_var("score" . $i, $row["score"]);
 }
 
 //完成替换
 $tpl->parse("mains", "main");
 
 //输出
 $tpl->pparse("mains", "main");
 
 ?>

[Copy to clipboard]

这样你也能得到正确结果.在特殊情况下你或许需要这样做.但Template提供了一个更方便的"大的模板变量",那就是块.我之所以称之为"大的模板变量",是因为它也可以视为可以包含其他模板变量的变量.形式如

CODE:


 <ul>
 <!-- BEGIN list -->
 <li>{username} 的成绩是 {score}
 <!-- END list -->
 </li></ul>

[Copy to clipboard]

即用和定义了一个名为list的块,(注意:我在这里为了方便理解,只称之为块名称).这个块里面又包含一些HTML代码(

等等)以及模板变量({username},{score}).

在讲述如何用块输出列表之前,我们先谈一下块的定义格式.

首先和都要各自为一行,亦即下面的块的定义是错误的

1,
同行的

{username} 的成绩是 {score}

2,

{username} 的成绩是 {score}
同行的

都是固定的,也就是说只能是两个中划线("-"),且它们与BEGIN list之间都至少有一个空(空格或tab),看下面的例子

它们都是错误的块的定义方法,因为第一个与list之间至少有一个空.

BEGIN/END和list之间也应该有一个空格,注意是有且仅有一个空格,不能多也不能少.

块的名称建议你只使用字符,数字,下划线以及它们的组合.

BEGIN和END两个词语都应该是大写的。

好了,下面开始探讨如何是这个块变成一个列表.我们可以这样

CODE:


 <!--p <-->//包含进模板类 template.inc
 require "inc/template.inc";
 
 //创建一个实例
 $tpl = new Template("template");
 
 //将整个文件读进来
 $tpl->set_file("main", "second.html");
 
 //加载块list
 $tpl->set_block("main", "list", "lists");
 
 //连接数据库，选择数据库略
 省略.....
 
 //查询结果
 $result = mysql_query("Select username,score FROM my_tbl");
 
 //给文件中的模板变量赋值
 while ($row = $idb->fetch_array($result))
 {
 $tpl->set_var("username", $row["username"]);
 $tpl->set_var("score", $row["score"]);
 $tpl->parse("lists", "list", true);
 }
 
 //完成替换
 $tpl->parse("mains", "main");
 
 //输出
 $tpl->pparse("mains", "main");
 
 ?>

[Copy to clipboard]

记住把你的数据库连接写在我省略的部分,就可以打印正确的结果,一如

CODE:


 
 下面是一个列表
 
 张三 的成绩是 82
 李四 的成绩是 90
 王儿 的成绩是 60
 麻子 的成绩是 77

[Copy to clipboard]

可以看到在PHP代码里有两个东西

CODE:


 $tpl->set_block("main", "list", "lists"); //代码1
 $tpl->parse("lists", "list", true);

[Copy to clipboard]

就不可思议的将整个块循环输出了.代码1用来加载模板main中的块list,并给其一个名字lists,list就是模板中的一个大变量,它的内容就是

{username} 的成绩是 {score}即:

CODE:


 "list" = " </li><li>{username} 的成绩是 {score}"

[Copy to clipboard]

之所以用lists命名,是为了程序的可读性,也就是说我很容易就知道XXXs是XXX块的名称.

使用set_block后，模板中的块内容

CODE:


 <!-- BEGIN list -->
 </li><li>{username} 的成绩是 {score}
 <!-- END list -->

[Copy to clipboard]

就被lists代替了.于是我们的模板就变成了

CODE:


 
 
 
 
 
 
 
 下面是一个列表
 <ul>
 {lists}
 </ul>

[Copy to clipboard]

块变成了一个变量(lists)!下面只要将lists变量替换成我们想要的就行了.

代码二所处的循环

CODE:


 while ($row = $idb->fetch_array($result))
 {
 $tpl->set_var("username", $row["username"]);
 $tpl->set_var("score", $row["score"]);
 $tpl->parse("lists", "list", true); //代码2
 }

[Copy to clipboard]

每一次循环,两个set_var分别给username,score赋值,然后"list"就变成了
"list" = "

具体的名字的成绩是具体的分数"
代码2就是将list分析后的内容赋给lists,这样就完成了整个块的分析.

parse第三个参数可以设置list中的值是直接存在lists里面,还是附加在原有值之后.我们这里设置为true,说明是附加在原有值之后,才得以每个list的值都会显示出来.反之设为false的话,后面的值会覆盖掉以前的值.最终的结果会是

CODE:


 
 下面是一个列表
 
 麻子 的成绩是 77

[Copy to clipboard]

综上所述,Template模板类的替换方式是:
1,用set_block将模板中的list块(或者你命名的其他块)替换成变量lists.
2,用set_var给list块中的变量赋值
3,把赋值并执行替换后的list内容依次给lists
4,完成分析

PHPLIB Template入门系列（4）

=============
模板嵌套
=============

在PHP程序里,我们常常会把"公用代码"或"公用部分"写进一个文件里,前者象我们的系统配置文件,比如config.php,或者公共函数都写入一个functions.php文件里;后者象一个站点都需要用到的页面头部,尾部.这样做的好处是可以很方便的维护站点,而如果这个公用部分要有所改动,无需再去改每一个页面,大大减少了我们的工作量.
以前你或许用require,include(require_once,include_once)引进一个公用的页面头部,确实方便而有效,现在我们用Template模板类也可以实现了,并且可以很方便的把一个页面随意插入另一个模板的任意地方.如果你想也把要插进的页面做成含有变量的模板的话,那么你会发现模板类会把这个工作处理的很好.

在template目录下新建三个文件third.html,header.html,footer.html.内容分为如下

third.html

CODE:


 <!-- 这是页面头部 -->
 {header}
 
 下面是一个列表
 <ul>
 <!-- BEGIN list -->
 <li>{username} 的成绩是 {score}
 <!-- END list -->
 </li></ul>
 <!-- 这是页面脚部 -->
 {footer}

[Copy to clipboard]

header.html

CODE:

[Copy to clipboard]

footer.html

CODE:


 <p>author &copy; iwind

[Copy to clipboard]

你也看到了，我们前几节的例子中都是用

CODE:


 $tpl->set_file("main", "模板文件名");

[Copy to clipboard]

来加载模板文件的。只所以命名为"main",是因为我们想给它一个意义：主模板。这里的third.html就可以称之为“主模板”，而欲嵌入主模板third.html的{header}变量所在位置的模板文件header.html,则可以称为"子模板".同样footer.html也是一个"子模板",我们想把它放到主模板里的{footer}位置.一个主模板内可以随意嵌入不限内容,尺寸大小,格式等的任何多个子模板.

下面我们开始我们的PHP程序.

先是创建一个类的实例对象

CODE:


 //包含进模板类 template.inc
 require "inc/template.inc";
 
 //创建一个实例
 $tpl = new Template("template");
 
 //读进三个模板文件的内容,分别给变量"main", "my_header", "my_footer"
 $tpl->set_file("main", "third.html");
 $tpl->set_file("my_header", "header.html");
 $tpl->set_file("my_footer", "footer.html");
 
 //执行my_header,my_footer里的模板变量替换,并把最终结果分别赋给主模板中的header,footer
 $tpl->parse("header", "my_header");
 $tpl->parse("footer", "my_footer");
 
 //然后完成主模板内变量的替换,并输出主模板分析后的内容
 $tpl->parse("mains", "main");
 
 //输出
 $tpl->p("mains");

[Copy to clipboard]

于是,我们便可以通过查看源文件确信header.html,footer.html两个子模板文件的内容已经被加进主模板里了.

CODE:


 <!-- 这是页面头部 -->
 
 
 
 
 
 
 下面是一个列表</p> <ul>
 <!-- BEGIN list -->
 <li>的成绩是
 <!-- END list -->
 </li></ul>
 <!-- 这是页面脚部 -->
 <p>author &copy; iwind

[Copy to clipboard]

你会发现,所有的变量都没了,包括我们未赋值的{title},{username},{score}.这是因为我们在创建对象时,第二个参数未设置,而自动采用了"remove"

CODE:


 $tpl = new Template("template");

[Copy to clipboard]

和

CODE:


 $tpl = new Template("template", "remove");

[Copy to clipboard]

的效果是一样的.

如果我们想给这些变量也赋值,那么方法和单个模板里变量的分析方法是一样的.

CODE:


 //读模板内容进变量
 $tpl->set_file("main", "third.html");
 $tpl->set_file("my_header", "header.html");
 $tpl->set_file("my_footer", "footer.html");
 
 //设置子模板header.html里的变量title的值
 $tpl->set_var("title", "这个是网页标题");
 
 //以下分析主模板里的块的内容
 //设置块
 $tpl->set_block("main", "list", "lists");
 $array = array("张三" => 82, "李四" => 90, "王二" => 60, "麻子" => 77);
 foreach ($array as $username=>$score)
 {
 $tpl->set_var("username", $username);
 $tpl->set_var("score", $score);
 $tpl->parse("lists", "list", true);
 }

[Copy to clipboard]

所有程序为

CODE:


 <!--p <-->//包含进模板类 template.inc
 require "inc/template.inc";
 
 //创建一个实例
 $tpl = new Template("template");
 
 //将整个文件读进来
 $tpl->set_file("main", "third.html");
 $tpl->set_file("my_header", "header.html");
 $tpl->set_file("my_footer", "footer.html");
 
 //设置header.html里的变量title的值
 $tpl->set_var("title", "这个是网页标题");
 
 //设置块
 $tpl->set_block("main", "list", "lists");
 $array = array("张三" => 82, "李四" => 90, "王二" => 60, "麻子" => 77);
 foreach ($array as $username=>$score)
 {
 $tpl->set_var("username", $username);
 $tpl->set_var("score", $score);
 $tpl->parse("lists", "list", true);
 }
 
 //执行my_header,my_footer里的模板变量替换,并把最终结果分别赋给主模板中的header,footer
 $tpl->parse("header", "my_header");
 $tpl->parse("footer", "my_footer");
 
 //完成主模板内变量的替换
 $tpl->parse("mains", "main");
 
 //输出
 $tpl->p("mains");
 
 ?>

[Copy to clipboard]

输出的结果为

CODE:


 <!-- 这是页面头部 -->
 
 
 
 
 
 
 下面是一个列表</p> <ul>
 
 <li>张三 的成绩是 82
 </li><li>李四 的成绩是 90
 </li><li>王二 的成绩是 60
 </li><li>麻子 的成绩是 77
 </li></ul>
 <!-- 这是页面脚部 -->
 <p>author &copy; iwind

[Copy to clipboard]

一切都是我们所期望的.

在这个程序里,我们用

CODE:


 $tpl->set_block("main", "list", "lists");

[Copy to clipboard]

加载一个块.其实它的第一个参数为该块所在父变量,如果这个块在header.html里,那么恐怕要这样写了

CODE:


 $tpl->set_block("my_header", "list", "lists");

[Copy to clipboard]

但分析方法还是一样的.

从以往和这节中的例子,我们可以看出来,定义一个模板变量{var}值的方法是用

CODE:


 $tpl->set_var("var_name", "var_value");

[Copy to clipboard]

但把一个变量的值给另一个变量就需要用parse.

CODE:


 $tpl->parse("target_name", "from_name", true);

[Copy to clipboard]

或者

CODE:


 $tpl->parse("target_name", "from_name", false);

[Copy to clipboard]

使用parse就先执行from_name大变量的模板变量的替换,然后再把所得结果赋给target_name.

一个变量{varname}无论在模板的何处(块里面,子模板里),定义的方法都是一样的.

子模板里还可以嵌入新的子模板,称之为"多重嵌套",分析的方法都是一样的,只是一般用不到.块也可以多重嵌套,而且非常有用,使得模板可以设计的可以很清晰.