本文旨在介绍如何在 PHP 的 Handlebars 模板引擎中实现对 JavaScript Handlebars 中常见的无哈希非块助手（non-block helper）的支持。虽然 salesforce/handlebars-php 库本身不直接支持这种助手，但通过修改其核心文件，可以扩展其功能，实现类似的效果。下面将详细介绍具体的实现方法。
修改 Handlebars/Template.php 文件
为了实现无哈希非块助手，我们需要修改 salesforce/handlebars-php 库中的 Handlebars/Template.php 文件。具体来说，我们需要在 variables 函数中添加自定义逻辑。
找到 variables 函数
在 Handlebars/Template.php 文件中找到 private function variables(Context $context, $current, $escaped) 函数。这个函数负责处理模板中的变量。
添加自定义逻辑
在 variables 函数中，添加如下代码：
立即学习“PHP免费学习笔记（深入）”；
/* LS20211101 */
/* Check for non-block helpers {{{ */
// "Arguments" are subjected to a VERY simple parsing, with NO
// syntax check. Just simple variables (plus @index and @key)
// and strings between double quotes, parsed through
// dirty base64 glomping.
$words = preg_split('#\\s+#', $name, 2, PREG_SPLIT_NO_EMPTY);
$code = $words[0];
if ($this->handlebars->hasHelper($code)) {
$return = call_user_func_array(
$this->handlebars->getHelper($words[0]),
[
$this, // First argument is this template
$context, // Second is current context
implode(
' ',
array_map(
function ($token) use ($context) {
if ('"' === substr($token, 0, 1)) {
return base64_decode($token);
}
// If @data variables are not enabled, then revert back to legacy behavior
if ($token == '@index') {
return $context->lastIndex();
}
if ($token == '@key') {
return $context->lastKey();
}
return $context->get($token);
},
preg_split(
'#\\s+#',
preg_replace_callback(
'#"([^"]*)"#',
function ($matches) {
return '"' . base64_encode($matches[1]) . '"';
},
$words[1]
),
-1,
PREG_SPLIT_NO_EMPTY
)
)
), // Arguments
''
]);
if ($return instanceof String) {
return $this->handlebars->loadString($return)->render($context);
}
return $return;
}
/** }}} end */这段代码首先将变量名 $name 按照空格分割成多个单词，第一个单词被认为是助手的名称。然后，它检查 Handlebars 引擎是否注册了该助手。如果注册了，就调用该助手，并将当前模板、上下文和参数传递给它。参数的解析使用了简单的正则表达式，并且支持字符串参数（通过 base64 编码）。
示例
假设我们想要创建一个名为 checked 的助手，用于在复选框中添加 checked 属性。首先，我们需要注册这个助手：
$handlebars = new Handlebars\Handlebars();
$handlebars->addHelper('checked', function ($template, $context, $value) {
if ($value) {
return 'checked="checked"';
}
return '';
});然后，我们可以在模板中使用这个助手：
如果 record.acheckbox 的值为 true，那么渲染后的 HTML 将是：
注意事项
- 这种方法是对 salesforce/handlebars-php 库的修改，可能会影响库的升级。
- 参数的解析非常简单，没有进行严格的语法检查，因此需要确保模板中的参数格式正确。
- 字符串参数通过 base64 编码，这可能会增加一些额外的开销。
总结
通过修改 Handlebars/Template.php 文件，我们可以扩展 salesforce/handlebars-php 库的功能，实现对无哈希非块助手的支持。虽然这种方法有一些限制，但它可以让我们在 PHP 中使用类似 JavaScript Handlebars 的助手，从而提高模板的灵活性和可重用性。这种方法适用于需要在 PHP 和 JavaScript 中使用相同模板的情况，或者需要更灵活的助手功能的场景。
