You are here

class Definition in Service Container 7

Same name and namespace in other branches
  1. 7.2 modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Definition.php \Symfony\Component\DependencyInjection\Definition

Definition represents a service definition.

@author Fabien Potencier <fabien@symfony.com>

@api

Hierarchy

  • class \Symfony\Component\DependencyInjection\Definition

Expanded class hierarchy of Definition

35 files declare their use of Definition
AnalyzeServiceReferencesPass.php in modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Compiler/AnalyzeServiceReferencesPass.php
AnalyzeServiceReferencesPassTest.php in modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Tests/Compiler/AnalyzeServiceReferencesPassTest.php
CheckExceptionOnInvalidReferenceBehaviorPass.php in modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Compiler/CheckExceptionOnInvalidReferenceBehaviorPass.php
CheckExceptionOnInvalidReferenceBehaviorPassTest.php in modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Tests/Compiler/CheckExceptionOnInvalidReferenceBehaviorPassTest.php
CheckReferenceValidityPass.php in modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Compiler/CheckReferenceValidityPass.php

... See full list

File

modules/providers/service_container_symfony/lib/Symfony/Component/DependencyInjection/Definition.php, line 24

Namespace

Symfony\Component\DependencyInjection
View source
class Definition {
  private $class;
  private $file;
  private $factory;
  private $factoryClass;
  private $factoryMethod;
  private $factoryService;
  private $scope = ContainerInterface::SCOPE_CONTAINER;
  private $properties = array();
  private $calls = array();
  private $configurator;
  private $tags = array();
  private $public = true;
  private $synthetic = false;
  private $abstract = false;
  private $synchronized = false;
  private $lazy = false;
  private $decoratedService;
  protected $arguments;

  /**
   * Constructor.
   *
   * @param string|null $class     The service class
   * @param array       $arguments An array of arguments to pass to the service constructor
   *
   * @api
   */
  public function __construct($class = null, array $arguments = array()) {
    $this->class = $class;
    $this->arguments = $arguments;
  }

