简单的PHP模板,继续

时间:2010-10-25 21:50:36

标签: php regex templates

背景


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

  • 不需要; PHP本身就是一种非常好的模板语言。
  • 很难开发出一种既有力又容易让设计师与(或周围)合作的模板语言。
  • 已经完成,使用模板框架X。
  • 你真傻。

所有这些要点对他们都有一定的效力。记住它们,我继续进行模板化的事情,现在我回来了更多的问题。 :)

概述


目标

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

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

希望听起来不错。请注意,目标中的是“阻止模板作者执行 X ”或“模板将由匿名用户提供”。安全性是一个主要问题,不仅仅是普通的非模板化php文件。

规则

  • 默认转义序列为{{...}}。*
    • 如果没有其他规则匹配,则回显或评估序列
      • 如果序列以分号结尾,则评估整个序列
      • 否则,回显第一个表达式并评估其余表达
  • {{for|foreach|if|switch|while (...):}}开始阻止。
    • 条件中的括号可以省略
    • 冒号可以省略
    • 可以省略外右支架以进行支架匹配。**
  • {{else|elseif|break|continue|case|default}}做你期望的事。
    • 条件中的括号可以省略
    • {li>可以在{{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>

我尝试在这个新的模板系统中通过ContentContainer标签重新创建setget。它们的工作方式完全相同,当然,它们不是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}}之间某种合理的中间立场(参见代码和示例)。

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

  • 语法好吗?回应事物的线条,做事情的线条和流量控制线条在语法上会有更多不同吗?可选的外部支架如何匹配...傻?

期待听到大家的意见。

1 个答案:

答案 0 :(得分:5)

  

最小语法。

<?=$variable?>http://phptemplatinglanguage.com/

  

生成干净的PHP代码。

这对我来说看起来不太干净。

  

不要破坏html语法高亮。

你破坏了PHP语法高亮,我发现比破坏HTML语法高亮更有问题。如果你有一个更好的编辑器,了解PHP和HTML如何交互(我使用Textmate),这甚至不是一个问题。

  

不需要php开发人员学习任何新内容(好吧,不多)。

普通PHP已经符合条件。

  

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

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

  

支持内联php。

普通PHP支持内联PHP。

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