2010-01-04 14:26:20 +00:00
< ? php
/*
2011-01-15 13:29:43 +00:00
* This file is part of the Symfony package .
2010-01-04 14:26:20 +00:00
*
2011-03-06 11:40:06 +00:00
* ( c ) Fabien Potencier < fabien @ symfony . com >
2010-01-04 14:26:20 +00:00
*
2011-01-15 13:29:43 +00:00
* For the full copyright and license information , please view the LICENSE
* file that was distributed with this source code .
2010-01-04 14:26:20 +00:00
*/
2011-01-15 13:29:43 +00:00
namespace Symfony\Component\DependencyInjection ;
2013-03-21 16:34:16 +00:00
use Symfony\Component\DependencyInjection\Exception\InactiveScopeException ;
2011-12-04 23:51:22 +00:00
use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException ;
2015-07-02 23:05:34 +01:00
use Symfony\Component\DependencyInjection\Exception\LogicException ;
2011-12-04 23:51:22 +00:00
use Symfony\Component\DependencyInjection\Exception\RuntimeException ;
2011-05-17 15:26:08 +01:00
use Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException ;
2011-05-25 08:46:30 +01:00
use Symfony\Component\DependencyInjection\Exception\ServiceCircularReferenceException ;
2011-01-15 13:29:43 +00:00
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface ;
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag ;
use Symfony\Component\DependencyInjection\ParameterBag\FrozenParameterBag ;
2010-01-04 14:26:20 +00:00
/**
* Container is a dependency injection container .
*
2010-06-27 17:28:29 +01:00
* It gives access to object instances ( services ) .
2010-01-04 14:26:20 +00:00
*
* Services and parameters are simple key / pair stores .
*
2011-01-03 08:07:06 +00:00
* Parameter and service keys are case insensitive .
2010-01-04 14:26:20 +00:00
*
* A service id can contain lowercased letters , digits , underscores , and dots .
* Underscores are used to separate words , and dots to group services
* under namespaces :
*
* < ul >
* < li > request </ li >
* < li > mysql_session_storage </ li >
* < li > symfony . mysql_session_storage </ li >
* </ ul >
*
* A service can also be defined by creating a method named
* getXXXService (), where XXX is the camelized version of the id :
*
* < ul >
* < li > request -> getRequestService () </ li >
* < li > mysql_session_storage -> getMysqlSessionStorageService () </ li >
* < li > symfony . mysql_session_storage -> getSymfony_MysqlSessionStorageService () </ li >
* </ ul >
*
* The container can have three possible behaviors when a service does not exist :
*
* * EXCEPTION_ON_INVALID_REFERENCE : Throws an exception ( the default )
* * NULL_ON_INVALID_REFERENCE : Returns null
* * IGNORE_ON_INVALID_REFERENCE : Ignores the wrapping command asking for the reference
* ( for instance , ignore a setter if the service does not exist )
*
2011-03-06 11:40:06 +00:00
* @ author Fabien Potencier < fabien @ symfony . com >
2011-01-17 22:28:59 +00:00
* @ author Johannes M . Schmitt < schmittjoh @ gmail . com >
2011-07-20 09:50:27 +01:00
*
* @ api
2010-01-04 14:26:20 +00:00
*/
2015-07-02 23:05:34 +01:00
class Container implements IntrospectableContainerInterface , ResettableContainerInterface
2010-01-04 14:26:20 +00:00
{
2012-11-01 15:08:59 +00:00
/**
* @ var ParameterBagInterface
*/
2010-06-27 17:28:29 +01:00
protected $parameterBag ;
2012-11-01 15:08:59 +00:00
2013-11-10 17:06:47 +00:00
protected $services = array ();
protected $methodMap = array ();
protected $aliases = array ();
protected $scopes = array ();
protected $scopeChildren = array ();
protected $scopedServices = array ();
protected $scopeStacks = array ();
2011-01-18 15:07:12 +00:00
protected $loading = array ();
2010-05-06 12:25:53 +01:00
2015-05-15 13:54:35 +01:00
private $underscoreMap = array ( '_' => '' , '.' => '_' , '\\' => '_' );
2010-05-06 12:25:53 +01:00
/**
* Constructor .
*
2010-07-27 14:33:28 +01:00
* @ param ParameterBagInterface $parameterBag A ParameterBagInterface instance
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
2010-06-27 17:28:29 +01:00
public function __construct ( ParameterBagInterface $parameterBag = null )
2010-01-04 14:26:20 +00:00
{
2013-11-10 17:06:47 +00:00
$this -> parameterBag = $parameterBag ? : new ParameterBag ();
2010-01-04 14:26:20 +00:00
}
2010-05-06 12:25:53 +01:00
/**
2011-01-16 07:12:36 +00:00
* Compiles the container .
2010-07-16 08:15:22 +01:00
*
* This method does two things :
*
* * Parameter values are resolved ;
2011-01-14 17:43:51 +00:00
* * The parameter bag is frozen .
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
2011-01-16 07:12:36 +00:00
public function compile ()
2010-05-06 12:25:53 +01:00
{
2010-07-16 08:15:22 +01:00
$this -> parameterBag -> resolve ();
2010-06-27 17:28:29 +01:00
$this -> parameterBag = new FrozenParameterBag ( $this -> parameterBag -> all ());
2010-05-06 12:25:53 +01:00
}
/**
2010-06-27 17:28:29 +01:00
* Returns true if the container parameter bag are frozen .
2010-05-06 12:25:53 +01:00
*
2014-11-30 13:33:44 +00:00
* @ return bool true if the container parameter bag are frozen , false otherwise
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
2010-06-27 17:28:29 +01:00
public function isFrozen ()
2010-05-06 12:25:53 +01:00
{
2010-06-27 17:28:29 +01:00
return $this -> parameterBag instanceof FrozenParameterBag ;
2010-05-06 12:25:53 +01:00
}
/**
2010-06-27 17:28:29 +01:00
* Gets the service container parameter bag .
2010-05-06 12:25:53 +01:00
*
2010-07-27 14:33:28 +01:00
* @ return ParameterBagInterface A ParameterBagInterface instance
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
2010-06-27 17:28:29 +01:00
public function getParameterBag ()
2010-05-06 12:25:53 +01:00
{
2010-06-27 17:28:29 +01:00
return $this -> parameterBag ;
2010-05-06 12:25:53 +01:00
}
/**
2010-06-27 17:28:29 +01:00
* Gets a parameter .
2010-05-06 12:25:53 +01:00
*
2012-05-15 21:19:31 +01:00
* @ param string $name The parameter name
2010-05-06 12:25:53 +01:00
*
2014-11-30 13:33:44 +00:00
* @ return mixed The parameter value
2010-05-06 12:25:53 +01:00
*
2011-12-04 23:51:22 +00:00
* @ throws InvalidArgumentException if the parameter is not defined
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
public function getParameter ( $name )
{
2010-06-27 17:28:29 +01:00
return $this -> parameterBag -> get ( $name );
2010-05-06 12:25:53 +01:00
}
2010-08-25 23:30:10 +01:00
/**
* Checks if a parameter exists .
*
2012-05-15 21:19:31 +01:00
* @ param string $name The parameter name
2010-08-25 23:30:10 +01:00
*
2014-11-30 13:33:44 +00:00
* @ return bool The presence of parameter in container
2011-07-20 09:50:27 +01:00
*
* @ api
2010-08-25 23:30:10 +01:00
*/
public function hasParameter ( $name )
{
return $this -> parameterBag -> has ( $name );
}
2010-05-06 12:25:53 +01:00
/**
2010-06-27 17:28:29 +01:00
* Sets a parameter .
2010-05-06 12:25:53 +01:00
*
2011-04-23 16:05:44 +01:00
* @ param string $name The parameter name
* @ param mixed $value The parameter value
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
public function setParameter ( $name , $value )
{
2010-06-27 17:28:29 +01:00
$this -> parameterBag -> set ( $name , $value );
2010-05-06 12:25:53 +01:00
}
/**
* Sets a service .
*
2013-07-25 16:13:34 +01:00
* Setting a service to null resets the service : has () returns false and get ()
* behaves in the same way as if the service was never created .
*
2015-06-15 03:41:59 +01:00
* Note : The $scope parameter is deprecated since version 2.8 and will be removed in 3.0 .
*
2010-05-06 12:25:53 +01:00
* @ param string $id The service identifier
* @ param object $service The service instance
2011-01-17 22:28:59 +00:00
* @ param string $scope The scope of the service
2011-07-20 09:50:27 +01:00
*
2014-11-30 13:33:44 +00:00
* @ throws RuntimeException When trying to set a service in an inactive scope
2012-12-16 12:02:54 +00:00
* @ throws InvalidArgumentException When trying to set a service in the prototype scope
2012-09-07 23:56:45 +01:00
*
2011-07-20 09:50:27 +01:00
* @ api
2010-05-06 12:25:53 +01:00
*/
2011-01-17 22:28:59 +00:00
public function set ( $id , $service , $scope = self :: SCOPE_CONTAINER )
2010-01-04 14:26:20 +00:00
{
2015-06-15 03:41:59 +01:00
if ( ! in_array ( $scope , array ( 'container' , 'request' )) || ( 'request' === $scope && 'request' !== $id )) {
@ trigger_error ( 'The concept of container scopes is deprecated since version 2.8 and will be removed in 3.0. Omit the third parameter.' , E_USER_DEPRECATED );
}
2011-01-17 22:28:59 +00:00
if ( self :: SCOPE_PROTOTYPE === $scope ) {
2013-02-06 15:37:27 +00:00
throw new InvalidArgumentException ( sprintf ( 'You cannot set service "%s" of scope "prototype".' , $id ));
2011-01-17 22:28:59 +00:00
}
$id = strtolower ( $id );
2014-07-19 19:07:52 +01:00
if ( 'service_container' === $id ) {
2015-04-01 03:23:52 +01:00
throw new InvalidArgumentException ( 'You cannot set service "service_container".' );
2014-07-19 19:07:52 +01:00
}
2015-04-01 03:23:52 +01:00
2011-01-17 22:28:59 +00:00
if ( self :: SCOPE_CONTAINER !== $scope ) {
if ( ! isset ( $this -> scopedServices [ $scope ])) {
2013-02-06 15:37:27 +00:00
throw new RuntimeException ( sprintf ( 'You cannot set service "%s" of inactive scope.' , $id ));
2011-01-17 22:28:59 +00:00
}
$this -> scopedServices [ $scope ][ $id ] = $service ;
}
$this -> services [ $id ] = $service ;
2013-02-06 20:42:01 +00:00
2013-07-25 16:13:34 +01:00
if ( null === $service ) {
2014-08-25 13:14:37 +01:00
if ( self :: SCOPE_CONTAINER !== $scope ) {
unset ( $this -> scopedServices [ $scope ][ $id ]);
}
2013-07-25 16:13:34 +01:00
unset ( $this -> services [ $id ]);
}
2010-01-04 14:26:20 +00:00
}
2010-05-06 12:25:53 +01:00
/**
* Returns true if the given service is defined .
*
2012-05-15 21:19:31 +01:00
* @ param string $id The service identifier
2010-05-06 12:25:53 +01:00
*
2014-11-30 13:33:44 +00:00
* @ return bool true if the service is defined , false otherwise
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
2010-06-27 17:28:29 +01:00
public function has ( $id )
2010-01-19 12:29:28 +00:00
{
2015-05-15 13:54:35 +01:00
for ( $i = 2 ;;) {
if ( 'service_container' === $id
|| isset ( $this -> aliases [ $id ])
|| isset ( $this -> services [ $id ])
|| array_key_exists ( $id , $this -> services )
) {
return true ;
}
if ( -- $i && $id !== $lcId = strtolower ( $id )) {
$id = $lcId ;
} else {
return method_exists ( $this , 'get' . strtr ( $id , $this -> underscoreMap ) . 'Service' );
}
2014-07-19 19:07:52 +01:00
}
2010-01-19 12:29:28 +00:00
}
2010-05-06 12:25:53 +01:00
/**
* Gets a service .
*
2012-07-01 11:35:01 +01:00
* If a service is defined both through a set () method and
* with a get { $id } Service () method , the former has always precedence .
2010-05-06 12:25:53 +01:00
*
2014-11-30 13:33:44 +00:00
* @ param string $id The service identifier
* @ param int $invalidBehavior The behavior when the service does not exist
2010-05-06 12:25:53 +01:00
*
* @ return object The associated service
*
2012-09-07 23:56:45 +01:00
* @ throws ServiceCircularReferenceException When a circular reference is detected
2014-07-26 13:09:47 +01:00
* @ throws ServiceNotFoundException When the service is not defined
* @ throws \Exception if an exception has been thrown when the service has been resolved
2010-05-06 12:25:53 +01:00
*
* @ see Reference
2011-07-20 09:50:27 +01:00
*
* @ api
2010-05-06 12:25:53 +01:00
*/
2010-06-27 17:28:29 +01:00
public function get ( $id , $invalidBehavior = self :: EXCEPTION_ON_INVALID_REFERENCE )
2010-01-04 14:26:20 +00:00
{
2013-09-01 13:17:20 +01:00
// Attempt to retrieve the service by checking first aliases then
// available services. Service IDs are case insensitive, however since
// this method can be called thousands of times during a request, avoid
2013-12-23 09:20:48 +00:00
// calling strtolower() unless necessary.
2015-05-15 13:54:35 +01:00
for ( $i = 2 ;;) {
2014-07-19 19:07:52 +01:00
if ( 'service_container' === $id ) {
return $this ;
}
2013-09-01 13:17:20 +01:00
if ( isset ( $this -> aliases [ $id ])) {
$id = $this -> aliases [ $id ];
}
// Re-use shared service instance if it exists.
if ( isset ( $this -> services [ $id ]) || array_key_exists ( $id , $this -> services )) {
return $this -> services [ $id ];
}
2010-05-06 12:25:53 +01:00
2015-05-15 13:54:35 +01:00
if ( isset ( $this -> loading [ $id ])) {
throw new ServiceCircularReferenceException ( $id , array_keys ( $this -> loading ));
}
2011-01-06 13:18:28 +00:00
2015-05-15 13:54:35 +01:00
if ( isset ( $this -> methodMap [ $id ])) {
$method = $this -> methodMap [ $id ];
} elseif ( -- $i && $id !== $lcId = strtolower ( $id )) {
$id = $lcId ;
continue ;
} elseif ( method_exists ( $this , $method = 'get' . strtr ( $id , $this -> underscoreMap ) . 'Service' )) {
// $method is set to the right value, proceed
} else {
if ( self :: EXCEPTION_ON_INVALID_REFERENCE === $invalidBehavior ) {
if ( ! $id ) {
throw new ServiceNotFoundException ( $id );
}
2012-10-07 19:46:50 +01:00
2015-05-15 13:54:35 +01:00
$alternatives = array ();
foreach ( $this -> services as $key => $associatedService ) {
$lev = levenshtein ( $id , $key );
if ( $lev <= strlen ( $id ) / 3 || false !== strpos ( $key , $id )) {
$alternatives [] = $key ;
}
2013-05-05 11:11:01 +01:00
}
2015-05-15 13:54:35 +01:00
throw new ServiceNotFoundException ( $id , null , null , $alternatives );
2013-03-21 16:34:16 +00:00
}
2015-05-15 13:54:35 +01:00
return ;
2011-03-09 14:38:02 +00:00
}
2011-01-06 13:18:28 +00:00
2015-05-15 13:54:35 +01:00
$this -> loading [ $id ] = true ;
2010-05-06 12:25:53 +01:00
2015-05-15 13:54:35 +01:00
try {
$service = $this -> $method ();
} catch ( \Exception $e ) {
unset ( $this -> loading [ $id ]);
2013-05-05 11:11:01 +01:00
2015-05-15 13:54:35 +01:00
if ( array_key_exists ( $id , $this -> services )) {
unset ( $this -> services [ $id ]);
}
2013-05-05 11:11:01 +01:00
2015-05-15 13:54:35 +01:00
if ( $e instanceof InactiveScopeException && self :: EXCEPTION_ON_INVALID_REFERENCE !== $invalidBehavior ) {
return ;
}
2013-04-30 18:55:25 +01:00
2015-05-15 13:54:35 +01:00
throw $e ;
2013-04-30 18:55:25 +01:00
}
2015-05-15 13:54:35 +01:00
unset ( $this -> loading [ $id ]);
2013-05-05 11:11:01 +01:00
2015-05-15 13:54:35 +01:00
return $service ;
}
2010-01-04 14:26:20 +00:00
}
2012-05-01 13:46:26 +01:00
2012-04-18 18:26:58 +01:00
/**
2014-12-21 17:00:50 +00:00
* Returns true if the given service has actually been initialized .
2012-04-18 18:26:58 +01:00
*
2012-05-15 21:19:31 +01:00
* @ param string $id The service identifier
2012-04-18 18:26:58 +01:00
*
2014-11-30 13:33:44 +00:00
* @ return bool true if service has already been initialized , false otherwise
2012-04-18 18:26:58 +01:00
*/
public function initialized ( $id )
{
2013-09-01 13:17:20 +01:00
$id = strtolower ( $id );
2013-10-30 08:30:20 +00:00
2014-07-19 19:07:52 +01:00
if ( 'service_container' === $id ) {
2015-04-01 03:23:52 +01:00
return false ;
2014-07-19 19:07:52 +01:00
}
2014-11-25 09:00:53 +00:00
if ( isset ( $this -> aliases [ $id ])) {
$id = $this -> aliases [ $id ];
}
2013-09-01 13:17:20 +01:00
return isset ( $this -> services [ $id ]) || array_key_exists ( $id , $this -> services );
2012-04-18 18:26:58 +01:00
}
2010-01-04 14:26:20 +00:00
2015-07-02 23:05:34 +01:00
/**
* { @ inheritdoc }
*/
public function reset ()
{
if ( ! empty ( $this -> scopedServices )) {
throw new LogicException ( 'Resetting the container is not allowed when a scope is active.' );
}
$this -> services = array ();
}
2010-05-06 12:25:53 +01:00
/**
* Gets all service ids .
*
* @ return array An array of all defined service ids
*/
public function getServiceIds ()
2010-01-04 14:26:20 +00:00
{
2010-05-06 12:25:53 +01:00
$ids = array ();
$r = new \ReflectionClass ( $this );
2010-05-07 15:09:11 +01:00
foreach ( $r -> getMethods () as $method ) {
2012-06-12 13:23:19 +01:00
if ( preg_match ( '/^get(.+)Service$/' , $method -> name , $match )) {
2010-05-06 12:25:53 +01:00
$ids [] = self :: underscore ( $match [ 1 ]);
}
}
2014-07-19 19:07:52 +01:00
$ids [] = 'service_container' ;
2010-05-06 12:25:53 +01:00
2011-04-20 22:45:36 +01:00
return array_unique ( array_merge ( $ids , array_keys ( $this -> services )));
2010-01-04 14:26:20 +00:00
}
2011-01-17 22:28:59 +00:00
/**
2014-12-21 17:00:50 +00:00
* This is called when you enter a scope .
2011-01-17 22:28:59 +00:00
*
* @ param string $name
2011-07-20 09:50:27 +01:00
*
2012-09-17 21:41:30 +01:00
* @ throws RuntimeException When the parent scope is inactive
* @ throws InvalidArgumentException When the scope does not exist
2011-07-20 09:50:27 +01:00
*
* @ api
2015-06-15 03:41:59 +01:00
*
* @ deprecated since version 2.8 , to be removed in 3.0 .
2011-01-17 22:28:59 +00:00
*/
public function enterScope ( $name )
{
2015-06-15 03:41:59 +01:00
if ( 'request' !== $name ) {
@ trigger_error ( 'The ' . __METHOD__ . ' method is deprecated since version 2.8 and will be removed in 3.0.' , E_USER_DEPRECATED );
}
2011-01-17 22:28:59 +00:00
if ( ! isset ( $this -> scopes [ $name ])) {
2011-12-04 23:51:22 +00:00
throw new InvalidArgumentException ( sprintf ( 'The scope "%s" does not exist.' , $name ));
2011-01-17 22:28:59 +00:00
}
if ( self :: SCOPE_CONTAINER !== $this -> scopes [ $name ] && ! isset ( $this -> scopedServices [ $this -> scopes [ $name ]])) {
2011-12-04 23:51:22 +00:00
throw new RuntimeException ( sprintf ( 'The parent scope "%s" must be active when entering this scope.' , $this -> scopes [ $name ]));
2011-01-17 22:28:59 +00:00
}
// check if a scope of this name is already active, if so we need to
// remove all services of this scope, and those of any of its child
// scopes from the global services map
if ( isset ( $this -> scopedServices [ $name ])) {
$services = array ( $this -> services , $name => $this -> scopedServices [ $name ]);
unset ( $this -> scopedServices [ $name ]);
foreach ( $this -> scopeChildren [ $name ] as $child ) {
2012-11-26 14:59:46 +00:00
if ( isset ( $this -> scopedServices [ $child ])) {
$services [ $child ] = $this -> scopedServices [ $child ];
unset ( $this -> scopedServices [ $child ]);
}
2011-01-17 22:28:59 +00:00
}
// update global map
$this -> services = call_user_func_array ( 'array_diff_key' , $services );
array_shift ( $services );
// add stack entry for this scope so we can restore the removed services later
if ( ! isset ( $this -> scopeStacks [ $name ])) {
$this -> scopeStacks [ $name ] = new \SplStack ();
}
$this -> scopeStacks [ $name ] -> push ( $services );
}
$this -> scopedServices [ $name ] = array ();
}
/**
* This is called to leave the current scope , and move back to the parent
* scope .
*
2011-02-13 18:06:41 +00:00
* @ param string $name The name of the scope to leave
2011-12-13 07:50:54 +00:00
*
2011-12-04 23:51:22 +00:00
* @ throws InvalidArgumentException if the scope is not active
2011-07-20 09:50:27 +01:00
*
* @ api
2015-06-15 03:41:59 +01:00
*
* @ deprecated since version 2.8 , to be removed in 3.0 .
2011-01-17 22:28:59 +00:00
*/
public function leaveScope ( $name )
{
2015-06-15 03:41:59 +01:00
if ( 'request' !== $name ) {
@ trigger_error ( 'The ' . __METHOD__ . ' method is deprecated since version 2.8 and will be removed in 3.0.' , E_USER_DEPRECATED );
}
2011-01-17 22:28:59 +00:00
if ( ! isset ( $this -> scopedServices [ $name ])) {
2011-12-04 23:51:22 +00:00
throw new InvalidArgumentException ( sprintf ( 'The scope "%s" is not active.' , $name ));
2011-01-17 22:28:59 +00:00
}
// remove all services of this scope, or any of its child scopes from
// the global service map
$services = array ( $this -> services , $this -> scopedServices [ $name ]);
unset ( $this -> scopedServices [ $name ]);
2014-08-25 13:14:37 +01:00
2011-01-17 22:28:59 +00:00
foreach ( $this -> scopeChildren [ $name ] as $child ) {
2014-08-25 13:14:37 +01:00
if ( isset ( $this -> scopedServices [ $child ])) {
$services [] = $this -> scopedServices [ $child ];
unset ( $this -> scopedServices [ $child ]);
2011-01-17 22:28:59 +00:00
}
}
2014-08-25 13:14:37 +01:00
// update global map
2011-01-17 22:28:59 +00:00
$this -> services = call_user_func_array ( 'array_diff_key' , $services );
// check if we need to restore services of a previous scope of this type
if ( isset ( $this -> scopeStacks [ $name ]) && count ( $this -> scopeStacks [ $name ]) > 0 ) {
$services = $this -> scopeStacks [ $name ] -> pop ();
$this -> scopedServices += $services ;
2014-08-25 13:14:37 +01:00
if ( $this -> scopeStacks [ $name ] -> isEmpty ()) {
unset ( $this -> scopeStacks [ $name ]);
}
2013-02-06 20:42:01 +00:00
foreach ( $services as $array ) {
foreach ( $array as $id => $service ) {
$this -> set ( $id , $service , $name );
}
}
2011-01-17 22:28:59 +00:00
}
}
/**
2011-02-13 18:06:41 +00:00
* Adds a scope to the container .
2011-01-17 22:28:59 +00:00
*
2011-02-13 09:33:53 +00:00
* @ param ScopeInterface $scope
2011-07-20 09:50:27 +01:00
*
2012-12-16 12:02:54 +00:00
* @ throws InvalidArgumentException
2011-07-20 09:50:27 +01:00
*
* @ api
2015-06-15 03:41:59 +01:00
*
* @ deprecated since version 2.8 , to be removed in 3.0 .
2011-01-17 22:28:59 +00:00
*/
2011-02-13 09:33:53 +00:00
public function addScope ( ScopeInterface $scope )
2011-01-17 22:28:59 +00:00
{
2011-02-13 09:33:53 +00:00
$name = $scope -> getName ();
$parentScope = $scope -> getParentName ();
2015-06-15 03:41:59 +01:00
if ( 'request' !== $name ) {
@ trigger_error ( 'The ' . __METHOD__ . ' method is deprecated since version 2.8 and will be removed in 3.0.' , E_USER_DEPRECATED );
}
2011-01-17 22:28:59 +00:00
if ( self :: SCOPE_CONTAINER === $name || self :: SCOPE_PROTOTYPE === $name ) {
2011-12-04 23:51:22 +00:00
throw new InvalidArgumentException ( sprintf ( 'The scope "%s" is reserved.' , $name ));
2011-01-17 22:28:59 +00:00
}
if ( isset ( $this -> scopes [ $name ])) {
2011-12-04 23:51:22 +00:00
throw new InvalidArgumentException ( sprintf ( 'A scope with name "%s" already exists.' , $name ));
2011-01-17 22:28:59 +00:00
}
if ( self :: SCOPE_CONTAINER !== $parentScope && ! isset ( $this -> scopes [ $parentScope ])) {
2011-12-04 23:51:22 +00:00
throw new InvalidArgumentException ( sprintf ( 'The parent scope "%s" does not exist, or is invalid.' , $parentScope ));
2011-01-17 22:28:59 +00:00
}
$this -> scopes [ $name ] = $parentScope ;
$this -> scopeChildren [ $name ] = array ();
// normalize the child relations
2011-01-31 18:04:42 +00:00
while ( $parentScope !== self :: SCOPE_CONTAINER ) {
2011-01-17 22:28:59 +00:00
$this -> scopeChildren [ $parentScope ][] = $name ;
2011-01-31 18:04:42 +00:00
$parentScope = $this -> scopes [ $parentScope ];
2011-01-17 22:28:59 +00:00
}
}
/**
2014-12-21 17:00:50 +00:00
* Returns whether this container has a certain scope .
2011-01-17 22:28:59 +00:00
*
2011-02-13 18:06:41 +00:00
* @ param string $name The name of the scope
2011-12-13 07:50:54 +00:00
*
2014-04-16 11:30:19 +01:00
* @ return bool
2011-07-20 09:50:27 +01:00
*
* @ api
2015-06-15 03:41:59 +01:00
*
* @ deprecated since version 2.8 , to be removed in 3.0 .
2011-01-17 22:28:59 +00:00
*/
public function hasScope ( $name )
{
2015-06-15 03:41:59 +01:00
if ( 'request' !== $name ) {
@ trigger_error ( 'The ' . __METHOD__ . ' method is deprecated since version 2.8 and will be removed in 3.0.' , E_USER_DEPRECATED );
}
2011-01-17 22:28:59 +00:00
return isset ( $this -> scopes [ $name ]);
}
/**
2014-12-21 17:00:50 +00:00
* Returns whether this scope is currently active .
2011-01-17 22:28:59 +00:00
*
* This does not actually check if the passed scope actually exists .
*
* @ param string $name
2011-12-13 07:50:54 +00:00
*
2014-04-16 11:30:19 +01:00
* @ return bool
2011-07-20 09:50:27 +01:00
*
* @ api
2015-06-15 03:41:59 +01:00
*
* @ deprecated since version 2.8 , to be removed in 3.0 .
2011-01-17 22:28:59 +00:00
*/
public function isScopeActive ( $name )
{
2015-06-15 03:41:59 +01:00
@ trigger_error ( 'The ' . __METHOD__ . ' method is deprecated since version 2.8 and will be removed in 3.0.' , E_USER_DEPRECATED );
2011-01-17 22:28:59 +00:00
return isset ( $this -> scopedServices [ $name ]);
}
2011-02-13 18:06:41 +00:00
/**
* Camelizes a string .
*
* @ param string $id A string to camelize
2011-12-13 07:50:54 +00:00
*
2011-02-13 18:06:41 +00:00
* @ return string The camelized string
*/
2012-07-09 13:50:58 +01:00
public static function camelize ( $id )
2010-05-06 12:25:53 +01:00
{
2013-11-25 14:21:26 +00:00
return strtr ( ucwords ( strtr ( $id , array ( '_' => ' ' , '.' => '_ ' , '\\' => '_ ' ))), array ( ' ' => '' ));
2010-05-06 12:25:53 +01:00
}
2011-02-13 18:06:41 +00:00
/**
* A string to underscore .
*
* @ param string $id The string to underscore
2011-12-13 07:50:54 +00:00
*
2011-02-13 18:06:41 +00:00
* @ return string The underscored string
*/
2012-07-09 13:50:58 +01:00
public static function underscore ( $id )
2010-05-06 12:25:53 +01:00
{
return strtolower ( preg_replace ( array ( '/([A-Z]+)([A-Z][a-z])/' , '/([a-z\d])([A-Z])/' ), array ( '\\1_\\2' , '\\1_\\2' ), strtr ( $id , '_' , '.' )));
}
2015-07-16 09:25:41 +01:00
private function __clone ()
{
}
2010-01-04 14:26:20 +00:00
}