PHP的自訂模板引擎的範例程式碼分享-php教程-PHP中文網

首頁

後端開發

php教程

PHP的自訂模板引擎的範例程式碼分享

黄舟

Mar 27, 2017 am 09:37 AM

php

本文將詳細介紹PHP中的模板引擎。具有很好的參考價值。下面跟著小編一起來看下吧

前面的話

在大多數的專案群組中，開發一個Web程式都會出現這樣的流程：規劃文件提交之後，前端工程師製作了網站的外觀模型，然後把它交給後端工程師，它們使用後端程式碼實現程式邏輯，同時使用外觀模型做成基本架構#，然後工程被返回到前端工程師繼續完善。就這樣工程可能在後端工程師和前端工程師之間來回好幾次。由於後端工程師不干預任何相關HTML標籤，同時也不需要前端程式碼和後端程式碼混合在一起。前端工程師只需要設定檔，動態區塊和其他的介面部分，不必要去接觸那些錯綜複雜的後端程式碼。因此，這時候有一個很好的模板支援就顯得很重要了。本文將詳細介紹PHP中的模板引擎

概述

什麼是網站模板？確切地說，是指網站頁面模板，即每個頁面僅是一個板式，包括結構、樣式和頁面佈局，是創建網頁內容的樣板，也可以理解為已有的網頁框架。可以將模板中原有的內容替換成從伺服器端資料庫中動態內容，目的是可以保持頁面風格一致

PHP是一種HTML內嵌式的在伺服器端執行的腳本語言，所以大部分PHP開發出來的Web應用，初始的開發模板就是混合層的資料程式設計。雖然透過MVC設計模式可以把程式應用邏輯與網頁呈現邏輯強制性分離，但也只是將應用程式的輸入、處理和輸出分開，網頁呈現邏輯(檢視)還會有HTML程式碼和PHP程式強耦合在一起。 PHP腳本的編寫者必須既是網頁設計者，也是PHP開發者

現在已經有許多解決方案，可以將網站的頁面設計和PHP應用程式幾乎完全分開。這些解決方案稱為“模板引擎”，它們正在逐步消除缺乏層次分離而帶來的難題。模板引擎的目的，就是要達到上述所提到的邏輯分離的功能。它能讓程式開發者專注於資料的控製或是功能的達成。因此，模板引擎很適合該公司的Web開發團隊使用，讓每個人都能發揮其專長

模板引擎技術的核心比較簡單。只要將前端頁面指定為範本文件，並將這個範本文件中動態的內容，如資料庫輸出、使用者互動等部分，定義成使用特殊“定界符”包含的“變數”，然後放在模板檔案中對應的位置。當使用者瀏覽時，由PHP腳本程式開啟該範本文件，並將範本文件中定義的變數進行替換。這樣，模板中的特殊變數被替換為不同的動態內容時，就會輸出所需的頁面

目前，可以在PHP中應用的並且比較成熟的模板有很多，例如Smarty、PHPLIB、IPB等幾十種。使用這些透過PHP編寫的模板引擎，可以讓程式碼脈絡更加清晰，結構更加合理化。也可以讓網站的維護和更新變得更容易，創造一個更良好的開發環境，讓開發和設計工作更容易結合在一起。但是，沒有哪一個PHP模板是最適合、最完美的。因為PHP模板就是大眾化的東西，並不是針對某個人開發的。如果能在對模板的特徵、應用有清楚的認識基礎上，充分認識到模板的優勢劣勢，就可以知道是否選擇使用模板引擎或選擇使用哪個模板引擎

自訂模板引擎類別

自訂模板引擎，能夠更好的掌握模板引擎的工作機制，為學習Smarty做好準備。更重要的是，屬於自己的PHP模板引擎永遠不是固定不變的，可以根據專案的需要為其量身定制

在下例中，透過前面介紹的模板引擎概念創建了屬於自己的一個簡單模板引擎，可以用來處理模板的基本功能。例如：變數替換、分支結構、陣列循環遍歷，以及模板之間相互嵌套等，如下所示：

