如何使用服务标签
编辑本页警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 2.8，现已不再维护。
读本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。
如何使用服务标签
服务标签是一种告诉Symfony或其他第三方欧宝娱乐app下载地址捆绑包您的服务应该以某种特殊方式注册的方式。举个例子:
- YAML
- XML
- PHP
1 2 3 4 5 6 7
# app / config / services.yml服务:app.twig_extension:类:AppBundle \树枝\ AppExtension公众:假标签:-｛名称:twig.extension｝标记为twig.extension标签在TwigBundle初始化时被收集，并作为扩展添加到Twig。
其他标记用于将服务集成到其他系统中。有关核心Symfony框架中可用的所有标记的列表，请查看欧宝娱乐app下载地址内置的Symfon欧宝娱乐app下载地址y服务标签．每个标签对您的服务有不同的影响，许多标签需要额外的参数(除了的名字参数)。
创建自定义标记
标签本身实际上不会以任何方式改变服务的功能。但是如果您选择这样做，您可以向容器构建器请求使用特定标记标记的所有服务的列表。这在编译器传递中非常有用，您可以找到这些服务并以某种特定的方式使用或修改它们。
例如，如果你正在使用Swift Mailer，你可能会想象你想要实现一个“传输链”，这是一个实现类的集合\ Swift_Transport．使用链，你会希望Swift Mailer尝试多种方式传输消息，直到其中一种成功。
首先，定义TransportChain类:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / AppBundle /邮件/ TransportChain.php名称空间AppBundle＼邮件；类TransportChain｛私人＄传输；公共函数__construct（）｛＄这->传输=数组();｝公共函数addTransport(\ Swift_Transport＄运输）｛＄这->传输[]=＄运输；}}然后，将链定义为服务:
- YAML
- XML
- PHP
1 2 3
服务:app.mailer_transport_chain:类:AppBundle \ \ TransportChain邮件使用自定义标记定义服务
现在你可能想要几个\ Swift_Transport类自动实例化并添加到链中addTransport ()方法。例如，您可以将以下传输添加为服务:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11
服务:app.smtp_transport:类:\ Swift_SmtpTransport参数:[' % mailer_host % ')标签:-｛名称:app.mail_transport｝app.sendmail_transport:类:\ Swift_SendmailTransport标签:-｛名称:app.mail_transport｝注意，每个服务都有一个名为app.mail_transport．这是将在编译器传递中使用的自定义标记。编译器传递使这个标记具有“意义”。
创建编译器通道
你现在可以使用编译器通过方法向容器请求任何服务app.mail_transport标签:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
/ / src / AppBundle DependencyInjection /编译器/ MailTransportPass.php名称空间AppBundle＼DependencyInjection＼编译器；使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼ContainerBuilder；使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼编译器＼CompilerPassInterface；使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼参考；类MailTransportPass实现了CompilerPassInterface｛公共函数过程(ContainerBuilder＄容器）｛//总是首先检查是否定义了主服务如果（！＄容器->有(“app.mailer_transport_chain”)) {返回；｝＄定义＝＄容器->findDefinition (“app.mailer_transport_chain”）;//找到所有带有app.mail_transport标签的服务id＄taggedServices＝＄容器->findTaggedServiceIds (“app.mail_transport”）;foreach（＄taggedServices作为＄id= >＄标签) {//将传输服务添加到ChainTransport服务＄定义->addMethodCall (“addTransport”，数组（新引用(＄id)));}}}将Pass注册到容器中
类中的容器中，为了在编译容器时运行编译器通道，必须将编译器通道添加到容器中build ()捆绑包的方法:
12 3 4 5 6 7 8 9 10 11 12 13
/ / src / AppBundle / AppBundle.php/ /……使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼ContainerBuilder；使用AppBundle＼DependencyInjection＼编译器＼MailTransportPass；类AppBundle扩展包｛公共函数构建(ContainerBuilder＄容器）｛＄容器->addCompilerPass (新MailTransportPass ());}}提示
在实现CompilerPassInterface在服务扩展中，您不需要注册它。看到组件的文档欧宝体育电话获取更多信息。
在标签上添加额外属性
有时，您需要关于使用标记标记的每个服务的附加信息。例如，您可能希望向传输链的每个成员添加别名。
首先，改变TransportChain类:
12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20 21
类TransportChain｛私人＄传输；公共函数__construct（）｛＄这->传输=数组();｝公共函数addTransport(\ Swift_Transport＄运输，＄别名）｛＄这->传输(＄别名] =＄运输；｝公共函数getTransport（＄别名）｛如果(array_key_exists (＄别名，＄这->传输)){返回＄这->传输(＄别名];}}}如你所见，当addTransport ()被称为，它需要的不仅仅是一个Swift_Transport对象，同时也是该传输的字符串别名。那么，如何允许每个带标记的传输服务也提供别名呢?
要回答这个问题，请更改服务声明:
- YAML
- XML
- PHP
1 2 3 4 5 6 7 8 9 10 11
服务:app.smtp_transport:类:\ Swift_SmtpTransport参数:[' % mailer_host % ')标签:-｛名称:app.mail_transport,别名:喷火｝app.sendmail_transport:类:\ Swift_SendmailTransport标签:-｛名称:app.mail_transport,别名:酒吧｝注意，您添加了一个泛型别名标签的键。要真正使用它，更新编译器:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼ContainerBuilder；使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼编译器＼CompilerPassInterface；使用欧宝娱乐app下载地址＼组件＼DependencyInjection＼参考；类TransportCompilerPass实现了CompilerPassInterface｛公共函数过程(ContainerBuilder＄容器）｛如果（！＄容器->hasDefinition (“app.mailer_transport_chain”)) {返回；｝＄定义＝＄容器->getDefinition (“app.mailer_transport_chain”）;＄taggedServices＝＄容器->findTaggedServiceIds (“app.mail_transport”）;foreach（＄taggedServices作为＄id= >＄标签) {foreach（＄标签作为＄属性) {＄定义->addMethodCall (“addTransport”，数组（新引用(＄id)，＄属性［“别名”)));} } } }双循环可能会让人困惑。这是因为服务可以有多个标记。标记服务两次或两次以上app.mail_transport标签。第二个foreach循环遍历app.mail_transport为当前服务设置的标记，并为您提供属性。
