class ParameterBag in Zircon Profile 8

Holds parameters.

@author Fabien Potencier <[e-mail]>

Hierarchy

• class \Symfony\Component\DependencyInjection\ParameterBag\ParameterBag implements ParameterBagInterface

19 files declare their use of ParameterBag

Container.php in vendor/symfony/dependency-injection/Container.php

container8.php in vendor/symfony/dependency-injection/Tests/Fixtures/containers/container8.php

ContainerBuilderTest.php in vendor/symfony/dependency-injection/Tests/ContainerBuilderTest.php

ContainerTest.php in vendor/symfony/dependency-injection/Tests/ContainerTest.php

ControllerResolverTest.php in core/tests/Drupal/Tests/Core/Controller/ControllerResolverTest.php

Contains \Drupal\Tests\Core\Controller\ControllerResolverTest.

... See full list

File

vendor/symfony/dependency-injection/ParameterBag/ParameterBag.php, line 23

Namespace

Symfony\Component\DependencyInjection\ParameterBag

class ParameterBag implements ParameterBagInterface {
  protected $parameters = array();
  protected $resolved = false;

  /**
   * Constructor.
   *
   * @param array $parameters An array of parameters
   */
  public function __construct(array $parameters = array()) {
    $this
      ->add($parameters);
  }

  /**
   * Clears all parameters.
   */
  public function clear() {
    $this->parameters = array();
  }

  /**
   * Adds parameters to the service container parameters.
   *
   * @param array $parameters An array of parameters
   */
  public function add(array $parameters) {
    foreach ($parameters as $key => $value) {
      $this->parameters[strtolower($key)] = $value;
    }
  }

  /**
   * Gets the service container parameters.
   *
   * @return array An array of parameters
   */
  public function all() {
    return $this->parameters;
  }

  /**
   * Gets a service container parameter.
   *
   * @param string $name The parameter name
   *
   * @return mixed The parameter value
   *
   * @throws ParameterNotFoundException if the parameter is not defined
   */
  public function get($name) {
    $name = strtolower($name);
    if (!array_key_exists($name, $this->parameters)) {
      if (!$name) {
        throw new ParameterNotFoundException($name);
      }
      $alternatives = array();
      foreach ($this->parameters as $key => $parameterValue) {
        $lev = levenshtein($name, $key);
        if ($lev <= strlen($name) / 3 || false !== strpos($key, $name)) {
          $alternatives[] = $key;
        }
      }
      throw new ParameterNotFoundException($name, null, null, null, $alternatives);
    }
    return $this->parameters[$name];
  }

  /**
   * Sets a service container parameter.
   *
   * @param string $name  The parameter name
   * @param mixed  $value The parameter value
   */
  public function set($name, $value) {
    $this->parameters[strtolower($name)] = $value;
  }

  /**
   * Returns true if a parameter name is defined.
   *
   * @param string $name The parameter name
   *
   * @return bool true if the parameter name is defined, false otherwise
   */
  public function has($name) {
    return array_key_exists(strtolower($name), $this->parameters);
  }

  /**
   * Removes a parameter.
   *
   * @param string $name The parameter name
   */
  public function remove($name) {
    unset($this->parameters[strtolower($name)]);
  }

  /**
   * Replaces parameter placeholders (%name%) by their values for all parameters.
   */
  public function resolve() {
    if ($this->resolved) {
      return;
    }
    $parameters = array();
    foreach ($this->parameters as $key => $value) {
      try {
        $value = $this
          ->resolveValue($value);
        $parameters[$key] = $this
          ->unescapeValue($value);
      } catch (ParameterNotFoundException $e) {
        $e
          ->setSourceKey($key);
        throw $e;
      }
    }
    $this->parameters = $parameters;
    $this->resolved = true;
  }

  /**
   * Replaces parameter placeholders (%name%) by their values.
   *
   * @param mixed $value     A value
   * @param array $resolving An array of keys that are being resolved (used internally to detect circular references)
   *
   * @return mixed The resolved value
   *
   * @throws ParameterNotFoundException          if a placeholder references a parameter that does not exist
   * @throws ParameterCircularReferenceException if a circular reference if detected
   * @throws RuntimeException                    when a given parameter has a type problem.
   */
  public function resolveValue($value, array $resolving = array()) {
    if (is_array($value)) {
      $args = array();
      foreach ($value as $k => $v) {
        $args[$this
          ->resolveValue($k, $resolving)] = $this
          ->resolveValue($v, $resolving);
      }
      return $args;
    }
    if (!is_string($value)) {
      return $value;
    }
    return $this
      ->resolveString($value, $resolving);
  }

