PHP的自定义模板引擎

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

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

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

<{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}>

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

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,<a href="mailto:d@d.com" rel="external nofollow">d@d.com</a>);

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

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

<?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('title',"自定义模板引擎");$tpl->assign('auto',"小火柴");
$tpl->assign('users',$data);
$tpl -> display("main.tpl");
?>