PHP开发必备 PHP模版引擎Dwoo深入学习-51CTO.COM

在上一篇关于Dwoo的教程中(PHP开发必备一步步学PHP模版引擎Dwoo)，我们讨论了Dwoo中的基本用法。在本文中，我们将进一步讲解在Dwoo中的一些高级用法,比如插件机制的编写以及如何跟常见的PHP框架整合。

一、Dwoo中模版的继承

Dwoo的其中一个强大功能是它可以支持模版的继承。这实现起来是十分简单的，只需要定义好一个父模版，然后子模版则可以继承父模版了，并且可以在子模版中定义多种新的特性。聪明的开发者会善于利用这个特性，去减少重复的劳动。

Dwoo中继承模版的关键在于“扩展”的插件机制，它允许模版去继承另外一个模版。为了更好地理解这一特性，我们举个例子说明如下。假设目前你已经有一个基类的模版，名字叫base.tpl,其中包含了两个区域，一个是导航区，一个是内容区，如下：

<html> 
<head></head> 
<body>   
{block "nav"}  
{/block}  
{block "content"}  
<div id="content"> 
This is content for the main page.  
</div>   
{/block}  
</body> 
</html>

现在，假设你的一些页面需要使用水平导航条，你只需要继承基类模版页即可，并且可以重新定义导航条的样式，如下代码，我们把这个代码定义为child.tpl：

{extends "base.tpl"}  
{block "nav"}  
<div id="nav">  
<a href="#">Home</a> |   
<a href="#">News</a> |  
<a href="#">Weather</a> |  
<a href="#">Hotels</a> |  
<a href="#">Dining</a>  
</tr>  
</table>  
</div>  
{/block}

这里使用了{extends “base.tpl”}指出是继承了父类的模版，并且在这里的{block “nav”}区域中，重写了导航条的内容，最后输出为如下图：

现在我们考察另外一种情况，假设一些页面中需要额外的子导航菜单，比如需要以垂直形式显示导航条，这时，我们可以采用如下代码：

{extends "child.tpl"}  
{block "nav"}  
{$dwoo.parent}  
<div id="sub-nav">  
<h2>{$subtitle}</h2>  
<ul>  
{loop $items}  
<li><a href="#">{$item}</a></li>   
{/loop}  
</ul>  
</div>   
{/block}  
{block "content"}  
<div id="content">  
This is content for the Dining page.  
</div>  
{/block}

在这里，使用了{$dwoo.parent}去调用了父类模版，注意这里是继承了child.tpl这个模版，也就是说，调用了父类模版中的导航条中的内容，并且这里又重新定义了一个垂直的导航条，注意这里还重写了content区域的内容，覆盖了父模版中对应的content区域的内容了，结果如下图：

可以看到，只要适当使用模版继承，则可以大大方便开发。

#p#

二、子模版

Dwoo支持子模版,这些子模版使得开发者可以在应用中重用它们。子模版的创建方法是使用标签{template}….{/template},其中要提供唯一的名称，以便在其他地方进行引用。而在其他地方引用子模版，可以使用”load template”标签加载。

子模版中可以传递多个参数，下面直接看例子以方便理解。首先编写一个子模版，名称叫slave.tpl，代码如下：

{template mylist data}  
<ul>  
{foreach $data d}  
<li>{$d}</li>  
{/foreach}  
</ul>  
{/template}

这里，我们把这个子模版命名为mylist,其中有一个循环取读取data变量中的值并输出。

有了子模版后，我们就可以在需要其的地方加载它，比如，在一个模版文件master.tpl中，可以这样调用：

{load_templates "slave.tpl"}  
{mylist $items}

这里用load_templates加载slave.tpl的子模版，并且为子模版mylist赋值items变量，而items变量可以由如下代码去赋值：

<?php  
include 'dwooAutoload.php';  
try {  
$dwoo = new Dwoo();  
$tpl = new Dwoo_Template_File('tmpl/master.tpl');  
$data = array();   
$data['items'] = array('red', 'blue', 'green', 'yellow');;  
$dwoo->output($tpl, $data);  
} catch (Exception $e) {  
echo "Error: " . $e->getMessage();   
}  
?>

可以看到输出如下：

可以看到，子模版的确十分方便使用，而且子模版中的内容一旦变更，其他所有用到子模版地方的内容也会接着变化。

#p#

三、编写自己的插件

Dwoo中的一个前大功能是能可以让开发者编写插件，并通过Dwoo的addplugin机制加载自己写的类，现举一个简单例子说明。比如下面的代码，封装了对email的操作：

<?php  
function fix_address(Dwoo $dwoo, $str) {  
return str_replace(  
array('@', '.', '-'),   
array(' at ', ' dot ', ' dash '),   
$str 
);  
}  
include 'dwooAutoload.php';  
try {  
$dwoo = new Dwoo();  
$tpl = new Dwoo_Template_File('tmpl/plugin.tpl');  
$dwoo->addPlugin('email_safe', 'fix_address');  
$data['string']= 'vikram@example.com';  
$dwoo->output($tpl, $data);  
} catch (Exception $e) {  
echo "Error: " . $e->getMessage();   
}  
?>

