【问题标题】:Dirt-simple PHP templates, continued [closed]简单的 PHP 模板,继续 [关闭]
【发布时间】:2010-10-25 21:50:36
【问题描述】:

背景


所以,last time我询问了PHP模板,我得到了很多回复,例如:

  • 不需要; PHP 本身就是一种足够好的模板语言。
  • 很难开发一种既强大又易于设计师使用(或周围)的模板语言。
  • 已经完成,使用模板框架 X。
  • 你太傻了。

所有这些观点对他们都有一定的有效性。牢记它们,我继续做模板的事情,现在我又带着更多的问题回来了。 :)

概述


目标

以下是此模板引擎的目标:

  • 最少的语法。
  • 生成干净的 php 代码。
  • 不要破坏 html 语法高亮显示。
  • php 开发人员无需学习任何新东西(嗯,不多)。
  • 支持大部分 php 流控制(除了做..while 之外的一切)。
  • 支持内联php。

希望这听起来不错。请注意,目标中是诸如“防止模板作者执行X”或“模板将由匿名用户提供”之类的内容。安全性不是这里的主要问题,就像在普通的非模板化 php 文件中一样。

规则

  • 默认转义序列是{{...}}.*
    • 如果没有其他规则匹配,回显或评估序列
      • 如果序列以分号结尾,则评估整个序列
      • 否则,回显第一个表达式并计算其余的表达式
  • {{for|foreach|if|switch|while (...):}} 开始一个块。
    • 条件中的括号可以省略
    • 冒号可以省略
    • 括号匹配可以省略外部右括号。**
  • {{else|elseif|break|continue|case|default}} 做你想做的事。
    • 条件中的括号可以省略
    • {{case}} 上的右外括号可以省略以进行括号匹配。
    • {{break|continue}} 上的左外括号可以省略以进行括号匹配。
  • {{end}} 结束一个块。
    • 单词字符可以附加到'end',例如'end_if'
    • 括号匹配可以省略外部左括号。

* 可以使用自定义括号。
** 可以禁用括号匹配语法。

模板

到目前为止,我们实际上只是想出了<?php...?><?=...?> 的替代语法。为了真正有用,我们需要一些特定于模板的操作。

我工作的另一个模板框架使用了一个简单的容器/内容范例,在这里应该可以很好地工作。该模板系统是基于 xml 的,所以代码看起来像这样......

<!-- in a template -->
<html>
  <head>
    <tt:Container name="script" />
  </head>
  <body>
    <tt:Container name="main" />
  </body>
</html>

<!-- in a page -->
<tt:Content name="script">
  <script src="foo.js"></script>
</tt:Content>
<tt:Content name="main">
  <div>...</div>
</tt:Content>

同名内容区域的多个声明会替换之前的内容,但是之前的内容会通过Container在Content标签内可用,所以:

<tt:Content name="script">
  <script src="foo.js"></script>
</tt:Content>
...
<tt:Content name="script">
  <script src="bar.js"></script>
  <tt:Container name="script" />
</tt:Content>
...
<tt:Container name="script" />

应该输出:

  <script src="bar.js"></script>
  <script src="foo.js"></script>

我尝试在这个新的模板系统中通过setget 标签重新创建ContentContainer。它们旨在以完全相同的方式工作,当然,它们不是 xml 标签。

代码


事不宜迟:

<?php

class Detemplate {

  public  $container_prefix='_tpl_';
  public  $brackets='{}';
  public  $bracket_matching=true;
  public  $use_cache=false;

  private $block_keywords=array('for','foreach','if','switch','while');
  private $set_count;
  private $get_count;

  public function parse_file ($file, $vars=array()) {
    $sha1=sha1($file);
    $cache = dirname(__FILE__)."/cache/".basename($file).".$sha1.php";
    $f = "{$this->container_prefix}page_{$sha1}_";
    if (!$this->use_cache || !file_exists($cache) || filemtime($cache)<filemtime($file)) {
      $php =  "<?php function $f {$this->t_vars()} ?>".
              $this->parse_markup(file_get_contents($file)).
              "<?php } ?>";
      file_put_contents($cache, $php);
    }
    include $cache;
    $f($vars);
  }

