use Symfony\Component\DependencyInjection\Exception\EnvNotFoundException;
use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
+use Symfony\Component\DependencyInjection\Exception\ParameterCircularReferenceException;
use Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException;
use Symfony\Component\DependencyInjection\Exception\ServiceCircularReferenceException;
use Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface;
* Container is a dependency injection container.
*
* It gives access to object instances (services).
- *
* Services and parameters are simple key/pair stores.
- *
- * Parameter and service keys are case insensitive.
- *
- * 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:
+ * The container can have four possible behaviors when a service
+ * does not exist (or is not initialized for the last case):
*
* * 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)
+ * * IGNORE_ON_UNINITIALIZED_REFERENCE: Ignores/returns null for uninitialized services or invalid references
*
* @author Fabien Potencier <fabien@symfony.com>
* @author Johannes M. Schmitt <schmittjoh@gmail.com>
*/
class Container implements ResettableContainerInterface
{
- /**
- * @var ParameterBagInterface
- */
protected $parameterBag;
-
protected $services = array();
+ protected $fileMap = array();
protected $methodMap = array();
protected $aliases = array();
protected $loading = array();
+ protected $resolving = array();
+ protected $syntheticIds = array();
/**
* @internal
*/
protected $privates = array();
+ /**
+ * @internal
+ */
+ protected $normalizedIds = array();
+
private $underscoreMap = array('_' => '', '.' => '_', '\\' => '_');
private $envCache = array();
+ private $compiled = false;
+ private $getEnv;
- /**
- * @param ParameterBagInterface $parameterBag A ParameterBagInterface instance
- */
public function __construct(ParameterBagInterface $parameterBag = null)
{
$this->parameterBag = $parameterBag ?: new EnvPlaceholderParameterBag();
$this->parameterBag->resolve();
$this->parameterBag = new FrozenParameterBag($this->parameterBag->all());
+
+ $this->compiled = true;
+ }
+
+ /**
+ * Returns true if the container is compiled.
+ *
+ * @return bool
+ */
+ public function isCompiled()
+ {
+ return $this->compiled;
}
/**
* Returns true if the container parameter bag are frozen.
*
+ * @deprecated since version 3.3, to be removed in 4.0.
+ *
* @return bool true if the container parameter bag are frozen, false otherwise
*/
public function isFrozen()
{
+ @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0. Use the isCompiled() method instead.', __METHOD__), E_USER_DEPRECATED);
+
return $this->parameterBag instanceof FrozenParameterBag;
}
*/
public function set($id, $service)
{
- $id = strtolower($id);
+ // Runs the internal initializer; used by the dumped container to include always-needed files
+ if (isset($this->privates['service_container']) && $this->privates['service_container'] instanceof \Closure) {
+ $initialize = $this->privates['service_container'];
+ unset($this->privates['service_container']);
+ $initialize();
+ }
+
+ $id = $this->normalizeId($id);
if ('service_container' === $id) {
throw new InvalidArgumentException('You cannot set service "service_container".');
}
+ if (isset($this->privates[$id]) || !(isset($this->fileMap[$id]) || isset($this->methodMap[$id]))) {
+ if (!isset($this->privates[$id]) && !isset($this->getRemovedIds()[$id])) {
+ // no-op
+ } elseif (null === $service) {
+ @trigger_error(sprintf('The "%s" service is private, unsetting it is deprecated since Symfony 3.2 and will fail in 4.0.', $id), E_USER_DEPRECATED);
+ unset($this->privates[$id]);
+ } else {
+ @trigger_error(sprintf('The "%s" service is private, replacing it is deprecated since Symfony 3.2 and will fail in 4.0.', $id), E_USER_DEPRECATED);
+ }
+ } elseif (isset($this->services[$id])) {
+ if (null === $service) {
+ @trigger_error(sprintf('The "%s" service is already initialized, unsetting it is deprecated since Symfony 3.3 and will fail in 4.0.', $id), E_USER_DEPRECATED);
+ } else {
+ @trigger_error(sprintf('The "%s" service is already initialized, replacing it is deprecated since Symfony 3.3 and will fail in 4.0.', $id), E_USER_DEPRECATED);
+ }
+ }
+
if (isset($this->aliases[$id])) {
unset($this->aliases[$id]);
}
- $this->services[$id] = $service;
-
if (null === $service) {
unset($this->services[$id]);
- }
- if (isset($this->privates[$id])) {
- if (null === $service) {
- @trigger_error(sprintf('Unsetting the "%s" private service is deprecated since Symfony 3.2 and won\'t be supported anymore in Symfony 4.0.', $id), E_USER_DEPRECATED);
- unset($this->privates[$id]);
- } else {
- @trigger_error(sprintf('Setting the "%s" private service is deprecated since Symfony 3.2 and won\'t be supported anymore in Symfony 4.0. A new public service will be created instead.', $id), E_USER_DEPRECATED);
- }
+ return;
}
+
+ $this->services[$id] = $service;
}
/**
{
for ($i = 2;;) {
if (isset($this->privates[$id])) {
- @trigger_error(sprintf('Checking for the existence of the "%s" private service is deprecated since Symfony 3.2 and won\'t be supported anymore in Symfony 4.0.', $id), E_USER_DEPRECATED);
+ @trigger_error(sprintf('The "%s" service is private, checking for its existence is deprecated since Symfony 3.2 and will fail in 4.0.', $id), E_USER_DEPRECATED);
}
-
- if ('service_container' === $id
- || isset($this->aliases[$id])
- || isset($this->services[$id])
- ) {
+ if (isset($this->aliases[$id])) {
+ $id = $this->aliases[$id];
+ }
+ if (isset($this->services[$id])) {
+ return true;
+ }
+ if ('service_container' === $id) {
return true;
}
- if (isset($this->methodMap[$id])) {
+ if (isset($this->fileMap[$id]) || isset($this->methodMap[$id])) {
return true;
}
- if (--$i && $id !== $lcId = strtolower($id)) {
- $id = $lcId;
+ if (--$i && $id !== $normalizedId = $this->normalizeId($id)) {
+ $id = $normalizedId;
continue;
}
// We only check the convention-based factory in a compiled container (i.e. a child class other than a ContainerBuilder,
// and only when the dumper has not generated the method map (otherwise the method map is considered to be fully populated by the dumper)
if (!$this->methodMap && !$this instanceof ContainerBuilder && __CLASS__ !== static::class && method_exists($this, 'get'.strtr($id, $this->underscoreMap).'Service')) {
- @trigger_error('Generating a dumped container without populating the method map is deprecated since 3.2 and will be unsupported in 4.0. Update your dumper to generate the method map.', E_USER_DEPRECATED);
+ @trigger_error('Generating a dumped container without populating the method map is deprecated since Symfony 3.2 and will be unsupported in 4.0. Update your dumper to generate the method map.', E_USER_DEPRECATED);
return true;
}
*
* @see Reference
*/
- public function get($id, $invalidBehavior = self::EXCEPTION_ON_INVALID_REFERENCE)
+ public function get($id, $invalidBehavior = /* self::EXCEPTION_ON_INVALID_REFERENCE */ 1)
{
// 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
- // calling strtolower() unless necessary.
+ // calling $this->normalizeId($id) unless necessary.
for ($i = 2;;) {
if (isset($this->privates[$id])) {
- @trigger_error(sprintf('Requesting the "%s" private service is deprecated since Symfony 3.2 and won\'t be supported anymore in Symfony 4.0.', $id), E_USER_DEPRECATED);
+ @trigger_error(sprintf('The "%s" service is private, getting it from the container is deprecated since Symfony 3.2 and will fail in 4.0. You should either make the service public, or stop using the container directly and use dependency injection instead.', $id), E_USER_DEPRECATED);
}
if (isset($this->aliases[$id])) {
$id = $this->aliases[$id];
throw new ServiceCircularReferenceException($id, array_keys($this->loading));
}
- if (isset($this->methodMap[$id])) {
- $method = $this->methodMap[$id];
- } elseif (--$i && $id !== $lcId = strtolower($id)) {
- $id = $lcId;
- continue;
- } elseif (!$this->methodMap && !$this instanceof ContainerBuilder && __CLASS__ !== static::class && method_exists($this, $method = 'get'.strtr($id, $this->underscoreMap).'Service')) {
- // We only check the convention-based factory in a compiled container (i.e. a child class other than a ContainerBuilder,
- // and only when the dumper has not generated the method map (otherwise the method map is considered to be fully populated by the dumper)
- @trigger_error('Generating a dumped container without populating the method map is deprecated since 3.2 and will be unsupported in 4.0. Update your dumper to generate the method map.', E_USER_DEPRECATED);
- // $method is set to the right value, proceed
- } else {
- if (self::EXCEPTION_ON_INVALID_REFERENCE === $invalidBehavior) {
- if (!$id) {
- throw new ServiceNotFoundException($id);
- }
-
- $alternatives = array();
- foreach ($this->getServiceIds() as $knownId) {
- $lev = levenshtein($id, $knownId);
- if ($lev <= strlen($id) / 3 || false !== strpos($knownId, $id)) {
- $alternatives[] = $knownId;
- }
- }
-
- throw new ServiceNotFoundException($id, null, null, $alternatives);
- }
-
- return;
- }
-
$this->loading[$id] = true;
try {
- $service = $this->$method();
+ if (isset($this->fileMap[$id])) {
+ return /* self::IGNORE_ON_UNINITIALIZED_REFERENCE */ 4 === $invalidBehavior ? null : $this->load($this->fileMap[$id]);
+ } elseif (isset($this->methodMap[$id])) {
+ return /* self::IGNORE_ON_UNINITIALIZED_REFERENCE */ 4 === $invalidBehavior ? null : $this->{$this->methodMap[$id]}();
+ } elseif (--$i && $id !== $normalizedId = $this->normalizeId($id)) {
+ unset($this->loading[$id]);
+ $id = $normalizedId;
+ continue;
+ } elseif (!$this->methodMap && !$this instanceof ContainerBuilder && __CLASS__ !== static::class && method_exists($this, $method = 'get'.strtr($id, $this->underscoreMap).'Service')) {
+ // We only check the convention-based factory in a compiled container (i.e. a child class other than a ContainerBuilder,
+ // and only when the dumper has not generated the method map (otherwise the method map is considered to be fully populated by the dumper)
+ @trigger_error('Generating a dumped container without populating the method map is deprecated since Symfony 3.2 and will be unsupported in 4.0. Update your dumper to generate the method map.', E_USER_DEPRECATED);
+
+ return /* self::IGNORE_ON_UNINITIALIZED_REFERENCE */ 4 === $invalidBehavior ? null : $this->{$method}();
+ }
+
+ break;
} catch (\Exception $e) {
unset($this->services[$id]);
} finally {
unset($this->loading[$id]);
}
+ }
+
+ if (/* self::EXCEPTION_ON_INVALID_REFERENCE */ 1 === $invalidBehavior) {
+ if (!$id) {
+ throw new ServiceNotFoundException($id);
+ }
+ if (isset($this->syntheticIds[$id])) {
+ throw new ServiceNotFoundException($id, null, null, array(), sprintf('The "%s" service is synthetic, it needs to be set at boot time before it can be used.', $id));
+ }
+ if (isset($this->getRemovedIds()[$id])) {
+ throw new ServiceNotFoundException($id, null, null, array(), sprintf('The "%s" service or alias has been removed or inlined when the container was compiled. You should either make it public, or stop using the container directly and use dependency injection instead.', $id));
+ }
+
+ $alternatives = array();
+ foreach ($this->getServiceIds() as $knownId) {
+ $lev = levenshtein($id, $knownId);
+ if ($lev <= strlen($id) / 3 || false !== strpos($knownId, $id)) {
+ $alternatives[] = $knownId;
+ }
+ }
- return $service;
+ throw new ServiceNotFoundException($id, null, null, $alternatives);
}
}
*/
public function initialized($id)
{
- $id = strtolower($id);
+ $id = $this->normalizeId($id);
+
+ if (isset($this->privates[$id])) {
+ @trigger_error(sprintf('Checking for the initialization of the "%s" private service is deprecated since Symfony 3.4 and won\'t be supported anymore in Symfony 4.0.', $id), E_USER_DEPRECATED);
+ }
if (isset($this->aliases[$id])) {
$id = $this->aliases[$id];
if (!$this->methodMap && !$this instanceof ContainerBuilder && __CLASS__ !== static::class) {
// We only check the convention-based factory in a compiled container (i.e. a child class other than a ContainerBuilder,
// and only when the dumper has not generated the method map (otherwise the method map is considered to be fully populated by the dumper)
- @trigger_error('Generating a dumped container without populating the method map is deprecated since 3.2 and will be unsupported in 4.0. Update your dumper to generate the method map.', E_USER_DEPRECATED);
+ @trigger_error('Generating a dumped container without populating the method map is deprecated since Symfony 3.2 and will be unsupported in 4.0. Update your dumper to generate the method map.', E_USER_DEPRECATED);
foreach (get_class_methods($this) as $method) {
if (preg_match('/^get(.+)Service$/', $method, $match)) {
}
$ids[] = 'service_container';
- return array_unique(array_merge($ids, array_keys($this->methodMap), array_keys($this->services)));
+ return array_unique(array_merge($ids, array_keys($this->methodMap), array_keys($this->fileMap), array_keys($this->services)));
+ }
+
+ /**
+ * Gets service ids that existed at compile time.
+ *
+ * @return array
+ */
+ public function getRemovedIds()
+ {
+ return array();
}
/**
return strtolower(preg_replace(array('/([A-Z]+)([A-Z][a-z])/', '/([a-z\d])([A-Z])/'), array('\\1_\\2', '\\1_\\2'), str_replace('_', '.', $id)));
}
+ /**
+ * Creates a service by requiring its factory file.
+ *
+ * @return object The service created by the file
+ */
+ protected function load($file)
+ {
+ return require $file;
+ }
+
/**
* Fetches a variable from the environment.
*
- * @param string The name of the environment variable
+ * @param string $name The name of the environment variable
*
- * @return scalar The value to use for the provided environment variable name
+ * @return mixed The value to use for the provided environment variable name
*
* @throws EnvNotFoundException When the environment variable is not found and has no default value
*/
protected function getEnv($name)
{
+ if (isset($this->resolving[$envName = "env($name)"])) {
+ throw new ParameterCircularReferenceException(array_keys($this->resolving));
+ }
if (isset($this->envCache[$name]) || array_key_exists($name, $this->envCache)) {
return $this->envCache[$name];
}
- if (isset($_ENV[$name])) {
- return $this->envCache[$name] = $_ENV[$name];
+ if (!$this->has($id = 'container.env_var_processors_locator')) {
+ $this->set($id, new ServiceLocator(array()));
+ }
+ if (!$this->getEnv) {
+ $this->getEnv = new \ReflectionMethod($this, __FUNCTION__);
+ $this->getEnv->setAccessible(true);
+ $this->getEnv = $this->getEnv->getClosure($this);
+ }
+ $processors = $this->get($id);
+
+ if (false !== $i = strpos($name, ':')) {
+ $prefix = substr($name, 0, $i);
+ $localName = substr($name, 1 + $i);
+ } else {
+ $prefix = 'string';
+ $localName = $name;
}
- if (false !== $env = getenv($name)) {
- return $this->envCache[$name] = $env;
+ $processor = $processors->has($prefix) ? $processors->get($prefix) : new EnvVarProcessor($this);
+
+ $this->resolving[$envName] = true;
+ try {
+ return $this->envCache[$name] = $processor->getEnv($prefix, $localName, $this->getEnv);
+ } finally {
+ unset($this->resolving[$envName]);
+ }
+ }
+
+ /**
+ * Returns the case sensitive id used at registration time.
+ *
+ * @param string $id
+ *
+ * @return string
+ *
+ * @internal
+ */
+ public function normalizeId($id)
+ {
+ if (!\is_string($id)) {
+ $id = (string) $id;
}
- if (!$this->hasParameter("env($name)")) {
- throw new EnvNotFoundException($name);
+ if (isset($this->normalizedIds[$normalizedId = strtolower($id)])) {
+ $normalizedId = $this->normalizedIds[$normalizedId];
+ if ($id !== $normalizedId) {
+ @trigger_error(sprintf('Service identifiers will be made case sensitive in Symfony 4.0. Using "%s" instead of "%s" is deprecated since Symfony 3.3.', $id, $normalizedId), E_USER_DEPRECATED);
+ }
+ } else {
+ $normalizedId = $this->normalizedIds[$normalizedId] = $id;
}
- return $this->envCache[$name] = $this->getParameter("env($name)");
+ return $normalizedId;
}
private function __clone()
projects / yaffs-website / blobdiff