PHP 循环模板引擎 - 从头开始

2022-08-31 01:12:07

对于一个小组项目,我正在尝试为PHP创建一个模板引擎,因为对语言经验不足的人可以在他们的HTML中使用{name}这样的标签,PHP会用数组中的预定义变量替换该标签。以及支持循环。

这远远超出了项目的预期,但是由于我有PHP的经验,我认为让我忙碌将是一个很好的挑战!

我的主要问题是,我如何做解析器的循环部分,这是实现这种系统的最佳方式吗?在您推荐现有的模板系统之前,我更愿意自己创建它以获得经验,因为我们项目中的所有内容都必须是我们自己的。

目前,基本的解析是用正则表达式和preg_replace_callback完成的,它会检查$data[name]是否存在,以及它是否确实替换了它。

我试图以各种不同的方式进行循环,但不确定我是否在正确的轨道上!

如果为解析引擎提供的数据,则示例为:

Array
(
    [title] => The Title
    [subtitle] => Subtitle
    [footer] => Foot
    [people] => Array
        (
            [0] => Array
                (
                    [name] => Steve
                    [surname] => Johnson
                )

            [1] => Array
                (
                    [name] => James
                    [surname] => Johnson
                )

            [2] => Array
                (
                    [name] => josh
                    [surname] => Smith
                )

        )

    [page] => Home
)

它解析的页面是这样的:

<html>
<title>{title}</title>
<body>
<h1>{subtitle}</h1>
{LOOP:people}
<b>{name}</b> {surname}<br />
{ENDLOOP:people}
<br /><br />
<i>{footer}</i>
</body>
</html>

它将产生类似于以下内容的内容:

<html>
<title>The Title</title>
<body>
<h1>Subtitle</h1>
<b>Steve</b> Johnson<br />
<b>James</b> Johnson<br />
<b>Josh</b> Smith<br />
<br /><br />
<i>Foot</i>
</body>
</html>

您的时间非常感激!

非常感谢,

附言:我完全不同意,因为我希望创建类似于已经存在的经验的东西,所以我的格式良好且易于理解的问题被投票否决。

P.P.S.似乎这个话题有大量的意见传播,请不要因为投票给人们有不同的意见而投票。每个人都有权拥有自己的权利!


答案 1

一个简单的方法是将模板转换为PHP并运行它。

$template = preg_replace('~\{(\w+)\}~', '<?php $this->showVariable(\'$1\'); ?>', $template);
$template = preg_replace('~\{LOOP:(\w+)\}~', '<?php foreach ($this->data[\'$1\'] as $ELEMENT): $this->wrap($ELEMENT); ?>', $template);
$template = preg_replace('~\{ENDLOOP:(\w+)\}~', '<?php $this->unwrap(); endforeach; ?>', $template);

例如,这会将模板标记转换为嵌入式 PHP 标记。

您将看到我引用了 、 和 。这就是我要实现的。$this->showVariable()$this->data$this->wrap()$this->unwrap()

该函数显示变量的内容。 并在每次迭代时调用以提供闭包。showVariablewrapunwrap

这是我的实现:

class TemplateEngine {
    function showVariable($name) {
        if (isset($this->data[$name])) {
            echo $this->data[$name];
        } else {
            echo '{' . $name . '}';
        }
    }
    function wrap($element) {
        $this->stack[] = $this->data;
        foreach ($element as $k => $v) {
            $this->data[$k] = $v;
        }
    }
    function unwrap() {
        $this->data = array_pop($this->stack);
    }
    function run() {
        ob_start ();
        eval (func_get_arg(0));
        return ob_get_clean();
    }
    function process($template, $data) {
        $this->data = $data;
        $this->stack = array();
        $template = str_replace('<', '<?php echo \'<\'; ?>', $template);
        $template = preg_replace('~\{(\w+)\}~', '<?php $this->showVariable(\'$1\'); ?>', $template);
        $template = preg_replace('~\{LOOP:(\w+)\}~', '<?php foreach ($this->data[\'$1\'] as $ELEMENT): $this->wrap($ELEMENT); ?>', $template);
        $template = preg_replace('~\{ENDLOOP:(\w+)\}~', '<?php $this->unwrap(); endforeach; ?>', $template);
        $template = '?>' . $template;
        return $this->run($template);
    }
}

