PHP实现简单的模板引擎功能示例


Posted in PHP onSeptember 02, 2017

本文实例讲述了PHP实现简单的模板引擎功能。分享给大家供大家参考,具体如下:

php web开发中广泛采取mvc的设计模式,controller传递给view层的数据,必须通过模板引擎才能解析出来。实现一个简单的仅仅包含if,foreach标签,解析$foo变量的模板引擎。

编写template模板类和compiler编译类。代码如下:

<?php
namespace foo\base;
use foo\base\Object;
use foo\base\Compiler;
/**
* 
*/
class Template extends Object
{
 private $_config = [
  'suffix' => '.php',//文件后缀名
  'templateDir' => '../views/',//模板所在文件夹
  'compileDir' => '../runtime/cache/views/',//编译后存放的目录
  'suffixCompile' => '.php',//编译后文件后缀
  'isReCacheHtml' => false,//是否需要重新编译成静态html文件
  'isSupportPhp' => true,//是否支持php的语法
  'cacheTime' => 0,//缓存时间,单位秒
 ];
 private $_file;//带编译模板文件
 private $_valueMap = [];//键值对
 private $_compiler;//编译器
 public function __construct($compiler, $config = [])
 {
  $this->_compiler = $compiler;
  $this->_config = array_merge($this->_config, $config);
 }
 /**
  * [assign 存储控制器分配的键值]
  * @param [type] $values [键值对集合]
  * @return [type]   [description]
  */
 public function assign($values)
 {
  if (is_array($values)) {
   $this->_valueMap = $values;
  } else {
   throw new \Exception('控制器分配给视图的值必须为数组!');
  }
  return $this;
 }
 /**
  * [show 展现视图]
  * @param [type] $file [带编译缓存的文件]
  * @return [type]  [description]
  */
 public function show($file)
 {
  $this->_file = $file;
  if (!is_file($this->path())) {
   throw new \Exception('模板文件'. $file . '不存在!');
  }
  $compileFile = $this->_config['compileDir'] . md5($file) . $this->_config['suffixCompile'];
  $cacheFile = $this->_config['compileDir'] . md5($file) . '.html';
  //编译后文件不存在或者缓存时间已到期,重新编译,重新生成html静态缓存
  if (!is_file($compileFile) || $this->isRecompile($compileFile)) {
   $this->_compiler->compile($this->path(), $compileFile, $this->_valueMap);
   $this->_config['isReCacheHtml'] = true;
   if ($this->isSupportPhp()) {
    extract($this->_valueMap, EXTR_OVERWRITE);//从数组中将变量导入到当前的符号表
   }
  }
  if ($this->isReCacheHtml()) {
   ob_start();
   ob_clean();
   include($compileFile);
   file_put_contents($cacheFile, ob_get_contents());
   ob_end_flush();
  } else {
   readfile($cacheFile);
  }
 }
 /**
  * [isRecompile 根据缓存时间判断是否需要重新编译]
  * @param [type] $compileFile [编译后的文件]
  * @return boolean    [description]
  */
 private function isRecompile($compileFile)
 {
  return time() - filemtime($compileFile) > $this->_config['cacheTime'];
 }
 /**
  * [isReCacheHtml 是否需要重新缓存静态html文件]
  * @return boolean [description]
  */
 private function isReCacheHtml()
 {
  return $this->_config['isReCacheHtml'];
 }
 /**
  * [isSupportPhp 是否支持php语法]
  * @return boolean [description]
  */
 private function isSupportPhp()
 {
  return $this->_config['isSupportPhp'];
 }
 /**
  * [path 获得模板文件路径]
  * @return [type] [description]
  */
 private function path()
 {
  return $this->_config['templateDir'] . $this->_file . $this->_config['suffix'];
 }
}
<?php
namespace foo\base;
use foo\base\Object;
/**
* 
*/
class Compiler extends Object
{
 private $_content;
 private $_valueMap = [];
 private $_patten = [
  '#\{\\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\}#',
  '#\{if (.*?)\}#',
  '#\{(else if|elseif) (.*?)\}#',
  '#\{else\}#',
  '#\{foreach \\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)}#',
  '#\{\/(foreach|if)}#',
  '#\{\\^(k|v)\}#',
 ];
 private $_translation = [
  "<?php echo \$this->_valueMap['\\1']; ?>",
  '<?php if (\\1) {?>',
  '<?php } else if (\\2) {?>',
  '<?php }else {?>',
  "<?php foreach (\$this->_valueMap['\\1'] as \$k => \$v) {?>",
  '<?php }?>',
  '<?php echo \$\\1?>'
 ];
 /**
  * [compile 编译模板文件]
  * @param [type] $source [模板文件]
  * @param [type] $destFile [编译后文件]
  * @param [type] $values [键值对]
  * @return [type]   [description]
  */
 public function compile($source, $destFile, $values)
 {
  $this->_content = file_get_contents($source);
  $this->_valueMap = $values;
  if (strpos($this->_content, '{$') !== false) {
   $this->_content = preg_replace($this->_patten, $this->_translation, $this->_content);
  }
  file_put_contents($destFile, $this->_content);
 }
}

