class ParameterBinding in Drupal 7 to 8/9 Module Upgrader 8

Represents a binding between a single callback parameter and a single path component in a Drupal 8 route path, possibly affected by an argument.

Hierarchy

• class \Drupal\drupalmoduleupgrader\Routing\ParameterBinding

1 file declares its use of ParameterBinding

ParameterBindingTest.php in tests/src/Unit/Routing/ParameterBindingTest.php

File

src/Routing/ParameterBinding.php, line 14

Namespace

Drupal\drupalmoduleupgrader\Routing

class ParameterBinding {

  /**
   * @var \Drupal\drupalmoduleupgrader\Utility\Path\PathUtilityInterface
   */
  protected $path;

  /**
   * @var \Pharborist\Functions\ParameterNode
   */
  protected $parameter;

  /**
   * @var mixed
   */
  protected $argument;

  /**
   * The trouble with Drupal 7 callback arguments is that virtually any value
   * could be explicitly passed, including NULL and FALSE. -1 is an illegal
   * value because it's an integer, but not a valid path position. So we'll
   * use it here as a signal that no argument is explicitly bound to the
   * parameter.
   */
  const NO_ARGUMENT = -1;
  public function __construct(PathUtilityInterface $path, ParameterNode $parameter, $argument = self::NO_ARGUMENT) {

    // Clone $path so that we have our own copy to look at. The original $path
    // is (probably) modified by upstream code.
    $this->path = clone $path;
    $this->parameter = $parameter;
    $this->argument = $argument;
  }

  /**
   * The original parameter node.
   *
   * @return \Pharborist\Functions\ParameterNode
   */
  public function getParameter() {
    return $this->parameter;
  }

  /**
   * Returns if the parameter is explicitly represented in the path.
   *
   * @return bool
   */
  public function inPath() {
    return $this
      ->isPathPosition() && sizeof($this->path) > $this
      ->getArgument();
  }

  /**
   * Returns if this binding has an explicit argument.
   *
   * @return bool
   */
  public function hasArgument() {
    return $this
      ->getArgument() !== self::NO_ARGUMENT;
  }

  /**
   * Returns the argument.
   *
   * @return mixed
   */
  public function getArgument() {
    return $this->argument;
  }

  /**
   * Whether or not the argument is a path position (integer greater
   * than or equal to 0).
   *
   * @return bool
   */
  public function isPathPosition() {
    return $this
      ->hasArgument() && is_integer($this
      ->getArgument());
  }

  /**
   * Returns the value of the binding. If the value is an instance of
   * \Drupal\drupalmoduleupgrader\Utility\Path\PathComponentInterface,
   * the binding expects to be physically represented in the path, although
   * it may not yet be (this can be ascertained by the inPath() method). Any
   * other value is used verbatim.
   *
   * @return mixed
   */
  public function getValue() {
    if ($this
      ->hasArgument()) {
      if ($this
        ->isPathPosition()) {
        $position = $this
          ->getArgument();
        return $this->path
          ->containsKey($position) ? $this->path[$position] : new PathComponent('%');
      }
      else {
        return $this
          ->getArgument();
      }
    }
    else {
      $value = $this
        ->getParameter()
        ->getValue();
      if ($value instanceof ScalarNode) {
        return $value
          ->toValue();
      }
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ParameterBinding::$argument	protected	property
ParameterBinding::$parameter	protected	property
ParameterBinding::$path	protected	property
ParameterBinding::getArgument	public	function	Returns the argument.
ParameterBinding::getParameter	public	function	The original parameter node.
ParameterBinding::getValue	public	function	Returns the value of the binding. If the value is an instance of \Drupal\drupalmoduleupgrader\Utility\Path\PathComponentInterface, the binding expects to be physically represented in the path, although it may not yet be (this can be ascertained by the…
ParameterBinding::hasArgument	public	function	Returns if this binding has an explicit argument.
ParameterBinding::inPath	public	function	Returns if the parameter is explicitly represented in the path.
ParameterBinding::isPathPosition	public	function	Whether or not the argument is a path position (integer greater than or equal to 0).
ParameterBinding::NO_ARGUMENT		constant	The trouble with Drupal 7 callback arguments is that virtually any value could be explicitly passed, including NULL and FALSE. -1 is an illegal value because it's an integer, but not a valid path position. So we'll use it here as a signal…
ParameterBinding::__construct	public	function