在函数中,我使用堆栈来跟踪变量的当前状态。准确地说,将当前数据保存到堆栈中,然后将内部的变量添加到当前数据中,并将数据从堆栈中恢复回来。wrap()unwrap()wrap($ELEMENT)$ELEMENTunwrap()

为了提高安全性,我添加了这个额外的位来替换PHP回声:<

$template = str_replace('<', '<?php echo \'<\'; ?>', $template);

基本上是为了防止任何类型的直接注入PHP代码,无论是,,还是。<?<%<script language="php">

用法是这样的:

$engine = new TemplateEngine();
echo $engine->process($template, $data);

这不是最好的方法,但这是可以做到的一种方法。


答案 2

好的,首先让我解释一下,告诉你PHP是一个模板解析器

做你所做的事情就像从模板解析器创建一个模板解析器,毫无意义,坦率地说,它向我迭代了模板解析器,如smarty在毫无意义的任务中变得如此出色。

你应该做的是创建一个模板帮助器,而不是一个解析器,因为那里有冗余,在编程术语中,模板文件被称为视图,它们被赋予特定名称的原因之一是人们会知道与模型,域逻辑等分开

您应该做的是找到一种方法将所有视图数据封装在视图本身中。

例如,使用 2 个类

  • 模板
  • 模板范围

模板类的功能是让域逻辑将数据设置为视图并对其进行处理。

下面是一个简单示例:

class Template
{
    private $_tpl_data = array();

    public function __set($key,$data)
    {
        $this->_tpl_data[$key] = $data;
    }

    public function display($template,$display = true)
    {
        $Scope = new TemplateScope($template,$this->_tpl_data); //Inject into the view
        if($display === true) 
        {
            $Scope->Display();
            exit;
        }
        return $Scope;
    }
}

这是可以扩展的极其基本的东西,oko所以关于Scope,这基本上是一个类,你的视图在解释器中编译,这将允许你访问TemplateScope类内的方法,但不能访问scope类之外的方法,即名称。

class TemplateScope
{
    private $__data = array();
    private $compiled;
    public function __construct($template,$data)
    {
        $this->__data = $data;
        if(file_exists($template))
        {
            ob_start();
            require_once $template;
            $this->compiled = ob_get_contents();
            ob_end_clean();
        }
    }

    public function __get($key)
    {
        return isset($this->__data[$key]) ? $this->__data[$key] : null;
    }

    public function _Display()
    {
        if($this->compiled !== null)
        {
             return $this->compiled;
        }
    }

    public function bold($string)
    {
        return sprintf("<strong>%s</strong>",$string);
    }

    public function _include($file)
    { 
        require_once $file; // :)
    }
}

这只是基本的,不起作用,但概念就在那里,这里有一个用法示例:

$Template = new Template();

$Template->number = 1;
$Template->strings = "Hello World";
$Template->arrays = array(1,2,3,4)
$Template->resource = mysql_query("SELECT 1");
$Template->objects = new stdClass();
$Template->objects->depth - new stdClass();

$Template->display("index.php");

在模板中,你会使用传统的php,如下所示:

<?php $this->_include("header.php") ?>
<ul>
    <?php foreach($this->arrays as $a): ?>
        <li><?php echo $this->bold($a) ?></li>
    <?php endforeach; ?>
</ul>

这也允许您在模板中包含仍然具有关键字访问权限,然后包含它们自己,某种递归(但它不是)。$this

然后,不要在语法上创建缓存,因为没有要缓存的内容,您应该使用将预编译的源代码存储在内存中,跳过大部分编译/解释时间memcached


推荐