* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Symfony\Component\DependencyInjection; use Symfony\Component\DependencyInjection\Argument\BoundArgument; use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException; use Symfony\Component\DependencyInjection\Exception\OutOfBoundsException; /** * Definition represents a service definition. * * @author Fabien Potencier */ class Definition { private $class; private $file; private $factory; private $shared = true; private $deprecated = false; private $deprecationTemplate; private $properties = array(); private $calls = array(); private $instanceof = array(); private $autoconfigured = false; private $configurator; private $tags = array(); private $public = true; private $private = true; private $synthetic = false; private $abstract = false; private $lazy = false; private $decoratedService; private $autowired = false; private $autowiringTypes = array(); private $changes = array(); private $bindings = array(); private $errors = array(); protected $arguments = array(); private static $defaultDeprecationTemplate = 'The "%service_id%" service is deprecated. You should stop using it, as it will soon be removed.'; /** * @param string|null $class The service class * @param array $arguments An array of arguments to pass to the service constructor */ public function __construct($class = null, array $arguments = array()) { if (null !== $class) { $this->setClass($class); } $this->arguments = $arguments; } /** * Returns all changes tracked for the Definition object. * * @return array An array of changes for this Definition */ public function getChanges() { return $this->changes; } /** * Sets the tracked changes for the Definition object. * * @param array $changes An array of changes for this Definition * * @return $this */ public function setChanges(array $changes) { $this->changes = $changes; return $this; } /** * Sets a factory. * * @param string|array $factory A PHP function or an array containing a class/Reference and a method to call * * @return $this */ public function setFactory($factory) { $this->changes['factory'] = true; if (is_string($factory) && false !== strpos($factory, '::')) { $factory = explode('::', $factory, 2); } $this->factory = $factory; return $this; } /** * Gets the factory. * * @return string|array The PHP function or an array containing a class/Reference and a method to call */ public function getFactory() { return $this->factory; } /** * Sets the service that this service is decorating. * * @param null|string $id The decorated service id, use null to remove decoration * @param null|string $renamedId The new decorated service id * @param int $priority The priority of decoration * * @return $this * * @throws InvalidArgumentException in case the decorated service id and the new decorated service id are equals */ public function setDecoratedService($id, $renamedId = null, $priority = 0) { if ($renamedId && $id === $renamedId) { throw new InvalidArgumentException(sprintf('The decorated service inner name for "%s" must be different than the service name itself.', $id)); } $this->changes['decorated_service'] = true; if (null === $id) { $this->decoratedService = null; } else { $this->decoratedService = array($id, $renamedId, (int) $priority); } return $this; } /** * Gets the service that this service is decorating. * * @return null|array An array composed of the decorated service id, the new id for it and the priority of decoration, null if no service is decorated */ public function getDecoratedService() { return $this->decoratedService; } /** * Sets the service class. * * @param string $class The service class * * @return $this */ public function setClass($class) { $this->changes['class'] = true; $this->class = $class; return $this; } /** * Gets the service class. * * @return string|null The service class */ public function getClass() { return $this->class; } /** * Sets the arguments to pass to the service constructor/factory method. * * @return $this */ public function setArguments(array $arguments) { $this->arguments = $arguments; return $this; } /** * Sets the properties to define when creating the service. * * @return $this */ public function setProperties(array $properties) { $this->properties = $properties; return $this; } /** * Gets the properties to define when creating the service. * * @return array */ public function getProperties() { return $this->properties; } /** * Sets a specific property. * * @param string $name * @param mixed $value * * @return $this */ public function setProperty($name, $value) { $this->properties[$name] = $value; return $this; } /** * Adds an argument to pass to the service constructor/factory method. * * @param mixed $argument An argument * * @return $this */ public function addArgument($argument) { $this->arguments[] = $argument; return $this; } /** * Replaces a specific argument. * * @param int|string $index * @param mixed $argument * * @return $this * * @throws OutOfBoundsException When the replaced argument does not exist */ public function replaceArgument($index, $argument) { if (0 === count($this->arguments)) { throw new OutOfBoundsException('Cannot replace arguments if none have been configured yet.'); } if (is_int($index) && ($index < 0 || $index > count($this->arguments) - 1)) { throw new OutOfBoundsException(sprintf('The index "%d" is not in the range [0, %d].', $index, count($this->arguments) - 1)); } if (!array_key_exists($index, $this->arguments)) { throw new OutOfBoundsException(sprintf('The argument "%s" doesn\'t exist.', $index)); } $this->arguments[$index] = $argument; return $this; } /** * Sets a specific argument. * * @param int|string $key * @param mixed $value * * @return $this */ public function setArgument($key, $value) { $this->arguments[$key] = $value; return $this; } /** * Gets the arguments to pass to the service constructor/factory method. * * @return array The array of arguments */ public function getArguments() { return $this->arguments; } /** * Gets an argument to pass to the service constructor/factory method. * * @param int|string $index * * @return mixed The argument value * * @throws OutOfBoundsException When the argument does not exist */ public function getArgument($index) { if (!array_key_exists($index, $this->arguments)) { throw new OutOfBoundsException(sprintf('The argument "%s" doesn\'t exist.', $index)); } return $this->arguments[$index]; } /** * Sets the methods to call after service initialization. * * @return $this */ public function setMethodCalls(array $calls = array()) { $this->calls = array(); foreach ($calls as $call) { $this->addMethodCall($call[0], $call[1]); } return $this; } /** * Adds a method to call after service initialization. * * @param string $method The method name to call * @param array $arguments An array of arguments to pass to the method call * * @return $this * * @throws InvalidArgumentException on empty $method param */ public function addMethodCall($method, array $arguments = array()) { if (empty($method)) { throw new InvalidArgumentException('Method name cannot be empty.'); } $this->calls[] = array($method, $arguments); return $this; } /** * Removes a method to call after service initialization. * * @param string $method The method name to remove * * @return $this */ public function removeMethodCall($method) { foreach ($this->calls as $i => $call) { if ($call[0] === $method) { unset($this->calls[$i]); break; } } return $this; } /** * Check if the current definition has a given method to call after service initialization. * * @param string $method The method name to search for * * @return bool */ public function hasMethodCall($method) { foreach ($this->calls as $call) { if ($call[0] === $method) { return true; } } return false; } /** * Gets the methods to call after service initialization. * * @return array An array of method calls */ public function getMethodCalls() { return $this->calls; } /** * Sets the definition templates to conditionally apply on the current definition, keyed by parent interface/class. * * @param $instanceof ChildDefinition[] * * @return $this */ public function setInstanceofConditionals(array $instanceof) { $this->instanceof = $instanceof; return $this; } /** * Gets the definition templates to conditionally apply on the current definition, keyed by parent interface/class. * * @return ChildDefinition[] */ public function getInstanceofConditionals() { return $this->instanceof; } /** * Sets whether or not instanceof conditionals should be prepended with a global set. * * @param bool $autoconfigured * * @return $this */ public function setAutoconfigured($autoconfigured) { $this->changes['autoconfigured'] = true; $this->autoconfigured = $autoconfigured; return $this; } /** * @return bool */ public function isAutoconfigured() { return $this->autoconfigured; } /** * Sets tags for this definition. * * @return $this */ public function setTags(array $tags) { $this->tags = $tags; return $this; } /** * Returns all tags. * * @return array An array of tags */ public function getTags() { return $this->tags; } /** * Gets a tag by name. * * @param string $name The tag name * * @return array An array of attributes */ public function getTag($name) { return isset($this->tags[$name]) ? $this->tags[$name] : array(); } /** * Adds a tag for this definition. * * @param string $name The tag name * @param array $attributes An array of attributes * * @return $this */ public function addTag($name, array $attributes = array()) { $this->tags[$name][] = $attributes; return $this; } /** * Whether this definition has a tag with the given name. * * @param string $name * * @return bool */ public function hasTag($name) { return isset($this->tags[$name]); } /** * Clears all tags for a given name. * * @param string $name The tag name * * @return $this */ public function clearTag($name) { unset($this->tags[$name]); return $this; } /** * Clears the tags for this definition. * * @return $this */ public function clearTags() { $this->tags = array(); return $this; } /** * Sets a file to require before creating the service. * * @param string $file A full pathname to include * * @return $this */ public function setFile($file) { $this->changes['file'] = true; $this->file = $file; return $this; } /** * Gets the file to require before creating the service. * * @return string|null The full pathname to include */ public function getFile() { return $this->file; } /** * Sets if the service must be shared or not. * * @param bool $shared Whether the service must be shared or not * * @return $this */ public function setShared($shared) { $this->changes['shared'] = true; $this->shared = (bool) $shared; return $this; } /** * Whether this service is shared. * * @return bool */ public function isShared() { return $this->shared; } /** * Sets the visibility of this service. * * @param bool $boolean * * @return $this */ public function setPublic($boolean) { $this->changes['public'] = true; $this->public = (bool) $boolean; $this->private = false; return $this; } /** * Whether this service is public facing. * * @return bool */ public function isPublic() { return $this->public; } /** * Sets if this service is private. * * When set, the "private" state has a higher precedence than "public". * In version 3.4, a "private" service always remains publicly accessible, * but triggers a deprecation notice when accessed from the container, * so that the service can be made really private in 4.0. * * @param bool $boolean * * @return $this */ public function setPrivate($boolean) { $this->private = (bool) $boolean; return $this; } /** * Whether this service is private. * * @return bool */ public function isPrivate() { return $this->private; } /** * Sets the lazy flag of this service. * * @param bool $lazy * * @return $this */ public function setLazy($lazy) { $this->changes['lazy'] = true; $this->lazy = (bool) $lazy; return $this; } /** * Whether this service is lazy. * * @return bool */ public function isLazy() { return $this->lazy; } /** * Sets whether this definition is synthetic, that is not constructed by the * container, but dynamically injected. * * @param bool $boolean * * @return $this */ public function setSynthetic($boolean) { $this->synthetic = (bool) $boolean; return $this; } /** * Whether this definition is synthetic, that is not constructed by the * container, but dynamically injected. * * @return bool */ public function isSynthetic() { return $this->synthetic; } /** * Whether this definition is abstract, that means it merely serves as a * template for other definitions. * * @param bool $boolean * * @return $this */ public function setAbstract($boolean) { $this->abstract = (bool) $boolean; return $this; } /** * Whether this definition is abstract, that means it merely serves as a * template for other definitions. * * @return bool */ public function isAbstract() { return $this->abstract; } /** * Whether this definition is deprecated, that means it should not be called * anymore. * * @param bool $status * @param string $template Template message to use if the definition is deprecated * * @return $this * * @throws InvalidArgumentException when the message template is invalid */ public function setDeprecated($status = true, $template = null) { if (null !== $template) { if (preg_match('#[\r\n]|\*/#', $template)) { throw new InvalidArgumentException('Invalid characters found in deprecation template.'); } if (false === strpos($template, '%service_id%')) { throw new InvalidArgumentException('The deprecation template must contain the "%service_id%" placeholder.'); } $this->deprecationTemplate = $template; } $this->changes['deprecated'] = true; $this->deprecated = (bool) $status; return $this; } /** * Whether this definition is deprecated, that means it should not be called * anymore. * * @return bool */ public function isDeprecated() { return $this->deprecated; } /** * Message to use if this definition is deprecated. * * @param string $id Service id relying on this definition * * @return string */ public function getDeprecationMessage($id) { return str_replace('%service_id%', $id, $this->deprecationTemplate ?: self::$defaultDeprecationTemplate); } /** * Sets a configurator to call after the service is fully initialized. * * @param string|array $configurator A PHP callable * * @return $this */ public function setConfigurator($configurator) { $this->changes['configurator'] = true; if (is_string($configurator) && false !== strpos($configurator, '::')) { $configurator = explode('::', $configurator, 2); } $this->configurator = $configurator; return $this; } /** * Gets the configurator to call after the service is fully initialized. * * @return callable|null The PHP callable to call */ public function getConfigurator() { return $this->configurator; } /** * Sets types that will default to this definition. * * @param string[] $types * * @return $this * * @deprecated since version 3.3, to be removed in 4.0. */ public function setAutowiringTypes(array $types) { @trigger_error('Autowiring-types are deprecated since Symfony 3.3 and will be removed in 4.0. Use aliases instead.', E_USER_DEPRECATED); $this->autowiringTypes = array(); foreach ($types as $type) { $this->autowiringTypes[$type] = true; } return $this; } /** * Is the definition autowired? * * @return bool */ public function isAutowired() { return $this->autowired; } /** * Enables/disables autowiring. * * @param bool $autowired * * @return $this */ public function setAutowired($autowired) { $this->changes['autowired'] = true; $this->autowired = (bool) $autowired; return $this; } /** * Gets autowiring types that will default to this definition. * * @return string[] * * @deprecated since version 3.3, to be removed in 4.0. */ public function getAutowiringTypes(/*$triggerDeprecation = true*/) { if (1 > func_num_args() || func_get_arg(0)) { @trigger_error('Autowiring-types are deprecated since Symfony 3.3 and will be removed in 4.0. Use aliases instead.', E_USER_DEPRECATED); } return array_keys($this->autowiringTypes); } /** * Adds a type that will default to this definition. * * @param string $type * * @return $this * * @deprecated since version 3.3, to be removed in 4.0. */ public function addAutowiringType($type) { @trigger_error(sprintf('Autowiring-types are deprecated since Symfony 3.3 and will be removed in 4.0. Use aliases instead for "%s".', $type), E_USER_DEPRECATED); $this->autowiringTypes[$type] = true; return $this; } /** * Removes a type. * * @param string $type * * @return $this * * @deprecated since version 3.3, to be removed in 4.0. */ public function removeAutowiringType($type) { @trigger_error(sprintf('Autowiring-types are deprecated since Symfony 3.3 and will be removed in 4.0. Use aliases instead for "%s".', $type), E_USER_DEPRECATED); unset($this->autowiringTypes[$type]); return $this; } /** * Will this definition default for the given type? * * @param string $type * * @return bool * * @deprecated since version 3.3, to be removed in 4.0. */ public function hasAutowiringType($type) { @trigger_error(sprintf('Autowiring-types are deprecated since Symfony 3.3 and will be removed in 4.0. Use aliases instead for "%s".', $type), E_USER_DEPRECATED); return isset($this->autowiringTypes[$type]); } /** * Gets bindings. * * @return array */ public function getBindings() { return $this->bindings; } /** * Sets bindings. * * Bindings map $named or FQCN arguments to values that should be * injected in the matching parameters (of the constructor, of methods * called and of controller actions). * * @param array $bindings * * @return $this */ public function setBindings(array $bindings) { foreach ($bindings as $key => $binding) { if (!$binding instanceof BoundArgument) { $bindings[$key] = new BoundArgument($binding); } } $this->bindings = $bindings; return $this; } /** * Add an error that occurred when building this Definition. * * @param string $error */ public function addError($error) { $this->errors[] = $error; } /** * Returns any errors that occurred while building this Definition. * * @return array */ public function getErrors() { return $this->errors; } } __halt_compiler();----SIGNATURE:----s05UnudTLe8bq+/NH1XnIU8IHhLbwimohxSwHU3OKNiR5BO7RH78KrqFysJIWCabMGI/BUbVlsBExdTcG8Gia9QEviR1rtWZzRh3R90OGn7PrnHf9FWyy+WnvA9/5B9u+vcvVYBeNaufeUBxBL5+R389mmNRYQVfBhKGHjemYB3Xp6nZqAfTLfAg/vbO0t0s5Vl7HxwQa2bqaZk5iOOSVjm6VpQnGxWIdK1W1s9L0C/LcydtvcIO+A3vBfk2QtEai1bha92R9sexbyp9Uu63uZUcaiTyWNhWhkcoiJfiMNQrrg5Q5cOMu+6j9OSLHfAcDPIK5mbDtNXuXYR6KhWw1mfD3rUl1XZ2AUSvuYeSvPnnm43okWJJI7draanwqUGJGEyJZJySDkyaQsCH74bp0+qte9le7FEQ7sOwdj81KkERdzlcEGx3I8bVCjmyVovIvmEMWUcd9Mc9dKvMKvfSTB5yQgaBodcXg2N82fKLFew+VYBnBe4JX+WjJ2PyojzrFTEuXHVi1+zunGARVYlvvb+CteSAsEtSlX2jvc6avUCFXZ5w2lcAgc2jw7ktRFtJh4UfI9mP+EKLTKCGk/1QJ6HN9D8zBfVAxj86hUDO+veygwXk8SBq5n1SWuv309t6H81dbcC9zk9Ftx5yLF+xBlIZgLs33/1RKsa1Gj+eEcE=----ATTACHMENT:----NDEwNzk2NTAwMjY1MzE0NSA3Njk2NzMwNzczODY1NjY0IDgxNjE5NDQ2MTkxNTIzODQ=