  public function parse_markup ($markup) {

    $blocks=implode('|', $this->block_keywords);

    $arglist= '\s*[\s(](.*?)\)?\s*';  // capture an argument list
    $word=    '\s*(\w+)\s*';          // capture a single word

    $l='\\'.$this->brackets{0}; // left bracket
    $r='\\'.$this->brackets{1}; // right bracket

    $dl="#$l$l";
    $sl=$this->bracket_matching ? "#$l?$l" : $dl;
    $dr="$r$r(?!:$r)#"; 
    $sr=$this->bracket_matching ? "$r$r?(?!:$r)#" : $dr; 

    $markup=preg_replace_callback(
      array (
        $sl.'(end)[_\w]*\s*;?\s*'.$dr,
        $dl.'(el)se\s*if'.$arglist.':?\s*'.$dr,
        $dl.'(else)\s*:?\s*'.$dr,
        $dl.'(case)'.$word.':?\s*'.$sr, 
        $dl.'(default)()\s*:?\s*'.$sr,
        $sl.'(break|continue)\s*;?\s*'.$dr,
        $dl.'(set)'.$word.':?\s*'.$sr, 
        $dl.'(get)'.$word.':?\s*'.$dr, 
        $dl.'(parse)'.$word.':?\s*'.$dr, 
        $dl.'(function|fn)'.$word.$arglist.':?\s*'.$sr,
        $dl.'('.$blocks.')'.$arglist.':?\s*'.$sr,
        '#('.$l.$l.')(.+?)(;?)\s*'.$dr, 
        '#\s*(\?)>[\s\n]*<\?php\s*#',
      ),
      array($this, 'preg_callback'),
      $markup);

    return $markup;

  }

  private function preg_callback ($m) {

    switch ($m[1]) {

      // end of block

      case "end":
        return "<?php } } ?>";

      // keywords with special handling

      case "el": // elseif
        return "<?php } elseif ({$m[2]}) { ?>";
      case "else":
        return "<?php } else { ?>";

      case "case": case "default":
         return "<?php {$m[1]} {$m[2]}: ?>";

      case "break": case "continue":
        return "<?php {$m[1]}; ?>";

      // parse an external template document

      case "parse":
        return $this->parse_markup(file_get_contents($m[2]));

      // save / load content sections

      case "set":
        $i=++$this->set_count[$m[2]];
        $f=$this->t_fn($m[2], $i);
        $p=$this->t_fn($m[2], $i-1);
        $v=$this->t_fn_alias($m[2]);
        return  "<?php if (!function_exists('$f')) { $v='$f'; ".
          "function $f {$this->t_vars()} unset ($v); $v='$p'; ?>";

      case "get":
        $i=++$this->get_count[$m[2]];
        $c=$this->t_fn_ctx($m[2], $i);
        $v=$this->t_tmp();
        $a=$this->t_fn_alias($m[2]);
        return  "<?php if (!$c) { ".
          "foreach (array_keys(get_defined_vars()) as $v) $c".  
          "[$v]=&\$$v; unset($v); } $a(&$c); ?>";


      case "function": case "fn":
        return "<?php if (!function_exists('{$m[2]}')) { ".
          "function {$m[2]} ({$m[3]}) { ?>";

      // echo / interpret

      case "{{":
        return "<?php".($m[3]?"":" echo")." {$m[2]}; ?>";

      // merge adjacent php tags

      case "?": 
        return " ";
    }

    // block keywords
    if (in_array($m[1], $this->block_keywords)) {
      return "<?php { {$m[1]} ({$m[2]}) { ?>";
    }

  } 

  private function t_fn ($name, $index) {
    if ($index<1) return "is_null";
    return "{$this->container_prefix}{$name}_$index";
  }

  private function t_fn_alias ($name) {
    return "\${$this->container_prefix}['fn_$name']";
  }

  private function t_fn_ctx ($name, $index) {
    return "\${$this->container_prefix}['ctx_{$name}_$index']";
  }

  private function t_vars () {
      $v=$this->t_tmp();
      return "($v) { extract($v); unset($v);";
  }

  private function t_tmp () {
      return '$'.$this->container_prefix.'v';
  }


}

?>

示例模板 html:

<script>var _lang = {{json_encode($lang)}};</script>
<script src='/cartel/static/inventory.js'></script>
<link href='/cartel/static/inventory.css' type='text/css' rel='stylesheet' />

