README

将 Twig 集成到 ZF2 中。

安装

使用 composer

在您的 composer.json 中添加以下内容

{
    "require": {
        "appt/twig": "1.*"
    }
}

并在您的 application.config.php 中启用模块

return array(
    'modules' => array(
        'ApptTwig',
    )
);

用法

配置

模板

ApptTwig 支持使用常见的 Zend Framework 2 TemplateMapResolver 和 TemplatePathStack 加载器添加模板。

return array(
    'appt' => array(
        'twig' => array(
            'default_template_suffix' => 'twg', // you can change file extension used by TemplatePathStack
            'template_path_stack' => array(
                'dir/1/',
                'dir/2/'
            ),
            'template_map' => array(
                'layout/layout' => 'dir/layout.twig',
                'error' => __DIR__ . 'dir/error.twig',
            ),
        ),
    ),
);

Twig 选项

您可以在配置中更改 twig 引擎选项

return array(
 'appt' => array(
        'twig' => array(
            'engine_options' => array(
                'debug' => true, // turn on debug mode
            )
        ),
    ),
);

Twig 扩展

还可以添加新的 twig 扩展

return array(
    'appt' => array(
        'twig' => array(
            'extension_manager' => array(
                'factories' => array (
                    'ZendViewHelpers' => 'ApptTwig\Service\Extension\ZendViewHelpersFactory'
                )
            ),
        )
    )
);

所有扩展都必须实现 Twig_ExtensionInterface。

提供的服务

ApptTwig 提供以下服务

appt.twig.renderer -- 与 PhpRenderer 兼容的渲染器服务；appt.twig.renderer_strategy -- 渲染策略；
appt.twig.resolver -- 解析器服务扩展 Zend\View\Resolver\AggregateResolver，用于解析模板；appt.twig.extension_manager -- 用于管理 twig 扩展，它扩展了 Zend\ServiceManager\AbstractPluginManager。

渲染

当您在配置中设置解析器时，ApptTwig 准备好渲染视图模板，就像它是一个常规的 PhpRenderer 一样。您需要做的是在视图目录中创建模板。