编译的容器
编辑该页面警告:你浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 5.2,不再维护。
读这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。
编译的容器
服务容器可以编译由于各种原因。这些原因包括检查任何潜在的问题,如循环引用和使容器更有效率的解决参数和删除未使用的服务。同时,某些特性,比如使用家长服务——需要编译的容器。
它是编制的运行:
1
美元容器- >编译();
编译方法使用编译器编译。DependencyInjection组件附带几个自动注册编译通过。例如CheckDefinitionValidityPass检查各种潜在问题的定义在容器中设置。这和其他几个过后,检查容器的有效性,进一步使用编译器优化配置缓存之前。例如,私人服务和抽象服务删除和别名解析。
管理配置和扩展
以及配置直接加载到容器中所示DependencyInjection组件通过注册扩展,您可以管理它的容器。编译过程的第一步是加载配置从任何扩展类注册的容器。直接与配置加载,他们只是当容器编译处理。如果您的应用程序模块化扩展允许每个模块注册和管理自己的服务配置。
扩展必须实现ExtensionInterface可以注册的容器:
1
美元容器- >registerExtension (美元扩展);
扩展的主要工作是做的load ()
方法。在load ()
方法你可以加载配置从一个或多个配置文件以及操作容器定义使用所示的方法如何使用服务定义对象。
的load ()
方法传递一个新的容器设置,然后合并之后进入容器注册。这允许您有几个独立扩展容器管理的定义。扩展不添加到容器配置时添加,但当容器的处理编译()
方法被调用。
可能只是一个非常简单的扩展配置文件加载到容器:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
使用欧宝娱乐app下载地址\组件\配置\FileLocator;使用欧宝娱乐app下载地址\组件\DependencyInjection\ContainerBuilder;使用欧宝娱乐app下载地址\组件\DependencyInjection\扩展\ExtensionInterface;使用欧宝娱乐app下载地址\组件\DependencyInjection\加载程序\XmlFileLoader;类AcmeDemoExtension实现了ExtensionInterface{公共函数负载(数组美元配置,ContainerBuilder美元容器){美元加载程序=新XmlFileLoader (美元容器,新FileLocator (__DIR__。“/ . . /资源/配置”));美元加载程序- >负载(“xml”);}/ /……}
这并不很获得比直接加载文件到整个容器。它允许将文件模块/包中分手。能够影响一个模块的配置配置文件之外的模块/包需要做一个复杂的应用程序配置。可以通过指定的配置文件直接加载到容器是为一个特定的扩展。这些部分的配置将不会处理由容器,而是直接相关的扩展。
扩展必须指定一个getAlias ()
方法实现的接口:
1 2 3 4 5 6 7 8 9 10 11
/ /……类AcmeDemoExtension实现了ExtensionInterface{/ /……公共函数getAlias(){返回“acme_demo”;}}
YAML的别名配置文件指定扩展作为一个关键将意味着这些值被传递到扩展的load ()
方法:
1 2 3 4
#……acme_demo:foo:fooValue栏:barValue
如果这个文件加载到配置的值只有当容器处理编译此时扩展加载:
1 2 3 4 5 6 7 8 9 10 11 12
使用欧宝娱乐app下载地址\组件\配置\FileLocator;使用欧宝娱乐app下载地址\组件\DependencyInjection\ContainerBuilder;使用欧宝娱乐app下载地址\组件\DependencyInjection\加载程序\YamlFileLoader;美元containerBuilder=新ContainerBuilder ();美元containerBuilder- >registerExtension (新AcmeDemoExtension);美元加载程序=新YamlFileLoader (美元containerBuilder,新FileLocator (__DIR__));美元加载程序- >负载(“config.yaml”);/ /……美元containerBuilder- >编译();
请注意
当加载配置文件,它使用一个扩展别名作为一个关键,扩展必须已经注册容器builder或者就会抛出一个异常。
配置文件的值从这些部分的第一个参数传递load ()
扩展的方法:
1 2 3 4 5
公共函数负载(数组美元配置,ContainerBuilder美元容器){美元喷火=美元配置(0][“foo”];/ / fooValue美元酒吧=美元配置(0][“酒吧”];/ / barValue}
的美元配置
参数是一个数组,其中包含每个不同的配置文件加载到容器中。你是只加载一个配置文件在上面的例子中,但仍将在一个数组中。数组是这样的:
1 2 3 4 5 6
[[“foo”= >“fooValue”,“酒吧”= >“barValue”),)
同时您可以手动管理合并不同的文件,它是更好的使用配置组件合并并验证配置的值。使用配置处理你可以访问配置值:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
使用欧宝娱乐app下载地址\组件\配置\定义\处理器;/ /……公共函数负载(数组美元配置,ContainerBuilder美元容器){美元配置=新配置();美元处理器=新处理器();美元配置=美元处理器- >processConfiguration (美元配置,美元配置);美元喷火=美元配置(“foo”];/ / fooValue美元酒吧=美元配置(“酒吧”];/ / barValue/ /……}
有两种方法必须实现。返回一个XML名称空间,这样一个XML配置文件的相关部分传递到扩展。其他指定的基本路径XSD文件来验证XML配置:
1 2 3 4 5 6 7 8 9
公共函数getXsdValidationBasePath(){返回__DIR__。“/ . . /资源/ config /”;}公共函数getNamespace(){返回“http://www.example.com/欧宝娱乐app下载地址symfony/schema/”;}
请注意
XSD验证是可选的,回来了假
从getXsdValidationBasePath ()
方法将禁用它。
XML版本的配置就会是这个样子:
1 2 3 4 5 6 7 8 9 10 11
< ?xml version = " 1.0 " encoding = " utf - 8 " ? ><容器xmlns=“http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/services”xmlns: xsi=“http://www.w3.org/2001/XMLSchema-instance”xmlns: acme_demo=“http://www.example.com/欧宝娱乐app下载地址symfony/schema/”xsi: schemaLocation=“http://www.example.com/欧宝娱乐app下载地址symfony/schema/ https://www.example.com/symfony/schema/hello-1.0.xsd”><acme_demo:配置><acme_demo: foo>fooValue< /acme_demo: foo><acme_demo:酒吧>barValue< /acme_demo:酒吧>< /acme_demo:配置>< /容器>
请注意
在Symfon欧宝娱乐app下载地址y的完整框架有一个扩展基类实现这些方法以及处理配置的快捷方法。看到如何加载服务配置在一个包吗为更多的细节。
处理配置值现在可以被添加作为容器参数就好像它是在一个上市参数
部分的配置文件,但是合并多个文件的额外好处和验证的配置:
1 2 3 4 5 6 7 8 9 10
公共函数负载(数组美元配置,ContainerBuilder美元容器){美元配置=新配置();美元处理器=新处理器();美元配置=美元处理器- >processConfiguration (美元配置,美元配置);美元容器- >setParameter (“acme_demo.FOO”,美元配置(“foo”]);/ /……}
更复杂的配置要求可以满足的扩展类。例如,您可以选择加载一个主要服务配置文件也加载一个次要一个只有一个特定的参数设置:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
公共函数负载(数组美元配置,ContainerBuilder美元容器){美元配置=新配置();美元处理器=新处理器();美元配置=美元处理器- >processConfiguration (美元配置,美元配置);美元加载程序=新XmlFileLoader (美元容器,新FileLocator (__DIR__。“/ . . /资源/配置”));美元加载程序- >负载(“xml”);如果(美元配置(“高级”){美元加载程序- >负载(“advanced.xml”);}}
请注意
就注册一个扩展容器不足以把它包括在编译扩展当容器处理。加载配置使用扩展的别名作为关键在上面的例子将确保它被加载。容器建造者也可以告诉加载它loadFromExtension ()方法:
1 2 3 4 5 6 7
使用欧宝娱乐app下载地址\组件\DependencyInjection\ContainerBuilder;美元containerBuilder=新ContainerBuilder ();美元扩展=新AcmeDemoExtension ();美元containerBuilder- >registerExtension (美元扩展);美元containerBuilder- >loadFromExtension (美元扩展- >getAlias ());美元containerBuilder- >编译();
请注意
如果你需要操作的配置加载的扩展你不能从另一个扩展,因为它使用一个新的容器。您应该使用一个编译器通过使用扩展后的集装箱整箱处理。
将配置传递到扩展
一个扩展可以预先考虑任何包之前的配置load ()
方法通过实施PrependExtensionInterface:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用欧宝娱乐app下载地址\组件\DependencyInjection\扩展\PrependExtensionInterface;/ /……类AcmeDemoExtension实现了ExtensionInterface,PrependExtensionInterface{/ /……公共函数预谋(ContainerBuilder美元容器){/ /……美元容器- >prependExtensionConfig (美元的名字,美元配置);/ /……}}
更多细节,请参阅如何简化配置多个包,这是特定于Symfony框架,但包含有关此功能的更多欧宝娱乐app下载地址细节。
执行代码在编译
您还可以执行自定义代码通过编写自己的编译器在编译通过。通过实现CompilerPassInterface在您的扩展,补充道过程()
方法将在编译时被称为:
1 2 3 4 5 6 7 8 9 10 11 12
/ /……使用欧宝娱乐app下载地址\组件\DependencyInjection\编译器\CompilerPassInterface;类AcmeDemoExtension实现了ExtensionInterface,CompilerPassInterface{公共函数过程(ContainerBuilder美元容器){/ /……在编译期间做些什么}/ /……}
作为过程()
被称为后加载所有的扩展,它允许您编辑服务定义的其他扩展以及检索服务定义的信息。
容器的参数描述和定义可以操作使用方法如何使用服务定义对象。
请注意
请注意过程()
在扩展的类称为方法PassConfig: TYPE_BEFORE_OPTIMIZATION
的一步。你可以阅读下一节如果你需要编辑容器在另一个步骤。
请注意
通常,只有使用服务定义在编译器通过,不创建服务实例。在实践中,这意味着使用方法有()
,findDefinition ()
,getDefinition ()
,setDefinition ()
等,而不是get ()
,设置()
等。
提示
确保你的编译器不需要通过服务存在。中止方法调用如果一些必需的服务不可用。
编译器的一个常见的用例是搜索所有服务定义有一定的标签以过程动态每个插入一些其他服务。上看到的部分服务标签了一个例子。
创建单独的编译器
有时,你需要在编译过程中多做一件事,想要使用编译器没有一个扩展或您需要执行一些代码在编译过程中的另一个步骤。在这些情况下,您可以创建一个新的类实现CompilerPassInterface
:
1 2 3 4 5 6 7 8 9 10
使用欧宝娱乐app下载地址\组件\DependencyInjection\编译器\CompilerPassInterface;使用欧宝娱乐app下载地址\组件\DependencyInjection\ContainerBuilder;类CustomPass实现了CompilerPassInterface{公共函数过程(ContainerBuilder美元容器){/ /……在编译期间做些什么}}
你需要注册您的自定义通过容器:
1 2 3 4
使用欧宝娱乐app下载地址\组件\DependencyInjection\ContainerBuilder;美元containerBuilder=新ContainerBuilder ();美元containerBuilder- >addCompilerPass (新CustomPass ());
请注意
不同的编译器通过注册如果您使用的是完整的框架,明白了如何使用编译器通行证吗为更多的细节。
控制通过订购
默认的编译器传递被分组到优化通过和删除。优化通过第一次运行,包括任务,比如解决内定义的引用。除通过执行任务,如消除私人别名和未使用的服务。注册时编译器通过使用addCompilerPass ()
时,您可以配置您的编译器通过运行。默认情况下,它们是之前运行优化。
您可以使用以下常量确定当你通过执行:
PassConfig: TYPE_BEFORE_OPTIMIZATION
PassConfig: TYPE_OPTIMIZE
PassConfig: TYPE_BEFORE_REMOVING
PassConfig: TYPE_REMOVE
PassConfig: TYPE_AFTER_REMOVING
例如,运行您的自定义通过默认删除过后一直运行,使用:
1 2 3 4 5
/ /……美元containerBuilder- >addCompilerPass (新PassConfig CustomPass ()::TYPE_AFTER_REMOVING);
您还可以控制编译器传递的顺序为每个编译运行阶段。使用可选的第三个参数addCompilerPass ()
设置优先级数量为整数。默认的优先级是0
早些时候,它的价值越高,执行:
1 2 3 4 5 6 7 8
/ /……/ / FirstPass SecondPass后执行,因为它的优先级较低美元容器- >addCompilerPass (新PassConfig FirstPass ()::TYPE_AFTER_REMOVING,10);美元容器- >addCompilerPass (新PassConfig SecondPass ()::TYPE_AFTER_REMOVING,30.);
倾销的配置性能
使用配置文件管理服务容器可以比使用PHP更容易理解一旦有很多服务。这缓解之际,价格虽然在性能配置文件需要解析和PHP配置构建。编译过程使容器更有效率,但这需要时间。你可以两全其美虽然通过使用配置文件,然后倾倒和缓存的配置。的PhpDumper
在倾销编译服务容器:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用欧宝娱乐app下载地址\组件\DependencyInjection\ContainerBuilder;使用欧宝娱乐app下载地址\组件\DependencyInjection\自动倾卸车\PhpDumper;美元文件=__DIR__。“/缓存/ container.php”;如果(file_exists (美元文件)){require_once美元文件;美元容器=新ProjectServiceContainer ();}其他的{美元containerBuilder=新ContainerBuilder ();/ /……美元containerBuilder- >编译();美元自动倾卸车=新PhpDumper (美元containerBuilder);写入美元文件,美元自动倾卸车- >dump ());}
ProjectServiceContainer
是默认的名字给甩了容器类。但是,你可以改变这一切类
选择转储时:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ /……美元文件=__DIR__。“/缓存/ container.php”;如果(file_exists (美元文件)){require_once美元文件;美元容器=新MyCachedContainer ();}其他的{美元containerBuilder=新ContainerBuilder ();/ /……美元containerBuilder- >编译();美元自动倾卸车=新PhpDumper (美元containerBuilder);写入美元文件,美元自动倾卸车- >转储([“类”= >“MyCachedContainer”)));}
你现在得到的速度PHP配置容器与易于使用的配置文件。此外倾销容器以这种方式进一步优化服务是如何创建的容器。
在上面的例子中,你需要删除缓存的容器文件当你进行任何更改。添加一个检查一个变量决定如果你在调试模式允许您保持缓存的容器的速度生产,但得到一个最新的配置同时开发您的应用程序:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日
/ /……/ /根据您的项目美元isDebug=……;美元文件=__DIR__。“/缓存/ container.php”;如果(!美元isDebug& & file_exists (美元文件)){require_once美元文件;美元容器=新MyCachedContainer ();}其他的{美元containerBuilder=新ContainerBuilder ();/ /……美元containerBuilder- >编译();如果(!美元isDebug){美元自动倾卸车=新PhpDumper (美元containerBuilder);写入美元文件,美元自动倾卸车- >转储([“类”= >“MyCachedContainer”)));}}
这可能进一步提高只重新编译容器在调试模式改变了它的配置,而不是在每一个请求。这可以通过缓存资源文件用于配置容器”中描述的方式基于资源的缓存“配置组件文档。欧宝体育电话
你不需要解决哪些文件缓存作为容器建设者跟踪所有的资源用于配置,不仅配置文件,扩展类和编译器。这意味着任何更改这些文件将失效缓存和触发容器被重建。你需要问这些资源和使用它们的容器作为缓存元数据:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
/ /……/ /根据您的项目美元isDebug=……;美元文件=__DIR__。“/缓存/ container.php”;美元containerConfigCache=新ConfigCache (美元文件,美元isDebug);如果(!美元containerConfigCache- >isFresh ()) {美元containerBuilder=新ContainerBuilder ();/ /……美元containerBuilder- >编译();美元自动倾卸车=新PhpDumper (美元containerBuilder);美元containerConfigCache- >写(美元自动倾卸车- >转储([“类”= >“MyCachedContainer”]),美元containerBuilder- >getresource ());}require_once美元文件;美元容器=新MyCachedContainer ();
现在使用缓存的容器倾倒无论是否调试模式。不同之处在于,ConfigCache
设置为调试模式的第二个构造函数参数。当缓存并不是在调试模式下缓存的容器将始终使用它是否存在。在调试模式下,一个额外的元数据文件编写与所有相关资源文件。然后检查他们的时间戳是否已经改变,如果他们有缓存将被视为失效。
请注意
完整的框架容器的编译和缓存是为你照顾。