<p> 每个进行过较大型的 PHP-Web 应用程序设计的开发人员大概都有如下的经历:花大量的时间写超文本语句,为页面排版,兼作美工等;或在整合的程序代码在和HTML静态页面时花费大量的时间。的确,用脚本语言开发 Web 应用不容易将数据的处理和数据的显示分开,但在多人合作的情况下,如果无法将数据和显示分开,将大大影响开发的效率,专业分工的发挥。为了解决这个问题,PHP 也提供了自己的解决方案,有多种,本文主要介绍 PHPLIB 中的 Template 类。</p><p> 一、模板处理类的设计</p><p> 模板处理类主要需完成以下的任务: </p><ul><li>从模板文件中读取显示用的HTML代码。 </li><li>将模板文件和实际生成的数据结合,生成输出的结果。 </li><li>允许同时处理多个模板。 </li><li>允许模板的嵌套。 </li><li>允许对模板中的某个单独的部分进行处理。 </li></ul><p> 归纳上述任务,模板类的设计目标为:从多个模板文件中读入显示的HTML代码,将这些显示代码中需要动态数据的地方替换为PHP程序运算所得出的数据,然后按照一定的顺序输出。其中,替换的部分可以自由的设定。</p><p> 读取显示用的HTML代码采用读文件的方式</p><p> 模板文件和数据的结合采用正则替换</p><p> 处理多个模板用数组存储来实现。</p><p> 模板的嵌套的实现主要的想法是:将模板和输出(任何中间的分析结果)一视同仁,都可拿来做替换,即可实现。</p><p> 单独部分的处理的通过在模板文件中设定标注,然后在正则替换中结合标注来控制,实现部分替换。</p><p> 二、模板处理类的实现</p><p> 请参看 PHPLib 中的 Template.inc,总共 345 行代码,有详细的注释。以下列举一些主要的函数,供研读参考:</p><p> 1) function set_file($handle,$filename=” ”) line 77, 读取文件</p>
<p> </p>
<p> 2) function set_var($varname, $value = "") line 119, 设置映射数据-替换变量</p><p> 3) function set_block($parent, $handle, $name = "") line 96, 设置标注</p><p> 4) function subst($handle) line 136, 执行数据替换</p><p> 5) function parse($target, $handle, $append = false) line 165, 执行模板文件与数据的结合</p><p> 6) function p($varname) line 268, 输出处理结果</p><p> 注:本人下载的php-lib7.2c的Template.inc文件中的第95行少了个“/”,加上后使用正常。</p><p> 三、模板处理类的使用</p><p> 3.1 最基本的例子</p><p> 为了简单起见,这里假设模板文件、使用模板的PHP文件和模板处理类的文件都放在同一个目录下。PHPLIB中的习惯是使用ihtml后缀为模板文件的后缀。</p><p> 下面是要使用的模板文件:</p><p> <code><html><br /><head><br /><title>使用模板的测试</title><br /></head><br /><body><br /><h2>这是一个使用模板的测试文件!</h2><br />当前的时间是{currenttime}!<br /></body><br /></html></code></p><p> 注:模板文件和通常的 HTML 文件差不多,唯一不同的是使用“{}”括起来的是可以被模板处理类替换的动态内容的变量。</p><p> 接下来使用模板处理类来处理上面的模板: </p><p> <code><?<br />//引入Template类<br />include("template.inc");<br />//得到需要替换的数据<br />$timeNow=date("Y-m-d H:i:s",time());<br />//实例化一个Template类<br />$template= new Template();<br />//载入test.ihtml模板<br />$template->set_file("handle1","test.ihtml");<br />//使用$timeNow的值替换模板中的currenttime<br />$template->set_var("currenttime",$timeNow);<br />//进行实际的模板操作<br />$template->parse("output","handle1");<br />//输出最后结果<br />$template->p("output");<br />?></code></p>
<p> </p>
<p> 注:如果只想用PHPLIB中的模板类,只需在文件头包含Template.inc类即可。 创建Template对象时,可以指定模板文件路径,如:new Template(“/htdocs/apps/templates/”),缺省为当前路径。</p><p> 3.2 模板嵌套与块设定</p><p> 下面这个例子来自与PHPLIB的参考手册,综合性较强,这里需说明的一点是设定块的目的与嵌套无关,但这个范例包含了两者。请仔细阅读,块设定是为了避免这种情况:原本可在一个模板文件(静态页面)里完成的内容,因需要部分循环,而将部分循环内容提取单独做成模板文件。请思考,如果不用块设定,这个例子是不是需要3个模板文件呢?</p><p> 模板文件1,page.ihtml </p><p> <code><html><br /><head><title>{PAGETITLE}</title></head><br /><body bgcolor="#ffffff"><br /><table border=1 cellpadding=4 cellspacing=0 bgcolor="#eeeeee"><br /><tr><br /><td colspan=2><h1>{PAGETITLE}</h1></td><br /></tr><br /><tr><br /><td>{OUT}</td><br /><td>Content</td><br /></tr><br /></table><br /></body><br /></html></code></p><p> 模板文件2,box.ihtml </p><p> <!-- start box.ihtml --></p><p> <code><table border=1 bgcolor="#cccccc" cellpadding=4 cellspacing=0><br /><tr><br /><td colspan=2><b>{TITLE}</b></td><br /></tr><br /><!-- BEGIN row --><br /><tr><br /><td>{NUM}</td><br /><td>{BIGNUM}<br /></tr><br /><!-- END row --><br /></table><br /><!-- end box.ihtml --></code></p></p><p> 模板处理文件,test.php </p><p> <code><?php<br />//引入Template类<br />include("template.inc");<br />#实例化一个Template类,名字叫$t<br />$t = new Template();<br /># 建立包含模板文件的数组<br />$t->set_file(array(<br />"page" => "page.ihtml",<br />"box" => "box.ihtml"));<br /># 载入模板文件box中的一个块row,引用名称为rows<br />$t->set_block("box", "row", "rows");<br /># 设置替换<br />$t->set_var(array("TITLE" => "Testpage",<br />"PAGETITLE" => "hugo"));<br /># 生成数据NUM,BIGNUM<br />for ($i=1; $i<=3; $i++) {<br /> $n = $i;<br /> $nn = $i*10;<br /> #设置替换<br /> $t->set_var(array("NUM" => $n, "BIGNUM" => $nn));<br /> #进行分析,分析的结果添加到rows的后面<br /> $t->parse("rows", "row", true);<br />}<br /># 生成box,再生成page<br />$t->parse("OUT", array("box", "page"));<br /># 输出最后结果<br />$t->p("OUT");<br />?></code></p></p>