【发布时间】: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>
我尝试在这个新的模板系统中通过set 和get 标签重新创建Content 和Container。它们旨在以完全相同的方式工作,当然,它们不是 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 ? '◀' : '▶'}}
</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}}"> </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,你为什么要这样做?我们已经有一个模板引擎,你为什么要创建它?