class ParameterBag

Holds parameters.

@author Fabien Potencier <fabien@symfony.com>

@api

Hierarchy

Expanded class hierarchy of ParameterBag

13 files declare their use of ParameterBag
Container.php in drupal/core/vendor/symfony/dependency-injection/Symfony/Component/DependencyInjection/Container.php
container8.php in drupal/core/vendor/symfony/dependency-injection/Symfony/Component/DependencyInjection/Tests/Fixtures/containers/container8.php
ContainerBuilderTest.php in drupal/core/vendor/symfony/dependency-injection/Symfony/Component/DependencyInjection/Tests/ContainerBuilderTest.php
ContainerTest.php in drupal/core/vendor/symfony/dependency-injection/Symfony/Component/DependencyInjection/Tests/ContainerTest.php
DrupalKernel.php in drupal/core/lib/Drupal/Core/DrupalKernel.php
Definition of Drupal\Core\DrupalKernel.

... See full list

File

drupal/core/vendor/symfony/dependency-injection/Symfony/Component/DependencyInjection/ParameterBag/ParameterBag.php, line 25

Namespace

Symfony\Component\DependencyInjection\ParameterBag
View source
class ParameterBag implements ParameterBagInterface {
  protected $parameters;
  protected $resolved;

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

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

  /**
   * Adds parameters to the service container parameters.
   *
   * @param array $parameters An array of parameters
   *
   * @api
   */
  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
   *
   * @api
   */
  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
   *
   * @api
   */
  public function get($name) {
    $name = strtolower($name);
    if (!array_key_exists($name, $this->parameters)) {
      if (!$name) {
        throw new ParameterNotFoundException($name);
      }
      $alternatives = array();
      foreach (array_keys($this->parameters) as $key) {
        $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
   *
   * @api
   */
  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 Boolean true if the parameter name is defined, false otherwise
   *
   * @api
   */
  public function has($name) {
    return array_key_exists(strtolower($name), $this->parameters);
  }

  /**
   * Removes a parameter.
   *
   * @param string $name The parameter name
   *
   * @api
   */
  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

Namesort descending 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.
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.