<?php
 /**
  file: mytpl.class.php 类名为MyTpl是自定义的模板引擎
  通过该类对象加载模板文件并解析，将解析后的结果输出 
 */
 class Mytpl {
  public $template_dir = &#39;templates&#39;;  //定义模板文件存放的目录 
  public $compile_dir = &#39;templates_c&#39;;  //定义通过模板引擎组合后文件存放目录
  public $left_delimiter = &#39;<{&#39;;   //在模板中嵌入动态数据变量的左定界符号
  public $right_delimiter = &#39;}>&#39;;   //在模板中嵌入动态数据变量的右定界符号
  private $tpl_vars = array();    //内部使用的临时变量
  /** 
   将PHP中分配的值会保存到成员属性$tpl_vars中，用于将模板中对应的变量进行替换 
   @param string $tpl_var 需要一个字符串参数作为关联数组下标，要和模板中的变量名对应 
   @param mixed $value  需要一个标量类型的值，用来分配给模板中变量的值  
  */
  function assign($tpl_var, $value = null) { 
   if ($tpl_var != &#39;&#39;)     
    $this->tpl_vars[$tpl_var] = $value;
  }
  /** 
   加载指定目录下的模板文件，并将替换后的内容生成组合文件存放到另一个指定目录下
   @param string $fileName 提供模板文件的文件名            
  */
   function display($fileName) { 
   /* 到指定的目录中寻找模板文件 */
   $tplFile = $this->template_dir.&#39;/&#39;.$fileName; 
   /* 如果需要处理的模板文件不存在,则退出并报告错误 */
   if(!file_exists($tplFile)) {     
    die("模板文件{$tplFile}不存在！");
   }
   /* 获取组合的模板文件，该文件中的内容都是被替换过的 */
   $comFileName = $this->compile_dir."/com_".$fileName.&#39;.php&#39;; 
   /* 判断替换后的文件是否存在或是存在但有改动，都需要重新创建 */
   if(!file_exists($comFileName) || filemtime($comFileName) < filemtime($tplFile)) {
    /* 调用内部替换模板方法 */
    $repContent = $this->tpl_replace(file_get_contents($tplFile)); 
    /* 保存由系统组合后的脚本文件 */
    file_put_contents($comFileName, $repContent);
   }
   /* 包含处理后的模板文件输出给客户端 */
   include($comFileName);     
  }
  /** 
   内部使用的私有方法，使用正则表达式将模板文件&#39;<{ }>&#39;中的语句替换为对应的值或PHP代码 
   @param string $content 提供从模板文件中读入的全部内容字符串 
   @return $repContent   返回替换后的字符串
  */
  private function tpl_replace($content) {
   /* 将左右定界符号中，有影响正则的特殊符号转义 例如，<{ }>转义\<\{ \}\> */
   $left = preg_quote($this->left_delimiter, &#39;/&#39;);
   $right = preg_quote($this->right_delimiter, &#39;/&#39;);
   /* 匹配模板中各种标识符的正则表达式的模式数组 */
   $pattern = array(  
    /* 匹配模板中变量 ,例如，"<{ $var }>" */
    &#39;/&#39;.$left.&#39;\s*\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*&#39;.$right.&#39;/i&#39;,  
    /* 匹配模板中if标识符，例如 "<{ if $col == "sex" }> <{ /if }>" */
    &#39;/&#39;.$left.&#39;\s*if\s*(.+?)\s*&#39;.$right.&#39;(.+?)&#39;.$left.&#39;\s*\/if\s*&#39;.$right.&#39;/ies&#39;,
    /* 匹配elseif标识符, 例如 "<{ elseif $col == "sex" }>" */
    &#39;/&#39;.$left.&#39;\s*else\s*if\s*(.+?)\s*&#39;.$right.&#39;/ies&#39;, 
    /* 匹配else标识符, 例如 "<{ else }>" */
    &#39;/&#39;.$left.&#39;\s*else\s*&#39;.$right.&#39;/is&#39;, 
    /* 用来匹配模板中的loop标识符，用来遍历数组中的值, 例如 "<{ loop $arrs $value }> <{ /loop}>" */
    &#39;/&#39;.$left.&#39;\s*loop\s+\$(\S+)\s+\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*&#39;.$right.&#39;(.+?)&#39;.$left.&#39;\s*\/loop\s*&#39;.$right.&#39;/is&#39;,
    /* 用来遍历数组中的键和值,例如 "<{ loop $arrs $key => $value }> <{ /loop}>" */
    &#39;/&#39;.$left.&#39;\s*loop\s+\$(\S+)\s+\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*=>\s*\$(\S+)\s*&#39;.$right.&#39;(.+?)&#39;.$left.&#39;\s*\/loop \s*&#39;.$right.&#39;/is&#39;, 
    /* 匹配include标识符, 例如，&#39;<{ include "header.html" }>&#39; */
    &#39;/&#39;.$left.&#39;\s*include\s+[\"\&#39;]?(.+?)[\"\&#39;]?\s*&#39;.$right.&#39;/ie&#39;     
   );
   /* 替换从模板中使用正则表达式匹配到的字符串数组 */
   $replacement = array( 
    /* 替换模板中的变量 <?php echo $this->tpl_vars["var"]; */
    &#39;<?php echo $this->tpl_vars["${1}"]; ?>&#39;,  
    /* 替换模板中的if字符串 <?php if($col == "sex") { ?> <?php } ?> */
    &#39;$this->stripvtags(\&#39;<?php if(${1}) { ?>\&#39;,\&#39;${2}<?php } ?>\&#39;)&#39;,  
    /* 替换elseif的字符串 <?php } elseif($col == "sex") { ?> */
    &#39;$this->stripvtags(\&#39;<?php } elseif(${1}) { ?>\&#39;,"")&#39;, 
    /* 替换else的字符串 <?php } else { ?> */
    &#39;<?php } else { ?>&#39;, 
    /* 以下两条用来替换模板中的loop标识符为foreach格式 */
    &#39;<?php foreach($this->tpl_vars["${1}"] as $this->tpl_vars["${2}"]) { ?>${3}<?php } ?>&#39;, 
    &#39;<?php foreach($this->tpl_vars["${1}"] as $this->tpl_vars["${2}"] => $this->tpl_vars["${3}"]) { ?>${4}<?php } ?>&#39;, 
    /*替换include的字符串*/
    &#39;file_get_contents($this->template_dir."/${1}")&#39;    
   );
   /* 使用正则替换函数处理 */
   $repContent = preg_replace($pattern, $replacement, $content);  
   /* 如果还有要替换的标识,递归调用自己再次替换 */
   if(preg_match(&#39;/&#39;.$left.&#39;([^(&#39;.$right.&#39;)]{1,})&#39;.$right.&#39;/&#39;, $repContent)) {  
    $repContent = $this->tpl_replace($repContent);    
   } 
   /* 返回替换后的字符串 */
   return $repContent;          
  }
   /**
   内部使用的私有方法，用来将条件语句中使用的变量替换为对应的值
   @param string $expr  提供模板中条件语句的开始标记   
   @param string $statement 提供模板中条件语句的结束标记 
   @return strin    将处理后的条件语句相连后返回 
  */
  private function stripvtags($expr, $statement=&#39;&#39;) {
   /* 匹配变量的正则 */
   $var_pattern = &#39;/\s*\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*/is&#39;; 
   /* 将变量替换为值 */
   $expr = preg_replace($var_pattern, &#39;$this->tpl_vars["${1}"]&#39;, $expr); 
   /* 将开始标记中的引号转义替换 */
   $expr = str_replace("\\\"", "\"", $expr);
   /* 替换语句体和结束标记中的引号 */
   $statement = str_replace("\\\"", "\"", $statement); 
   /* 将处理后的条件语句相连后返回 */
   return $expr.$statement;        
  }
 }
?>

登入後複製

在Mytpl类中声明的多个方法中，除被封装过的方法之外，只有两个公有方法assign()和display()在创建对象以后可以被凋用。其中assign()方法用来将PHP脚本中的数据分配给模板中对应的变量，display()方法则用来将特定的templates目录下的模板文件加载到PHP脚本中。同时将模板文件中使用“<{”和“>>”标记声明的自定义模板语句，匹配出来并替换成相对应的PHP语法格式，然后将替换后的内容保存在特定的templates_c目录下。在运行时还要编译成一个非模板技术的PHP文件，并将其以模板文件名加上“com_”前缀和“.php”的扩展名形式保存。再通过include()函数将处理后的模板文件包含，并使用PHP解析后发送给客户端

使用模板引擎

使用自定义的模板引擎比较容易，都是自己定义的语法格式。但要记住，所有流行的模板引繁解决方案都遵循同样的一组相同的核心实现原则，就是与编程语言一样，学习了一种语言就可以更容易地掌握其他语言。使用模板引擎最主要的原因就是将前端工程师和后端工程师的工作分开，所以模板引擎不仅后端工程师需要使用，前端工程师也需要使用

1、后端工程师对模板引擎的使用

在PHP脚本中包含模板引擎类所在的文件。如下所示：

require("mytpl.class.php");    //包含模板引擎类，相当于模板引擎安装

登入後複製

创建模板引擎类的对象并对一些成员属性进行初始化赋值。如下所示：

$tpl=new MyTpl(); //创建模板引擎类的对象，也可以根据参数对成员初始化

将动态数据(包括标量和数组类型的数据，例如从数据库的表中获得的数据数组)使用模板引擎对象中的assign()方法分配给模板文件，这个方法可以使用多次，将任意多个变量分配给模板。如下所示：

$tpl->assign("var","this is a value"); //可以分配标量类型数据，可以使用多次
$tpl->assign("arr",array(array(1,2),array("a","b"))); //也可以分配数组包括多维数组

登入後複製

在PHP脚本中通过调用模板对象中的display()方法，并将模板文件名作为参数传入，就会加载指定目录中对应的模板文件到PHP脚本中。再通过模板引擎中的替换方法对模板中自定义的语法进行解析，然后输出处理后的模板。如下所示：

$tpl->display("test.tpl");    //参数“test.tpl”为特定目录下的模板文件

登入後複製

2、前端工程师对模板引擎的使用

前端工程师需要将编写的模板文件存放到指定的目录中，这个目录是通过在模板对象中使用$template_dir属性指定的，默认的设置是当前目录下的“templates”目录。另外，模板文件的命名以及后缀名的设置可以随意，例如index.tpl、test.htm、header.tp;等

模板文件是通过使用HTML、CSS以及javascript等Web前台语言以编写的纯静态负而。但可以在模板文件中使用“<{”和“}>”两个分隔符中间定义一个变量(类似PHP中的变量格式)，该变量可以接受并输出由PHP脚本中分配过来的动态数据。在模板中使用的“<{”和“}>”两个分隔符对，也可以根据个人爱好在模板引擎类中修改。如下所示：

姓名：<{$name}>，年龄：<{$age}>,性别:<{$sex}> //模板中使用占位符

如果在PHP脚本中是将数组分配给模板，也可以在模板中进行遍历，还可以通过嵌套的方式遍历多维数组。使用的是在模板引擎中定义的“<{loop}>”标记对，使用的方式和PHP中foreach结构的语法格式相似。如下所示：

<{loop $arr $value }>     //遍历数组$arr中的元素值
 数组中的元素值<{$value}>   //每次遍历输出元素中的值
<{/loop}>        //在模板中遍历数组的结束标记
<{loop $arr $key=>$value }>   //遍历数组$arr中的元素下标和元素值
 数组中的元素键<{$key}>    //每次遍历输出元素中的下标
 数组中的元素值<{$value}>   //每次遍历输出元素中的值
<{/loop}>        //在模板中遍历数组的结束标记
<{loop $arr $value }>     //遍历数组$arr中的元素值
 <{loop $arr $data }>    //使用嵌套标记遍历二维数组
  数组中的元素值<{$value}>  //每次遍历输出元素中的值
 <{/loop}>       //在模板中遍历数组的内层结束标记
<{/loop}>        //在模板中遍历数组的外层结束标记

登入後複製

模板引擎还可以解析在模板文件中使用特殊标记编写的分支结构，语法风格也是和PHP的分支结构类似。是通过在模板文件中使用“<{if}>”标记对实现选择结构，也可以实现多路分支和嵌套分支的选择结构。如下所示：

<{if($var=="red")}>
 <p style="color:red">这是“红色”的字</p>
<{elseif($var=="green")}> 
 <p style="color:green">这是“绿色”的字</p>
<{else}>
 <{if($size=20)}>
  <p style="font-size:20">这是“20px”大小的字</p>
 <{/if}>
<{/if}>

登入後複製

在自定义的模板引擎中，也添加了在模板文件中包含其他模板文件的功能。可以使用“<{include‘子模板文件名'}>”标记将子模板包含到当前模板中，还支持在子模板中再次包括另外的子模板。如下所示：

<{include &#39;other.tpl&#39; }>

登入後複製

使用示例分析

通过在程序中加载模板引擎可以将前端语言与后端语言的代码分开。首先在PHP程序中获取数据库中存储的数据，再通过加载模板引擎将数据分配出去，然后将模板文件再通过模板引擎加载并处理后输出。所以PHP程序只是创建动态数据，加载模板引擎并将动态数据分配给模板，完成了PHP程序的工作。而模板的设汁也只需要前端工程师独立完成，使用HTML、CSS及javascript等前台页面设计语言编写。另外，在模板文件中还需要使用模板引擎可以解析的标记，将PHP中分配过来的动态数据在模板中引用

1、数据库的设计

假设数据库服务器在“localhost”主机上，连接的用户名和密码分别为“admin”和“123456”，在该服务器上创建一个名为“mydb”的数据库，并在该数据库中创建一个名为“User”的用户表。创建该表的SQL査询语句如下所示：

CREATE TABLE User(
 id SMALLINT(3) NOT NULL AUTO_INCREMENT,
 name VARCHAR(10) NOT NULL DEFAULT &#39;&#39;,
 sex VARCHAR(4) NOT NULL DEFAULT &#39;&#39;,
 age SMALLINT(2) NOT NULL DEFAULT &#39;0&#39;,
 email VARCHAR(20) NOT NULL DEFAULT &#39;&#39;,
 PRIMARY KEY (id)
);

登入後複製

用户表User创建完成以后，接着可以向该表中插入一些数据作为示例演示使用，SQL查询语句如下所示:

INSERT INTO User (name,sex,age,email) VALUES 
("a","男",27,"a@a.com"),
("b","女",22,"b@b.com"),
("c","女",30,"c@c.com"),
("d","女",24,d@d.com);

登入後複製

2、模板的设计

模板的设计不要出现任何的PHP代码，可以由前端人员来完成。在自定义的模板引擎中，规定了要到指定的目录中去寻找模板文件，这个特定的目录可以在创建模板引擎对象时指定，也可以使用默认的目录设置，默认可以将模板文件存放在当前目录中的“templates”目录下。本例共需要三个模板文件main.tpl、header.tpl和footer.tpl，都存放在这个默认的目录设置中。这三个模板文件的代码如下所示：

模板的头部文件header.tpl

<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title> <{$title}> </title>
</head>
<body>

登入後複製

模板的尾部文件footer.tpl

  <p style="width:200px;margin: 0 auto;">##### <{$author}> #####</p>  
 </body>
</html>

登入後複製

主模板文件main.tpl

<{include &#39;header.tpl&#39;}>
 <table border="1" align="center" width="500">
  <{ loop $users $user }>
   <tr> 
    <{loop $user $u }>

      <{if $u == "男" }>
       <td style="color:green">
      <{elseif $u == "女"}>
       <td style="color:red">
      <{else}>
       <td>
      <{/if}>

       <{$u}></td>    
    <{/loop}>
   </tr>
  <{/loop}>
 </table>
<{include &#39;footer.tpl&#39;}>

登入後複製

文件main.tpl是主模板文件，在该文件中使用<{include"header.tpl"}>和<{include"footer.tpl"}>两个标记分别在该文件的顶部和底部，将独立的头部和尾部模板文件包含到这个主模板文件中。并在该文件中使用<{tableName}>标记获取从PHP中动态分配过来的表名，以及使用双层<{loop}>标记嵌套，遍历从PHP中动态分配过来的在数据库中获取到的二维数组$Users，还在<{loop}>标记中使用条件选择标记<{if}>组合，将数据中性别为“男”的表格背景设置为红色和一些其他判断。被包含进来的头部模板文件header.tpl和尾部模板文件footer.tpl也同样可以获取从PHP中动态分配给模板的数据

3、PHP程序设计

通过模板引擎的使用，PHP程序员在编写代码时，只需要PHP一种语言就可以了，不用再去使用HTML、CSS以及javascript等页面设计语言完成前端的工作了。下面是一个文件名为index.php的PHP脚本文件，和模板引擎类所在的文件mytpl_class.php在同一个目录下。代码如下所示：

<?php
 //包含模板引擎类
 include "mytpl.class.php";
 //创建模板引擎对象
 $tpl = new Mytpl;
 //连接数据库
 $pdo = new PDO("mysql:host=localhost;dbname=mydb", "admin", "123456");
 //执行SQL语句
 $stmt = $pdo -> prepare("select id, name, sex,age,email from User order by id");
 $stmt ->execute();
 $data = $stmt -> fetchAll(PDO::FETCH_ASSOC);
 //这是从数据库获取的动态数据，需要在模板中显示
 $tpl->assign(&#39;title&#39;,"自定义模板引擎");$tpl->assign(&#39;auto&#39;,"小火柴");
 $tpl->assign(&#39;users&#39;,$data);
 $tpl -> display("main.tpl");
?>

登入後複製

在上面的PHP脚本文件中，通过PDO对象连接MySQL服务器，并获取用户表User中的全部记录，并以PHP的二维数组变量形式保存在变量data中。接着使用包含进来的当前目录下的“mytplclss.php”文件，创建并初始化模板引擎类的对象data中。接着使用包含进来的当前目录下的“mytplclss.php”文件，创建并初始化模板引擎类的对象tpl。再通过该对象中的assign()方法向模板分配一些数据，然后使用该对象中的display()方法载入模板文件main.tpl。并将模板中标记的特殊变量替换为从PHP中分配的动态数据，处理完毕以后输出模板页面。页面的输出结果如下所示

限于各种不同的条件限制，比如时间、经验，做一个自定义的PHP模板引擎是非常困难的。其实，需要的并不是重新构造一个PHP模板，而是选择一个最贴近自己的PHP模板加以改造