Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Core\Config;
Chris@0: 
Chris@0: /**
Chris@0:  * Defines the immutable configuration object.
Chris@0:  *
Chris@0:  * Encapsulates all capabilities needed for runtime configuration handling
Chris@0:  * except being able to change the configuration.
Chris@0:  *
Chris@0:  * If you need to be able to change configuration use
Chris@0:  * \Drupal\Core\Form\ConfigFormBaseTrait or
Chris@0:  * \Drupal\Core\Config\ConfigFactoryInterface::getEditable().
Chris@0:  *
Chris@0:  * @see \Drupal\Core\Form\ConfigFormBaseTrait
Chris@0:  * @see \Drupal\Core\Config\ConfigFactoryInterface::getEditable()
Chris@0:  * @see \Drupal\Core\Config\ConfigFactoryInterface::get()
Chris@0:  *
Chris@0:  * @ingroup config_api
Chris@0:  */
Chris@0: class ImmutableConfig extends Config {
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function set($key, $value) {
Chris@0:     throw new ImmutableConfigException("Can not set values on immutable configuration {$this->getName()}:$key. Use \\Drupal\\Core\\Config\\ConfigFactoryInterface::getEditable() to retrieve a mutable configuration object");
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function clear($key) {
Chris@0:     throw new ImmutableConfigException("Can not clear $key key in immutable configuration {$this->getName()}. Use \\Drupal\\Core\\Config\\ConfigFactoryInterface::getEditable() to retrieve a mutable configuration object");
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function save($has_trusted_data = FALSE) {
Chris@0:     throw new ImmutableConfigException("Can not save immutable configuration {$this->getName()}. Use \\Drupal\\Core\\Config\\ConfigFactoryInterface::getEditable() to retrieve a mutable configuration object");
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Deletes the configuration object.
Chris@0:    *
Chris@0:    * @return \Drupal\Core\Config\Config
Chris@0:    *   The configuration object.
Chris@0:    */
Chris@0:   public function delete() {
Chris@0:     throw new ImmutableConfigException("Can not delete immutable configuration {$this->getName()}. Use \\Drupal\\Core\\Config\\ConfigFactoryInterface::getEditable() to retrieve a mutable configuration object");
Chris@0:   }
Chris@0: 
Chris@0: }