技术开发 频道

PHP开发必备 PHP模版引擎Dwoo深入学习

  【IT168 专稿】在上一篇关于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”}区域中,重写了导航条的内容,最后输出为如下图:

Dwoo中模版的继承

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

{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区域的内容了,结果如下图:

Dwoo中模版的继承

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

  二、子模版

  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();      
}
?>

   可以看到输出如下:

子模版

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

  三、编写自己的插件

  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的功能。

  四、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:的邮件链接。结果如下输出:

DWOO的过滤器

  同样,也可以这样写:

<?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会自动加载。

  五、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,再输出到页面。输出结果如下图:

DWOO中的缓存

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

0
相关文章