我们的控制器就可以调用template中的assign方法进行赋值,show方法进行模板编译了。

/**
* [render 渲染模板文件]
* @param [type] $file   [待编译的文件]
* @param [type] $values   [键值对]
* @param array $templateConfig [编译配置]
* @return [type]     [description]
*/
protected function render($file, $values, $templateConfig = [])
{
  $di = Container::getInstance();
  //依赖注入实例化对象
  $di->template = function () use ($di, $templateConfig) {
   $di->compiler = 'foo\base\Compiler';
   $compiler = $di->compiler;
   return new \foo\base\Template($compiler, $templateConfig);
  };
  $di->template->assign($values)->show($file);
}

Container类如下:

<?php
namespace foo\base;
use foo\base\Object;
class Container extends Object
{
 private static $_instance;
 private $s = [];
 public static $instances = [];
 public static function getInstance()
 {
  if (!(self::$_instance instanceof self)) {
   self::$_instance = new self();
  }
  return self::$_instance;
 }
 private function __construct(){}
 private function __clone(){}
 public function __set($k, $c)
 {
  $this->s[$k] = $c;
 }
 public function __get($k)
 {
  return $this->build($this->s[$k]);
 }
 /**
  * 自动绑定(Autowiring)自动解析(Automatic Resolution)
  *
  * @param string $className
  * @return object
  * @throws Exception
  */
 public function build($className)
 {  
  // 如果是闭包函数(closures)
  if ($className instanceof \Closure) {
   // 执行闭包函数
   return $className($this);
  }
  if (isset(self::$instances[$className])) {
   return self::$instances[$className];
  }
  /** @var ReflectionClass $reflector */
  $reflector = new \ReflectionClass($className);
  // 检查类是否可实例化, 排除抽象类abstract和对象接口interface
  if (!$reflector->isInstantiable()) {
   throw new \Exception($reflector . ': 不能实例化该类!');
  }
  /** @var ReflectionMethod $constructor 获取类的构造函数 */
  $constructor = $reflector->getConstructor();
  // 若无构造函数,直接实例化并返回
  if (is_null($constructor)) {
   return new $className;
  }
  // 取构造函数参数,通过 ReflectionParameter 数组返回参数列表
  $parameters = $constructor->getParameters();
  // 递归解析构造函数的参数
  $dependencies = $this->getDependencies($parameters);
  // 创建一个类的新实例,给出的参数将传递到类的构造函数。
  $obj = $reflector->newInstanceArgs($dependencies);
  self::$instances[$className] = $obj;
  return $obj;
 }
 /**
  * @param array $parameters
  * @return array
  * @throws Exception
  */
 public function getDependencies($parameters)
 {
  $dependencies = [];
  /** @var ReflectionParameter $parameter */
  foreach ($parameters as $parameter) {
   /** @var ReflectionClass $dependency */
   $dependency = $parameter->getClass();
   if (is_null($dependency)) {
    // 是变量,有默认值则设置默认值
    $dependencies[] = $this->resolveNonClass($parameter);
   } else {
    // 是一个类,递归解析
    $dependencies[] = $this->build($dependency->name);
   }
  }
  return $dependencies;
 }
 /**
  * @param ReflectionParameter $parameter
  * @return mixed
  * @throws Exception
  */
 public function resolveNonClass($parameter)
 {
  // 有默认值则返回默认值
  if ($parameter->isDefaultValueAvailable()) {
   return $parameter->getDefaultValue();
  }
  throw new \Exception('I have no idea what to do here.');
 }
}

要想以键值对的方式访问对象的属性必须实现ArrayAccess接口的四个方法,

Object基类代码如下:

public function offsetExists($offset) 
{
  return array_key_exists($offset, get_object_vars($this));
}
public function offsetUnset($key) 
{
  if (array_key_exists($key, get_object_vars($this)) ) {
   unset($this->{$key});
  }
}
public function offsetSet($offset, $value) 
{
  $this->{$offset} = $value;
}
public function offsetGet($var) 
{
  return $this->$var;
}

在某一控制器中就可以调用父类Controller的render方法啦

$this->render('test\index', ['name' => 'tom', 'age' => 20, 'friends' => ['jack', 'rose']], ['cacheTime' => 10]);

编写视图模板文件'test\index':