<form class="inquiry" method="post" action="process.php" onsubmit="return validate(this)">

  <div class="filter">
    <h2>{{$lang['T_FILTER_TITLE']}}</h2> 
    <a href='#{{urlencode($lang['T_FILTER_ALL'])}}' onclick='applyFilter();'>{{$lang['T_FILTER_ALL']}}</a>
  {{foreach ($filters as $f)}}
    <a href='#{{urlencode($f)}}' onclick='applyFilter("c_{{urlencode($f)}}");'>{{$f}}</a>
  {{end}}
  </div>

  <table class="inventory" id="inventory_table">  

  {{foreach $row_array as $row_num=>$r}

    {{if $row_num==0}

    <tr class='static'>
      {{foreach $r as $col}
      <th>{{$col}}</th>
      {end}} 
      <th class='ordercol'>{{$lang['T_ORDER']}}</th>
    </tr>

    {{else}}


    {{function spin_button $id, $dir, $max}
    <a href='#' class='spinbutton' 
       onclick="return spin('{{$id}}', {{$dir}}, {{$max}})">
      {{$dir==-1 ? '&#x25C0;' : '&#x25B6;'}}
    </a>
    {end}}

    <tr class="{{'c_'.urlencode($r[$man_col])}}">
      {{foreach $r as $i=>$col}
      <td class='{{$i?"col":"firstcol"}}'>{{$col}}</td>
      {end}}
      <td class='ordercol'>
        {{$id="part_{$r[$part_col]}"; $max=$r[$qty_col];}}
        {{spin_button($id, -1, $max)}}
        <input  onchange="spin(this.id, 0, '{{$max}}')" 
                id='{{$id}}' name='{{$id}}'type='text' value='0' />
        {{spin_button($id, +1, $max)}}
      </td>
    </tr>

    {end}}


  {end}}

    <tr class="static"><th colspan="{{$cols+1}}">{{$lang['T_FORM_HELP']}}</th></tr>

  {{foreach $fields as $f}

    <tr class="static">
      <td class="fields" colspan="2">
        <label for="{{$f[0]}}">{{$f[1]}}</label>
      </td>
      <td class="fields" colspan="{{$cols-1}}">
          <input name="{{$f[0]}}" id="{{$f[0]}}" type="text" />
      </td>
    </tr>

  {end}}

    <tr class="static">
      <td id="validation" class="send" colspan="{{$cols}}">&nbsp;</td>
      <td colspan="1" class="send"><input type="submit" value="{{$lang['T_SEND']}}" /></td>
    </tr>

  </table>

</form>

问题


我有几个关于如何处理这件事的问题。有些有明确的答案,有些可能是更多的CW材料......

  • set/get 会产生混乱的代码。可以改进吗?我正在寻找 set/get 和 {{function}} 之间的某种明智的中间立场(参见代码和示例)。

  • 流行的模板语言缺少什么?

  • 语法正常吗?呼应事物的行、执行事物的行和流控制行在语法上是否应该更加不同?用于匹配的可选外括号怎么样...傻?

期待听到大家对此的意见。

【问题讨论】:

  • 我只是……无法……明白……为什么……
  • 没有冒犯,但是WTF???? thedailywtf.com/Articles/We-Use-BobX.aspx 请不要让任何人使用它。了解 MVC。使用 css 来设置样式。 Clean html 和 VANILLA php 是你的朋友。
  • @no 你没有答案是有原因的。稍微思考一下。
  • @no,尽管做这样的事情很有趣,但到了维护代码的时候,你的继任者会诅咒你的。不管你觉得它多么优雅。这就是 boxx 链接的重点。对不起,如果我冒犯了你,但多年来我不得不在 php 中处理太多不同的自定义模板引擎(以及 tcl 和 perl 等)。也许我老了,但我对那些不再做这些事情的程序员没有耐心。我衷心祝愿您的项目好运,为您的模板引擎留下一些文档。
  • 这不是他们都烂的事实,而是他们不需要的事实。这就像创建一个使用 for 循环来模仿 foreach 的类。我们已经有一个 foreach,你为什么要这样做?我们已经有一个模板引擎,你为什么要创建它?

标签: php regex templates


【解决方案1】:

最少的语法。

&lt;?=$variable?&gt;http://phptemplatinglanguage.com/

生成干净的 php 代码。

这在我看来不是很干净。

不要破坏 html 语法高亮显示。

您正在破坏 PHP 语法突出显示,我发现这比破坏 HTML 语法突出显示更成问题。如果你有一个更好的编辑器来理解 PHP 和 HTML 如何交互(我使用 Textmate),这甚至都不是问题。

php 开发人员无需学习任何新东西(嗯,不多)。

普通 PHP 已经符合条件了。

支持大部分 php 流控制(除了 do..while 之外的一切)。

普通 PHP 支持所有 PHP 流控制。

支持内联php。

普通 PHP 支持内联 PHP。

总而言之,我认为这种方法没有任何好处,当然不会超过成熟的现有 PHP 框架和模板引擎。

【讨论】:

  • 你没有回答他的任何问题,你反驳了他的目标。
  • @mario “我有几个关于如何处理这件事的问题”和“期待听到大家对此的意见”。我对这两个组成部分的回答是“不要”和“亲爱的上帝”。
  • 我可能同意一般的“不要”,但很明显,这些建议没有帮助,也没有明确要求。
  • @mario,我认为他们很有帮助。为什么要在模板引擎之上编写模板引擎?为什么停在那里?为什么不在 php 之上的 smarty 之上做一个模板引擎呢?
  • 有时,“如果我用这把锤子敲我的头,如何防止它受伤”的最佳答案是“不要敲你的头”。
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 2014-07-17
  • 1970-01-01
  • 1970-01-01
  • 2017-03-29
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多