  /**
   * Sets a factory.
   *
   * @param string|array $factory A PHP function or an array containing a class/Reference and a method to call
   *
   * @return Definition The current instance
   */
  public function setFactory($factory) {
    if (is_string($factory) && strpos($factory, '::') !== false) {
      $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 name of the class that acts as a factory using the factory method,
   * which will be invoked statically.
   *
   * @param string $factoryClass The factory class name
   *
   * @return Definition The current instance
   *
   * @api
   * @deprecated since version 2.6, to be removed in 3.0.
   */
  public function setFactoryClass($factoryClass) {
    trigger_error(sprintf('%s(%s) is deprecated since version 2.6 and will be removed in 3.0. Use Definition::setFactory() instead.', __METHOD__, $factoryClass), E_USER_DEPRECATED);
    $this->factoryClass = $factoryClass;
    return $this;
  }

  /**
   * Gets the factory class.
   *
   * @return string|null The factory class name
   *
   * @api
   * @deprecated since version 2.6, to be removed in 3.0.
   */
  public function getFactoryClass($triggerDeprecationError = true) {
    if ($triggerDeprecationError) {
      trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.6 and will be removed in 3.0.', E_USER_DEPRECATED);
    }
    return $this->factoryClass;
  }

  /**
   * Sets the factory method able to create an instance of this class.
   *
   * @param string $factoryMethod The factory method name
   *
   * @return Definition The current instance
   *
   * @api
   * @deprecated since version 2.6, to be removed in 3.0.
   */
  public function setFactoryMethod($factoryMethod) {
    trigger_error(sprintf('%s(%s) is deprecated since version 2.6 and will be removed in 3.0. Use Definition::setFactory() instead.', __METHOD__, $factoryMethod), E_USER_DEPRECATED);
    $this->factoryMethod = $factoryMethod;
    return $this;
  }

  /**
   * 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
   *
   * @return Definition The current instance
   *
   * @throws InvalidArgumentException In case the decorated service id and the new decorated service id are equals.
   */
  public function setDecoratedService($id, $renamedId = null) {
    if ($renamedId && $id == $renamedId) {
      throw new \InvalidArgumentException(sprintf('The decorated service inner name for "%s" must be different than the service name itself.', $id));
    }
    if (null === $id) {
      $this->decoratedService = null;
    }
    else {
      $this->decoratedService = array(
        $id,
        $renamedId,
      );
    }
    return $this;
  }

  /**
   * Gets the service that decorates this service.
   *
   * @return null|array An array composed of the decorated service id and the new id for it, null if no service is decorated
   */
  public function getDecoratedService() {
    return $this->decoratedService;
  }

  /**
   * Gets the factory method.
   *
   * @return string|null The factory method name
   *
   * @api
   * @deprecated since version 2.6, to be removed in 3.0.
   */
  public function getFactoryMethod($triggerDeprecationError = true) {
    if ($triggerDeprecationError) {
      trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.6 and will be removed in 3.0.', E_USER_DEPRECATED);
    }
    return $this->factoryMethod;
  }

  /**
   * Sets the name of the service that acts as a factory using the factory method.
   *
   * @param string $factoryService The factory service id
   *
   * @return Definition The current instance
   *
   * @api
   * @deprecated since version 2.6, to be removed in 3.0.
   */
  public function setFactoryService($factoryService) {
    trigger_error(sprintf('%s(%s) is deprecated since version 2.6 and will be removed in 3.0. Use Definition::setFactory() instead.', __METHOD__, $factoryService), E_USER_DEPRECATED);
    $this->factoryService = $factoryService;
    return $this;
  }

  /**
   * Gets the factory service id.
   *
   * @return string|null The factory service id
   *
   * @api
   * @deprecated since version 2.6, to be removed in 3.0.
   */
  public function getFactoryService($triggerDeprecationError = true) {
    if ($triggerDeprecationError) {
      trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.6 and will be removed in 3.0.', E_USER_DEPRECATED);
    }
    return $this->factoryService;
  }

  /**
   * Sets the service class.
   *
   * @param string $class The service class
   *
   * @return Definition The current instance
   *
   * @api
   */
  public function setClass($class) {
    $this->class = $class;
    return $this;
  }

  /**
   * Gets the service class.
   *
   * @return string|null The service class
   *
   * @api
   */
  public function getClass() {
    return $this->class;
  }

  /**
   * Sets the arguments to pass to the service constructor/factory method.
   *
   * @param array $arguments An array of arguments
   *
   * @return Definition The current instance
   *
   * @api
   */
  public function setArguments(array $arguments) {
    $this->arguments = $arguments;
    return $this;
  }

  /**
   * @api
   */
  public function setProperties(array $properties) {
    $this->properties = $properties;
    return $this;
  }

  /**
   * @api
   */
  public function getProperties() {
    return $this->properties;
  }

  /**
   * @api
   */
  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 Definition The current instance
   *
   * @api
   */
  public function addArgument($argument) {
    $this->arguments[] = $argument;
    return $this;
  }

  /**
   * Sets a specific argument.
   *
   * @param int   $index
   * @param mixed $argument
   *
   * @return Definition The current instance
   *
   * @throws OutOfBoundsException When the replaced argument does not exist
   *
   * @api
   */
  public function replaceArgument($index, $argument) {
    if ($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));
    }
    $this->arguments[$index] = $argument;
    return $this;
  }

  /**
   * Gets the arguments to pass to the service constructor/factory method.
   *
   * @return array The array of arguments
   *
   * @api
   */
  public function getArguments() {
    return $this->arguments;
  }

