在 PHP Handlebars 中实现无哈希非块助手-php教程-PHP中文网

在 PHP Handlebars 中实现无哈希非块助手

花韻仙語

发布： 2025-08-20 19:54:21

原创

939人浏览过

在 php handlebars 中实现无哈希非块助手

本文旨在介绍如何在 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 HandlebarsHandlebars();

$handlebars->addHelper('checked', function ($template, $context, $value) {
    if ($value) {
        return 'checked="checked"';
    }
    return '';
});

登录后复制

然后，我们可以在模板中使用这个助手：

<input name="acheckbox" {{checked record.acheckbox}} />

登录后复制

如果 record.acheckbox 的值为 true，那么渲染后的 HTML 将是：

<input name="acheckbox" checked="checked" />

登录后复制

注意事项

这种方法是对 salesforce/handlebars-php 库的修改，可能会影响库的升级。
参数的解析非常简单，没有进行严格的语法检查，因此需要确保模板中的参数格式正确。
字符串参数通过 base64 编码，这可能会增加一些额外的开销。

总结

通过修改 Handlebars/Template.php 文件，我们可以扩展 salesforce/handlebars-php 库的功能，实现对无哈希非块助手的支持。虽然这种方法有一些限制，但它可以让我们在 PHP 中使用类似 JavaScript Handlebars 的助手，从而提高模板的灵活性和可重用性。这种方法适用于需要在 PHP 和 JavaScript 中使用相同模板的情况，或者需要更灵活的助手功能的场景。

以上就是在 PHP Handlebars 中实现无哈希非块助手的详细内容，更多请关注php中文网其它相关文章！