class TwigReference

twig.engine in drupal/core/themes/engines/twig/twig.engine

Handles integration of Twig templates with the Drupal theme system.

TwigReferenceUnitTest.php in drupal/core/modules/system/lib/Drupal/system/Tests/Theme/TwigReferenceUnitTest.php

Definition of Drupal\system\Tests\Theme\TwigReferenceUnitTest.

class TwigReference extends \ArrayObject {

  /**
   * Holds an internal reference to the original array.
   *
   * @var array
   */
  protected $writableRef = array();

  /**
   * Constructs a \Drupal\Core\Template\TwigReference object.
   *
   * The argument to the constructor is ignored as it is not safe that this will
   * always be a reference.
   *
   * To set a reference use:
   * @code
   * $obj = new TwigReference();
   * $obj->setReference($variable);
   * @endcode
   *
   * @param $array
   *   The array parameter is ignored and not passed to the parent
   */
  public function __construct($array = NULL) {
    parent::__construct();
  }

  /**
   * Sets a reference in the internal storage.
   *
   * @param $array
   *   The array to set as internal reference.
   */
  public function setReference(&$array) {
    $this
      ->exchangeArray($array);
    $this->writableRef =& $array;
  }

  /**
   * Gets a reference to the internal storage.
   *
   * Should be called like:
   * @code
   * $reference = &$obj->getReference();
   * @endcode
   *
   * @return
   *   Returns the stored internal reference.
   */
  public function &getReference() {
    return $this->writableRef;
  }

  /**
   * Sets offset in internal reference and internal storage to value.
   *
   * This is just for completeness, but should never be used, because
   * twig cannot set properties and should not.
   *
   * @link http://php.net/manual/en/arrayaccess.offsetset.php
   * @param mixed $offset
   *   The offset to assign the value to.
   * @param mixed $value
   *   The value to set.
   */
  public function offsetSet($offset, $value) {
    $this->writableRef[$offset] = $value;
    parent::offsetSet($offset, $value);
  }

  /**
   * Retrieves offset from internal reference.
   *
   * In case of a render array, it is wrapped again within a TwigReference
   * object.
   *
   * @param mixed $offset
   *   The offset to retrieve.
   *
   * @return mixed
   *   Returns a TwigReference object wrapping the array if the retrieved offset
   *   is a complex array (i.e. not an attribute). Else it returns the retrived
   *   offset directly.
   */
  public function offsetGet($offset) {
    if (!is_array($this->writableRef[$offset]) || $offset[0] == '#') {
      return $this->writableRef[$offset];
    }

    // Wrap the returned array in a new TwigReference.
    $x = clone $this;

    // clone is faster than new
    $x
      ->setReference($this->writableRef[$offset]);
    return $x;
  }

}