如何装修服务
编辑该页面如何装修服务
覆盖现有的定义时,原始服务丢失:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8
#配置/ services.yaml服务:App \梅勒:~#这替换旧应用程序\梅勒与新的定义,#老定义是迷路了App \梅勒:类:App \ NewMailer大多数时候,这正是你想做的事。但有时,你可能想要装修旧相反(即应用装饰器模式)。在这种情况下,旧的服务应该保持在能够引用它。这个配置替换App \梅勒一个新的,但保持旧的一个参考在:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8
#配置/ services.yaml服务:App \梅勒:~App \ DecoratingMailer:#覆盖App \梅勒服务#但服务仍然可用“。”装饰:App \梅勒的装修选项告诉容器App \ DecoratingMailer服务取代了App \梅勒服务。如果你使用默认的服务。yaml的配置时,装饰服务是自动注入装修服务有一个参数的构造函数type-hinted与装饰服务类。
如果你不使用自动装配或装修服务有多个构造函数参数type-hinted与装饰服务类,您必须显式地注入装饰服务(装饰的ID服务会自动改变“。”):
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8
#配置/ services.yaml服务:App \梅勒:~App \ DecoratingMailer:装饰:App \梅勒#通过旧服务作为参数参数:(“@.inner”)5.1
特殊的在价值是在Symfony 5.1中引入的。ob娱乐下载在以前的版本中你需要使用:decorating_service_id +“。”。
提示
装饰的可见性App \梅勒服务新服务(别名)仍将是和原来的一样App \梅勒可见性。
请注意
生成的内部id是基于id的装饰服务(App \ DecoratingMailer),而不是装饰的服务(App \梅勒这里)。你可以通过控制内部服务的名字decoration_inner_name选择:
- YAML
- XML
- PHP
1 2 3 4 5 6
#配置/ services.yaml服务:App \ DecoratingMailer:#……decoration_inner_name:App \ DecoratingMailer.wooz参数:(“@App \ DecoratingMailer.wooz”)装饰的优先级
将多个修饰符应用于服务时,您可以控制它们的顺序decoration_priority选择。它的值是一个整数,默认0和更高的优先级意味着修饰符将被应用。
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13
#配置/ services.yaml服务:Foo:~栏:装饰:喷火decoration_priority:5参数:(“@.inner”)记者:装饰:喷火decoration_priority:1参数:(“@.inner”)生成的代码如下:
1
美元这- >服务(Foo::类]=新巴兹(新栏(新Foo ()));叠加修饰符
另一种使用装饰重点是创建一个堆栈订购服务,每一个装饰下:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日
#配置/ services.yaml服务:decorated_foo_stack:栈:- - - - - -类:巴兹参数:(“@.inner”)- - - - - -类:酒吧参数:(“@.inner”)- - - - - -类:喷火#使用简单的语法:decorated_foo_stack:栈:- - - - - -记者:(“@.inner”)- - - - - -栏:(“@.inner”)- - - - - -Foo:~#可以简化启用自动装配时:decorated_foo_stack:栈:- - - - - -记者:~- - - - - -栏:~- - - - - -Foo:~结果将是一样的在前一节中:
1
美元这- >服务(“decorated_foo_stack”]=新巴兹(新栏(新Foo ()));像别名,堆栈只能使用公共和弃用属性。
每一帧的堆栈可以是一个内联的服务,或一个孩子定义的引用。后者允许嵌入堆栈定义为彼此,这是一个先进的作文的例子:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
#配置/ services.yaml服务:some_decorator:类:App \装饰embedded_stack:栈:- - - - - -别名:some_decorator- - - - - -App \装饰:~decorated_foo_stack:栈:- - - - - -家长:embedded_stack- - - - - -记者:~- - - - - -栏:~- - - - - -Foo:~结果将是:
1
美元这- >服务(“decorated_foo_stack”]=新App \装饰(新App \装饰(新巴兹(新栏(新Foo ()))));请注意
改变现有的栈(即从一个编译器通过),您可以访问每一帧由其生成的id使用以下结构:.stack_id.frame_key。从上面的例子中,.decorated_foo_stack.1内联的引用呢巴兹服务和.decorated_foo_stack.0嵌入的堆栈。得到更明确的标识,你可以给一个名字每一帧:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8
#……decorated_foo_stack:栈:第一:家长:embedded_stack第二:记者:~#……的巴兹现在将帧id.decorated_foo_stack.second。
5.1
能够定义堆栈是在Symfony 5.1中引入的。ob娱乐下载
控制行为当装饰服务不存在
当你装修的服务不存在,decoration_on_invalid选项允许你选择采取的行为。
三个不同的行为是可用的:
异常:一个ServiceNotFoundException被告诉,装饰的依赖是失踪。(默认)忽略:容器将删除装饰。零:容器将装饰服务,将装饰零。
- YAML
- XML
- PHP
1 2 3 4 5 6 7
#配置/ services.yamlFoo:~栏:装饰:喷火decoration_on_invalid:忽略参数:(“@.inner”)谨慎
当使用零,你可能需要更新装饰构造函数为了装饰依赖可以为空:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21日22日23日
/ / src /服务/ DecoratorService.php名称空间应用程序\服务;使用Acme\OptionalBundle\服务\OptionalService;类DecoratorService{私人美元装饰;公共函数__construct(? OptionalService美元装饰){美元这- >装饰=美元装饰;}公共函数tellInterestingStuff():字符串{如果(!美元这- >装饰){返回一个有趣的;}返回美元这- >装饰- >tellInterestingStuff ()。+一个有趣的;}}请注意
有时,您可能想添加一个动态编译器通过创建服务定义。如果你想装修等服务,确保你的编译器通过注册PassConfig: TYPE_BEFORE_OPTIMIZATION类型的装饰通过将能够找到创建的服务。