  /**
   * Resolves parameters inside a string.
   *
   * @param string $value     The string to resolve
   * @param array  $resolving An array of keys that are being resolved (used internally to detect circular references)
   *
   * @return string The resolved string
   *
   * @throws ParameterNotFoundException          if a placeholder references a parameter that does not exist
   * @throws ParameterCircularReferenceException if a circular reference if detected
   * @throws RuntimeException                    when a given parameter has a type problem.
   */
  public function resolveString($value, array $resolving = array()) {

    // we do this to deal with non string values (Boolean, integer, ...)
    // as the preg_replace_callback throw an exception when trying
    // a non-string in a parameter value
    if (preg_match('/^%([^%\\s]+)%$/', $value, $match)) {
      $key = strtolower($match[1]);
      if (isset($resolving[$key])) {
        throw new ParameterCircularReferenceException(array_keys($resolving));
      }
      $resolving[$key] = true;
      return $this->resolved ? $this
        ->get($key) : $this
        ->resolveValue($this
        ->get($key), $resolving);
    }
    $self = $this;
    return preg_replace_callback('/%%|%([^%\\s]+)%/', function ($match) use ($self, $resolving, $value) {

      // skip %%
      if (!isset($match[1])) {
        return '%%';
      }
      $key = strtolower($match[1]);
      if (isset($resolving[$key])) {
        throw new ParameterCircularReferenceException(array_keys($resolving));
      }
      $resolved = $self
        ->get($key);
      if (!is_string($resolved) && !is_numeric($resolved)) {
        throw new RuntimeException(sprintf('A string value must be composed of strings and/or numbers, but found parameter "%s" of type %s inside string value "%s".', $key, gettype($resolved), $value));
      }
      $resolved = (string) $resolved;
      $resolving[$key] = true;
      return $self
        ->isResolved() ? $resolved : $self
        ->resolveString($resolved, $resolving);
    }, $value);
  }
  public function isResolved() {
    return $this->resolved;
  }

  /**
   * {@inheritdoc}
   */
  public function escapeValue($value) {
    if (is_string($value)) {
      return str_replace('%', '%%', $value);
    }
    if (is_array($value)) {
      $result = array();
      foreach ($value as $k => $v) {
        $result[$k] = $this
          ->escapeValue($v);
      }
      return $result;
    }
    return $value;
  }
  public function unescapeValue($value) {
    if (is_string($value)) {
      return str_replace('%%', '%', $value);
    }
    if (is_array($value)) {
      $result = array();
      foreach ($value as $k => $v) {
        $result[$k] = $this
          ->unescapeValue($v);
      }
      return $result;
    }
    return $value;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ParameterBag::$parameters	protected	property
ParameterBag::$resolved	protected	property
ParameterBag::add	public	function	Adds parameters to the service container parameters. Overrides ParameterBagInterface::add
ParameterBag::all	public	function	Gets the service container parameters. Overrides ParameterBagInterface::all
ParameterBag::clear	public	function	Clears all parameters. Overrides ParameterBagInterface::clear	1
ParameterBag::escapeValue	public	function	Escape parameter placeholders %. Overrides ParameterBagInterface::escapeValue
ParameterBag::get	public	function	Gets a service container parameter. Overrides ParameterBagInterface::get
ParameterBag::has	public	function	Returns true if a parameter name is defined. Overrides ParameterBagInterface::has
ParameterBag::isResolved	public	function
ParameterBag::remove	public	function	Removes a parameter.	1
ParameterBag::resolve	public	function	Replaces parameter placeholders (%name%) by their values for all parameters. Overrides ParameterBagInterface::resolve
ParameterBag::resolveString	public	function	Resolves parameters inside a string.
ParameterBag::resolveValue	public	function	Replaces parameter placeholders (%name%) by their values. Overrides ParameterBagInterface::resolveValue
ParameterBag::set	public	function	Sets a service container parameter. Overrides ParameterBagInterface::set
ParameterBag::unescapeValue	public	function	Unescape parameter placeholders %. Overrides ParameterBagInterface::unescapeValue
ParameterBag::__construct	public	function	Constructor.