  /**
   * Gets an argument to pass to the service constructor/factory method.
   *
   * @param int $index
   *
   * @return mixed The argument value
   *
   * @throws OutOfBoundsException When the argument does not exist
   *
   * @api
   */
  public function getArgument($index) {
    if ($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));
    }
    return $this->arguments[$index];
  }

  /**
   * Sets the methods to call after service initialization.
   *
   * @param array $calls An array of method calls
   *
   * @return Definition The current instance
   *
   * @api
   */
  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 Definition The current instance
   *
   * @throws InvalidArgumentException on empty $method param
   *
   * @api
   */
  public function addMethodCall($method, array $arguments = array()) {
    if (empty($method)) {
      throw new InvalidArgumentException(sprintf('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 Definition The current instance
   *
   * @api
   */
  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
   *
   * @api
   */
  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
   *
   * @api
   */
  public function getMethodCalls() {
    return $this->calls;
  }

  /**
   * Sets tags for this definition.
   *
   * @param array $tags
   *
   * @return Definition the current instance
   *
   * @api
   */
  public function setTags(array $tags) {
    $this->tags = $tags;
    return $this;
  }

  /**
   * Returns all tags.
   *
   * @return array An array of tags
   *
   * @api
   */
  public function getTags() {
    return $this->tags;
  }

  /**
   * Gets a tag by name.
   *
   * @param string $name The tag name
   *
   * @return array An array of attributes
   *
   * @api
   */
  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 Definition The current instance
   *
   * @api
   */
  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
   *
   * @api
   */
  public function hasTag($name) {
    return isset($this->tags[$name]);
  }

  /**
   * Clears all tags for a given name.
   *
   * @param string $name The tag name
   *
   * @return Definition
   */
  public function clearTag($name) {
    if (isset($this->tags[$name])) {
      unset($this->tags[$name]);
    }
    return $this;
  }

  /**
   * Clears the tags for this definition.
   *
   * @return Definition The current instance
   *
   * @api
   */
  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 Definition The current instance
   *
   * @api
   */
  public function setFile($file) {
    $this->file = $file;
    return $this;
  }

  /**
   * Gets the file to require before creating the service.
   *
   * @return string|null The full pathname to include
   *
   * @api
   */
  public function getFile() {
    return $this->file;
  }

  /**
   * Sets the scope of the service.
   *
   * @param string $scope Whether the service must be shared or not
   *
   * @return Definition The current instance
   *
   * @api
   */
  public function setScope($scope) {
    $this->scope = $scope;
    return $this;
  }

  /**
   * Returns the scope of the service.
   *
   * @return string
   *
   * @api
   */
  public function getScope() {
    return $this->scope;
  }

  /**
   * Sets the visibility of this service.
   *
   * @param bool $boolean
   *
   * @return Definition The current instance
   *
   * @api
   */
  public function setPublic($boolean) {
    $this->public = (bool) $boolean;
    return $this;
  }

  /**
   * Whether this service is public facing.
   *
   * @return bool
   *
   * @api
   */
  public function isPublic() {
    return $this->public;
  }

  /**
   * Sets the synchronized flag of this service.
   *
   * @param bool $boolean
   *
   * @return Definition The current instance
   *
   * @api
   *
   * @deprecated since version 2.7, will be removed in 3.0.
   */
  public function setSynchronized($boolean, $triggerDeprecationError = true) {
    if ($triggerDeprecationError) {
      trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.7 and will be removed in 3.0.', E_USER_DEPRECATED);
    }
    $this->synchronized = (bool) $boolean;
    return $this;
  }

  /**
   * Whether this service is synchronized.
   *
   * @return bool
   *
   * @api
   *
   * @deprecated since version 2.7, will be removed in 3.0.
   */
  public function isSynchronized($triggerDeprecationError = true) {
    if ($triggerDeprecationError) {
      trigger_error('The ' . __METHOD__ . ' method is deprecated since version 2.7 and will be removed in 3.0.', E_USER_DEPRECATED);
    }
    return $this->synchronized;
  }

  /**
   * Sets the lazy flag of this service.
   *
   * @param bool $lazy
   *
   * @return Definition The current instance
   */
  public function setLazy($lazy) {
    $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 Definition the current instance
   *
   * @api
   */
  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
   *
   * @api
   */
  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 Definition the current instance
   *
   * @api
   */
  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
   *
   * @api
   */
  public function isAbstract() {
    return $this->abstract;
  }

  /**
   * Sets a configurator to call after the service is fully initialized.
   *
   * @param callable $callable A PHP callable
   *
   * @return Definition The current instance
   *
   * @api
   */
  public function setConfigurator($callable) {
    $this->configurator = $callable;
    return $this;
  }

  /**
   * Gets the configurator to call after the service is fully initialized.
   *
   * @return callable|null The PHP callable to call
   *
   * @api
   */
  public function getConfigurator() {
    return $this->configurator;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
Definition::$abstract private property
Definition::$arguments protected property
Definition::$calls private property
Definition::$class private property
Definition::$configurator private property
Definition::$decoratedService private property
Definition::$factory private property
Definition::$factoryClass private property
Definition::$factoryMethod private property
Definition::$factoryService private property
Definition::$file private property
Definition::$lazy private property
Definition::$properties private property
Definition::$public private property
Definition::$scope private property
Definition::$synchronized private property
Definition::$synthetic private property
Definition::$tags private property
Definition::addArgument public function Adds an argument to pass to the service constructor/factory method.
Definition::addMethodCall public function Adds a method to call after service initialization.
Definition::addTag public function Adds a tag for this definition.
Definition::clearTag public function Clears all tags for a given name.
Definition::clearTags public function Clears the tags for this definition.
Definition::getArgument public function Gets an argument to pass to the service constructor/factory method. 1
Definition::getArguments public function Gets the arguments to pass to the service constructor/factory method.
Definition::getClass public function Gets the service class.
Definition::getConfigurator public function Gets the configurator to call after the service is fully initialized.
Definition::getDecoratedService public function Gets the service that decorates this service.
Definition::getFactory public function Gets the factory.
Definition::getFactoryClass Deprecated public function Gets the factory class.
Definition::getFactoryMethod Deprecated public function Gets the factory method.
Definition::getFactoryService Deprecated public function Gets the factory service id.
Definition::getFile public function Gets the file to require before creating the service.
Definition::getMethodCalls public function Gets the methods to call after service initialization.
Definition::getProperties public function @api
Definition::getScope public function Returns the scope of the service.
Definition::getTag public function Gets a tag by name.
Definition::getTags public function Returns all tags.
Definition::hasMethodCall public function Check if the current definition has a given method to call after service initialization.
Definition::hasTag public function Whether this definition has a tag with the given name.
Definition::isAbstract public function Whether this definition is abstract, that means it merely serves as a template for other definitions.
Definition::isLazy public function Whether this service is lazy.
Definition::isPublic public function Whether this service is public facing.
Definition::isSynchronized Deprecated public function Whether this service is synchronized.
Definition::isSynthetic public function Whether this definition is synthetic, that is not constructed by the container, but dynamically injected.
Definition::removeMethodCall public function Removes a method to call after service initialization.
Definition::replaceArgument public function Sets a specific argument. 1
Definition::setAbstract public function Whether this definition is abstract, that means it merely serves as a template for other definitions.
Definition::setArguments public function Sets the arguments to pass to the service constructor/factory method.
Definition::setClass public function Sets the service class. 1
Definition::setConfigurator public function Sets a configurator to call after the service is fully initialized. 1
Definition::setDecoratedService public function Sets the service that this service is decorating.
Definition::setFactory public function Sets a factory. 1
Definition::setFactoryClass Deprecated public function Sets the name of the class that acts as a factory using the factory method, which will be invoked statically. 1
Definition::setFactoryMethod Deprecated public function Sets the factory method able to create an instance of this class. 1
Definition::setFactoryService Deprecated public function Sets the name of the service that acts as a factory using the factory method. 1
Definition::setFile public function Sets a file to require before creating the service. 1
Definition::setLazy public function Sets the lazy flag of this service. 1
Definition::setMethodCalls public function Sets the methods to call after service initialization.
Definition::setProperties public function @api
Definition::setProperty public function @api
Definition::setPublic public function Sets the visibility of this service. 1
Definition::setScope public function Sets the scope of the service.
Definition::setSynchronized Deprecated public function Sets the synchronized flag of this service.
Definition::setSynthetic public function Sets whether this definition is synthetic, that is not constructed by the container, but dynamically injected.
Definition::setTags public function Sets tags for this definition.
Definition::__construct public function Constructor. 1