class NullStorage in Zircon Profile 8

Defines a stub storage.

This storage is always empty; the controller reads and writes nothing.

The stub implementation is needed for synchronizing configuration during installation of a module, in which case all configuration being shipped with the module is known to be new. Therefore, the module installation process is able to short-circuit the full diff against the active configuration; the diff would yield all currently available configuration as items to remove, since they do not exist in the module's default configuration directory.

This also can be used for testing purposes.

Hierarchy

• class \Drupal\Core\Config\NullStorage implements StorageInterface

1 file declares its use of NullStorage

DrupalKernel.php in core/lib/Drupal/Core/DrupalKernel.php

Contains \Drupal\Core\DrupalKernel.

File

core/lib/Drupal/Core/Config/NullStorage.php, line 24

Contains \Drupal\Core\Config\NullStorage.

Namespace

Drupal\Core\Config

class NullStorage implements StorageInterface {

  /**
   * {@inheritdoc}
   */
  public function exists($name) {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function read($name) {
    return array();
  }

  /**
   * {@inheritdoc}
   */
  public function readMultiple(array $names) {
    return array();
  }

  /**
   * {@inheritdoc}
   */
  public function write($name, array $data) {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function delete($name) {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function rename($name, $new_name) {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function encode($data) {
    return $data;
  }

  /**
   * {@inheritdoc}
   */
  public function decode($raw) {
    return $raw;
  }

  /**
   * {@inheritdoc}
   */
  public function listAll($prefix = '') {
    return array();
  }

  /**
   * {@inheritdoc}
   */
  public function deleteAll($prefix = '') {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function createCollection($collection) {

    // No op.
  }

  /**
   * {@inheritdoc}
   */
  public function getAllCollectionNames() {
    return array();
  }

  /**
   * {@inheritdoc}
   */
  public function getCollectionName() {
    return '';
  }

}

Members

Name	Modifiers	Type	Description	Overrides
NullStorage::createCollection	public	function	Creates a collection on the storage. Overrides StorageInterface::createCollection
NullStorage::decode	public	function	Decodes configuration data from the storage-specific format. Overrides StorageInterface::decode
NullStorage::delete	public	function	Deletes a configuration object from the storage. Overrides StorageInterface::delete
NullStorage::deleteAll	public	function	Deletes configuration objects whose names start with a given prefix. Overrides StorageInterface::deleteAll
NullStorage::encode	public	function	Encodes configuration data into the storage-specific format. Overrides StorageInterface::encode
NullStorage::exists	public	function	Returns whether a configuration object exists. Overrides StorageInterface::exists
NullStorage::getAllCollectionNames	public	function	Gets the existing collections. Overrides StorageInterface::getAllCollectionNames
NullStorage::getCollectionName	public	function	Gets the name of the current collection the storage is using. Overrides StorageInterface::getCollectionName
NullStorage::listAll	public	function	Gets configuration object names starting with a given prefix. Overrides StorageInterface::listAll
NullStorage::read	public	function	Reads configuration data from the storage. Overrides StorageInterface::read
NullStorage::readMultiple	public	function	Reads configuration data from the storage. Overrides StorageInterface::readMultiple
NullStorage::rename	public	function	Renames a configuration object in the storage. Overrides StorageInterface::rename
NullStorage::write	public	function	Writes configuration data to the storage. Overrides StorageInterface::write
StorageInterface::DEFAULT_COLLECTION		constant	The default collection name.