php - 如何在 Volt (Phalcon) 中设置用户定义的函数

Question

如何在 Volt 中设置用户定义函数？例如，我想调用一个函数来翻译我的视图中的字符串，如下所示：

<div class='page-header'>
    <h2>{{ tr('session_login_title') }}</h2>
</div>

我想tr映射到一个函数\My\Locale::translate($key)

Answer 1

Volt 函数充当字符串替换，实际上并不调用底层函数。Volt 将函数翻译成相关的字符串，然后由 PHP 解释。

假设你有一个Locale类，它有translate这样的方法：

public static function translate()
{
    $return = '';

    if (isset(self::$_phrases[$key]))
    {
        $return = self::$_phrases[$key];
    }

    return $return;
}

此方法使用$_phrases内部数组查找您传递的相关键并返回您想要的短语的文本。如果未找到，则返回一个空字符串。

现在我们需要在 Volt 中注册该函数。

    $di->set(
        'volt',
        function($view, $di) use($config)
        {
            $volt = new \Phalcon\Mvc\View\Engine\Volt($view, $di);
            $volt->setOptions(
                array(
                    'compiledPath'      => $config->app_volt->path,
                    'compiledExtension' => $config->app_volt->extension,
                    'compiledSeparator' => $config->app_volt->separator,
                    'stat'              => (bool) $config->app_volt->stat,
                )
            );
            $volt->getCompiler()->addFunction(
                'tr',
                function($key)
                {
                    return "\\My\\Locale::translate({$key})";
                }
            );

            return $volt;
        },
        true
    );

注意tr函数是如何注册的。\My\Locale::translate({$key})它返回一个带有传递$key参数的字符串。此 Volt 语法将被转换为 PHP 指令并由 PHP 执行。因此视图字符串：

<div class='page-header'>
    <h2>{{ tr('session_login_title') }}</h2>
</div>

在 Volt 处理之后，它变成：

<div class='page-header'>
    <h2><?php echo \My\Locale::translate('session_login_title') ?></h2>
</div>