<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>Document</title>
</head>
<body>
 <p>展示模板文件视图</p> 
 <p>{$name}</p>
 <p>{$age}</p>
 <?php echo ++$age;?>
 {if $age > 18}
  <p>已成年</p>
 {else if $age < 10}
  <p>小毛孩</p>
 {/if}
 {foreach $friends} 
  <p>{^v} </p>
 {/foreach}
</body>
</html>

至此,一个简单的模板编译引擎就写好了。

希望本文所述对大家PHP程序设计有所帮助。

PHP 相关文章推荐
简单的用PHP编写的导航条程序
Oct 09 PHP
探讨各种PHP字符串函数的总结分析
Jun 05 PHP
PHP 二维数组根据某个字段排序的具体实现
Jun 03 PHP
ThinkPHP模板判断输出Present标签用法详解
Jun 30 PHP
ThinkPHP中处理表单中的注意事项
Nov 22 PHP
php转换颜色为其反色的方法
Apr 27 PHP
yii添删改查实例
Nov 16 PHP
最新最全PHP生成制作验证码代码详解(推荐)
Jun 12 PHP
PHP获取当前日期及本周一是几月几号的方法
Mar 28 PHP
总结PHP代码规范、流程规范、git规范
Jun 18 PHP
PHP判断是否微信访问的方法示例
Mar 27 PHP
PHP使用PDO实现mysql防注入功能详解
Dec 20 PHP
PHP实现类似于C语言的文件读取及解析功能
Sep 01 #PHP
PHP设计模式之工厂模式实例总结
Sep 01 #PHP
浅谈关于PHP解决图片无损压缩的问题
Sep 01 #PHP
phpStudy配置多站点多域名和多端口的方法
Sep 01 #PHP
[原创]PHP获取数组表示的路径方法分析【数组转字符串】
Sep 01 #PHP
使用PHP连接数据库_实现用户数据的增删改查的整体操作示例
Sep 01 #PHP
php插件Xajax使用方法详解
Aug 31 #PHP
You might like
用PHP制作静态网站的模板框架(四)
2006/10/09 PHP
mysql5详细安装教程
2007/01/15 PHP
PHP 抓取新浪读书频道的小说并生成txt电子书的代码
2009/12/18 PHP
PHP PDOStatement:bindParam插入数据错误问题分析
2013/11/13 PHP
ThinkPHP3.1数据CURD操作快速入门
2014/06/19 PHP
Fastest way to build an HTML string(拼装html字符串的最快方法)
2011/08/20 Javascript
JQuery each()嵌套使用小结
2014/04/18 Javascript
js中各种类型的变量在if条件中是true还是false
2014/07/16 Javascript
js如何实现淡入淡出效果
2020/11/18 Javascript
原生js实现旋转木马轮播图效果
2017/02/27 Javascript
react实现pure render时bind(this)隐患需注意!
2017/03/09 Javascript
vue.js声明式渲染和条件与循环基础知识
2017/07/31 Javascript
使用Ajax和Jquery配合数据库实现下拉框的二级联动的示例
2018/01/25 jQuery
webstorm中配置Eslint的两种方式及差异比较详解
2018/10/19 Javascript
vue分页器组件编写方法详解
2019/06/28 Javascript
[59:42]Secret vs Alliacne 2019国际邀请赛小组赛 BO2 第一场 8.15
2019/08/17 DOTA
python代码检查工具pylint 让你的python更规范
2012/09/05 Python
Python中让MySQL查询结果返回字典类型的方法
2014/08/22 Python
使用简单工厂模式来进行Python的设计模式编程
2016/03/01 Python
Python tkinter事件高级用法实例
2018/01/31 Python
Python机器学习之K-Means聚类实现详解
2018/02/22 Python
python装饰器-限制函数调用次数的方法(10s调用一次)
2018/04/21 Python
Python3.7 pyodbc完美配置访问access数据库
2019/10/03 Python
Python批量安装卸载1000个apk的方法
2020/04/10 Python
Python新手学习函数默认参数设置
2020/06/03 Python
美国最大的农村生活方式零售店:Tractor Supply Company(TSC)
2017/05/15 全球购物
美国照明、家居装饰和家具购物网站:Bellacor
2017/09/20 全球购物
销售代表求职自荐信
2013/10/01 职场文书
大学生的网络创业计划书
2013/12/26 职场文书
中学生民族团结演讲稿
2014/08/27 职场文书
高一课前三分钟演讲稿
2014/09/13 职场文书
开展党的群众路线教育实践活动剖析材料
2014/10/13 职场文书
Python办公自动化PPT批量转换操作
2021/09/15 Python
Android Flutter实现图片滑动切换效果
2022/04/07 Java/Android
解决springboot druid数据库连接失败后一直重连的方法
2022/04/19 Java/Android
使用CSS实现百叶窗效果示例代码
2023/05/07 HTML / CSS