thecodingmachine/twig-universal-module

1.1.x-dev 2018-08-19 19:50 UTC

This package is auto-updated.

Last update: 2024-09-06 23:21:09 UTC


README

Build Status Coverage Status

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

服务提供者期望以下配置/服务可用

提供的服务

服务提供者提供以下服务

扩展的服务

服务提供者不扩展任何服务。