在这个例子中，我们想将用户EMAIL中的象@,分隔符等符号用英文替换掉，这样防止象网上机器人等去采集EMAIL，泄露私隐。其中fix_address方法为替换的方法。而通过dwoo中的addPlugin方法，命名一个插件，名字为email_safe,而插件的内容则指定为fix_address方法。在使用这个插件时，可以如下使用，plugin.tpl内容为：

{email_safe($string)}

下图为输出结果：

而另外一种使用dwoo插件的方法为继承Dwoo_Filter abstract class，如下：

<?php  
class Dwoo_Plugin_email_safe extends Dwoo_Plugin  
{   
public function process($email)  
{  
return str_replace(  
array('@', '.', '-'),   
array(' at ', ' dot ', ' dash '),   
$email 
);  
}  
}  
?>

如果用这种方式的话，则可以把该文件保存在dwoo目录下的plugins目录下，则dwoo的自动加载机制会自动加载这个插件，而不用每次使用时都使用addplugin的功能。

#p#

四、DWOO的过滤器

同样，dwoo中也支持用户编写过滤器，它可以在模版内容向用户输出前进行一些相关的操作，跟插件类似，可以使用addFilter()加载自己编写的过滤器，例子如下：

<?php  
function activate_mailto_links(Dwoo $dwoo, $str) {  
return preg_replace('/([a-zA-Z0-9]+@[a-zA-Z0-9._-]+\.[a-zA-Z]+)/', '<a href="mailto:$1">$1</a>', $str);  
}  
include 'dwooAutoload.php';  
try {  
$dwoo = new Dwoo();  
$dwoo->addFilter('activate_mailto_links');  
$tpl = new Dwoo_Template_File('tmpl/filter.tpl');  
$data['string']= 'Press enquiries: press@example-domain.com or call 1-800-1234. General inquiries: info@example-domain.com.';  
$dwoo->output($tpl, $data);  
} catch (Exception $e) {  
echo "Error: " . $e->getMessage();   
}  
?>

这个例子的过滤器中，作用是自动把模版合成输出后的内容中的含有的邮件地址自动加上mailto:的邮件链接。结果如下输出：

同样，也可以这样写：

<?php  
class Dwoo_Filter_activate_mailto_links extends Dwoo_Filter  
{   
public function process($str)  
{  
return preg_replace('/([a-zA-Z0-9]+@[a-zA-Z0-9._-]+\.[a-zA-Z]+)/', '<a href="mailto:$1">$1</a>', $str);  
}  
}  
?>

把该文件保存在dwoo下的plugins目录中，同样DWOO会自动加载。

#p#

五、DWOO中的缓存

Dwoo中已经内置了很好的缓存功能，大大提高了效率，下面讲解使用dwoo缓存的步骤：

1. 在Dwoo_Template_File的构造函数中，设定cache的名称和缓存时间。

2. 在isCached()方法中，编写相关的模版生成代码，并且当缓存存在的时候，直接返回缓存中的页面。

下面举一个搜索Twitter中信息的例子来说明如何使用缓存：

<html> 
<head> 
<style type="text/css">...  
div.outer {...}{  
border-bottom: dashed orange 1px;  
padding: 4px;  
clear: both;  
height: 50px;  
}   
div.img {...}{  
float:left;  
padding-right: 2px;  
}  
span.attrib {...}{  
font-style: italic;  
}  
</style>   
</head> 
<body> 
<h2>{$title}</h2> 
{loop $records}  
<div class="outer"> 
<div class="img"><img width=48" height="48" src="{$image}" /></div> 
<div>{$tweet} <br/> <span class="attrib">By <a href="{$uri}">{$owner}</a> on {$time}</span></div> 
</div>   
{/loop}  
</body> 
</html>

上面的模版是循环输出在Twitter中检索输出的微博内容。接下来看处理模版的PHP程序，如下：

<?php  
include 'dwooAutoload.php';  
$dwoo = new Dwoo();  
$tpl = new Dwoo_Template_File('tmpl/tweets.tpl', 120, 'id_g75430i472j');  
//检查缓存中是否已经存在该文件，存在的话，从缓存中显示  
if ($dwoo->isCached($tpl)) {  
$dwoo->output($tpl, array());  
echo '(cached output)';  
} else {  
//缓存中不存在，直接搜索twitter   
$result = simplexml_load_file('http://search.twitter.com/search.atom?q=pasta&lang=en');  
$records = array();  
foreach ($result->entry as $entry) {  
$item['image'] = (string)$entry->link[1]['href'];   
$item['owner'] = (string)$entry->author->name;  
$item['uri'] = (string)$entry->author->uri;  
$item['tweet'] = (string)$entry->content;  
$item['time'] = date('d M Y, h:i', strtotime($entry->published));   
$records[] = $item;  
}  
$data = new Dwoo_Data();  
$data->assign('records', $records);  
$data->assign('title', $result->title);  
$dwoo->output($tpl, $data);   
}

上面的PHP代码中，首先是用isCached()方法，判断缓存中是否有该文件，如果有的话则直接读取缓存中已经合成好的页面文件显示给用户，否则的话调用twitter的Atom公开API接口去查询关键字pasta，再输出到页面。输出结果如下图：

同时注意，$tpl = new Dwoo_Template_File('tmpl/tweets.tpl', 120, 'id_g75430i472j');中，第2个参数是缓存的过期时间，为120秒，第3个参数是缓存的名称，而且该名称在应用中必须是唯一的。

【编辑推荐】