thecodingmachine / twig-universal-module
Twig的跨框架模块
1.1.x-dev
2018-08-19 19:50 UTC
Requires
- php: >=7.0
- container-interop/service-provider: ^0.4
- thecodingmachine/common-factories: ^0.4.1
- twig/twig: ^1.35.4 | ^2.5.0
Requires (Dev)
- mnapoli/simplex: ~0.5.0
- phpunit/phpunit: ^5.7.9
- satooshi/php-coveralls: ^1.0.1
README
Twig通用模块
本包可以将Twig集成到任何兼容container-interop/service-provider的框架/容器中。
安装
composer require thecodingmachine/twig-universal-module
安装完成后,您需要将TheCodingMachine\TwigServiceProvider
注册到您的容器中。
如果您的容器支持thecodingmachine/discovery集成,您不需要做任何事情。否则,请参考您的框架或容器的文档了解如何注册服务提供者。
简介
此服务提供者旨在创建一个基本的Twig_Environment
实例。
默认情况下,该实例应使用合理的默认值即可使用。我们尽量使默认值对大多数开发者都适用,同时仍然提供缓存以获得良好的性能。如果您正在寻找最佳性能,您可能需要调整设置。
用法
$twig = $container->get('Twig_Environement'); echo $twig->render('views/my.twig', [ 'foo' => 'bar' ]);
默认值
默认情况下
- 缓存已启用,位于临时系统目录下的一个目录中。在生产环境中,如果您正在运行多用户环境,您可能希望将其更改为只能由您读取的目录。
autoreload = true
:您可以安全地修改任何Twig文件,而无需清除缓存。在生产环境中,如果您正在寻找最佳性能,请将此设置为false
。- Twig文件将从项目根目录加载(即
composer.json
文件所在的目录)。您可以通过覆盖Twig_LoaderInterface
条目或Twig_Loader_Filesystem
条目来更改此设置。 - 默认情况下,
debug = true
,除非您在容器的DEBUG
条目中提供值。
预期值/服务
重要:当此服务提供者寻找服务时,它将首先查找以包名前缀的服务,然后查找直接的服务。因此,如果此文档指出DEBUG
条目被使用,则服务提供者将首先查找thecodingmachine.twig-universal-module.DEBUG
,然后查找DEBUG
。这允许您保持容器的整洁(只有一个DEBUG
条目),并且如果存在多个服务提供者使用该DEBUG
条目,并且您希望传递不同的值,则仍然可以只为该服务提供者编辑thecodingmachine.twig-universal-module.DEBUG
。
此服务提供者期望以下配置/服务可用
提供的服务
此服务提供者提供以下服务
扩展的服务
此服务提供者不扩展任何服务。