如何使用范围

编辑该页面

警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 2.8,不再维护。

考虑升级你的Symfony项目6.3。ob娱乐下载

如何使用范围

谨慎

本文中的“容器范围”的概念解释已弃用Symfony 2.8和3.0在Symfony将被删除。ob娱乐下载

使用request_stackSymfony中引入服务(2.4),而不是ob娱乐下载请求服务/范围和使用共享设置(在Symfony 2.8中引入的)而不是ob娱乐下载原型范围(阅读更多关于共享服务)。

这篇文章是关于作用域,有些先进的主题相关服务容器。如果你曾经得到一个错误提到“作用域”在创建服务时,那么这篇文章是给你的。

请注意

如果你正试图注入请求服务,简单的解决方案是注入request_stack服务和访问当前请求通过调用getCurrentRequest ()方法(参见如何检索请求从服务容器)。本文的其余部分讨论范围理论和更先进的方式。如果你处理的范围请求服务,只需注射request_stack。

理解范围

服务的范围控制多久的实例使用一个服务容器。DependencyInjection组件提供了两种通用的范围:

容器(默认):
每次询问使用相同的实例从这个容器。
原型:
每次创建一个新实例请求服务。

的ContainerAwareHttpKernel还定义了第三个范围:请求。这个范围的请求,这意味着创建一个新的实例为每个subrequest和不可用在请求(例如在CLI)。

一个例子:客户范围

以外的其他请求服务(一个简单的解决方案,见上面的注意),没有服务默认Symfony容器属于任何以外的范围ob娱乐下载容器和原型。但对于本文的目的,想象有另一个范围客户端和服务client_configuration属于它。这不是一个常见的情况,但我们的想法是,你可以进入和退出多个客户端在请求作用域,每一个都有它自己的client_configuration服务。

范围添加一个约束依赖关系的服务:服务不能依赖服务从一个狭窄的范围。例如,如果您创建一个通用的my_foo服务,但试图注入client_configuration服务,您将收到一个ScopeWideningInjectionException当编译容器。读下面的侧边栏的更多细节。

范围和依赖关系

想象你已经配置了my_mailer服务。你没有配置服务的范围,所以它默认容器。换句话说,每次你问的容器my_mailer服务,您拿回相同的对象。这通常是你想要你的服务是如何工作的。

想象,然而,你需要client_configuration服务在你的my_mailer服务,也许因为你阅读一些细节,比如“发件人”地址应该是什么。你把它作为构造函数参数。这提出了一个问题:有几个原因

  • 当请求my_mailer的一个实例,my_mailer(称为MailerA和创建)client_configuration服务(称为ConfigurationA在这里)被传递给它。生活是美好的!
  • 应用程序与另一个客户,现在需要做些什么和你设计你的应用程序以这样一种方式,你进入一个新的处理这个问题client_configuration并设置一个新的范围client_configuration服务容器。调用这个ConfigurationB。

  • 在您的应用程序,你再次询问my_mailer服务。因为你的服务容器范围,相同的实例(MailerA)是重用。但问题是:MailerA实例仍然包含旧的ConfigurationA对象,它是现在不正确的配置对象(ConfigurationB现在是当前client_configuration服务)。这是微妙的,但没别的可能会引发重大问题,这就是为什么这是不允许的。

    这就是原因为什么作用域存在,以及他们如何会导致一些问题。继续阅读,找出共同的解决方案。

请注意

服务当然可以依靠服务从一个更广泛的范围内没有任何问题。

使用服务从一个狭窄的范围

有两个解决方案范围问题:

  • )把你的服务在同一范围的依赖(或一个窄)。如果你依靠client_configuration服务,这意味着把你的新服务客户端范围(见如何使用范围);
  • B)传递整个容器服务和检索你的依赖从容器每次你需要确保你有正确的实例——您的服务可以住在默认容器范围(见如何使用范围)。

下面几节详细讨论每个场景。

请注意

Symfony 2ob娱乐下载.7之前,还有一个替代的基础上同步服务。然而,这些类型的服务已经弃用从Symfony 2.7。ob娱乐下载

改变你的服务的范围

改变服务的范围应该在其定义。这个例子假设梅勒类都有一个__construct ()函数的第一个参数ClientConfiguration对象:

1 2 3 4 5 6
# app / config / services.yml服务:my_mailer:类:AppBundle \邮件\梅勒范围:客户端参数:(“@client_configuration”)

B)通过容器作为一个依赖你的服务

设置一个窄的范围并不总是可能的(例如,必须在树枝延伸容器范围的树枝环境需要依赖)。在这些情况下,您可以通过整个集装箱到你的服务:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/ / src / AppBundle /邮件/ Mailer.php名称空间AppBundle\邮件;使用ob娱乐下载\组件\DependencyInjection\ContainerInterface;类梅勒{受保护的美元容器;公共函数__construct(ContainerInterface美元容器){美元这- >容器=美元容器;}公共函数sendEmail(){美元请求=美元这- >容器- >get (“client_configuration”);/ /……使用客户端配置的东西吗}}

谨慎

注意不要将客户端配置存储在一个对象的属性为未来服务的调用,因为它会导致同样的问题描述的第一部分(除了Symfony不能检测到你错了)。ob娱乐下载

这个类的服务配置会看起来像这样:

1 2 3 4 5 6
# app / config / services.yml服务:my_mailer:类:AppBundle \邮件\梅勒参数:(“@service_container”)#范围:容器可以省略,因为它是默认的

请注意

将整个容器注入服务通常不是一个好主意(只有注入您所需要的)。

这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。
TOC
    版本
    版本:
    代码消耗服务器资源。黑焰告诉你

    代码消耗服务器资源。黑焰告诉你

    被训练SensioLabs专家(2到6天会议——法语或英语)。

    被训练SensioLabs专家(2到6天会议——法语或英语)。