如何在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>