final class Settings in Drupal 8

Read only settings that are initialized with the class.

Hierarchy

• class \Drupal\Core\Site\Settings

Related topics

Utility classes and functions

Overview of utility classes and functions for developers.

135 files declare their use of Settings

ApcuBackendFactory.php in core/lib/Drupal/Core/Cache/ApcuBackendFactory.php

authorize.php in core/authorize.php

Administrative script for running authorized file operations.

bootstrap.inc in core/includes/bootstrap.inc

Functions that need to be loaded on every Drupal request.

BootstrapConfigStorageFactory.php in core/lib/Drupal/Core/Config/BootstrapConfigStorageFactory.php

CacheFactory.php in core/lib/Drupal/Core/Cache/CacheFactory.php

... See full list

26 string references to 'Settings'

aggregator.links.task.yml in core/modules/aggregator/aggregator.links.task.yml

core/modules/aggregator/aggregator.links.task.yml

AggregatorAdminTest::testSettingsPage in core/modules/aggregator/tests/src/Functional/AggregatorAdminTest.php

Tests the settings form to ensure the correct default values are used.

book.links.task.yml in core/modules/book/book.links.task.yml

core/modules/book/book.links.task.yml

ConfigNamesMapper::getTypeName in core/modules/config_translation/src/ConfigNamesMapper.php

Returns the name of the type of data the mapper encapsulates.

ConfigNamesMapperTest::testGetTypeName in core/modules/config_translation/tests/src/Unit/ConfigNamesMapperTest.php

Tests ConfigNamesMapper::getTypeName().

... See full list

1 service uses Settings

settings in core/core.services.yml

Drupal\Core\Site\Settings

File

core/lib/Drupal/Core/Site/Settings.php, line 13

Namespace

Drupal\Core\Site

final class Settings {

  /**
   * Array with the settings.
   *
   * @var array
   */
  private $storage = [];

  /**
   * Singleton instance.
   *
   * @var \Drupal\Core\Site\Settings
   */
  private static $instance = NULL;

  /**
   * Constructor.
   *
   * @param array $settings
   *   Array with the settings.
   */
  public function __construct(array $settings) {
    $this->storage = $settings;
    self::$instance = $this;
  }

  /**
   * Returns the settings instance.
   *
   * A singleton is used because this class is used before the container is
   * available.
   *
   * @return \Drupal\Core\Site\Settings
   *
   * @throws \BadMethodCallException
   *   Thrown when the settings instance has not been initialized yet.
   */
  public static function getInstance() {
    if (self::$instance === NULL) {
      throw new \BadMethodCallException('Settings::$instance is not initialized yet. Whatever you are trying to do, it might be too early for that. You could call Settings::initialize(), but it is probably better to wait until it is called in the regular way. Also check for recursions.');
    }
    return self::$instance;
  }

  /**
   * Protects creating with clone.
   */
  private function __clone() {
  }

  /**
   * Prevents settings from being serialized.
   */
  public function __sleep() {
    throw new \LogicException('Settings can not be serialized. This probably means you are serializing an object that has an indirect reference to the Settings object. Adjust your code so that is not necessary.');
  }

  /**
   * Returns a setting.
   *
   * Settings can be set in settings.php in the $settings array and requested
   * by this function. Settings should be used over configuration for read-only,
   * possibly low bootstrap configuration that is environment specific.
   *
   * @param string $name
   *   The name of the setting to return.
   * @param mixed $default
   *   (optional) The default value to use if this setting is not set.
   *
   * @return mixed
   *   The value of the setting, the provided default if not set.
   */
  public static function get($name, $default = NULL) {
    if ($name === 'install_profile' && isset(self::$instance->storage[$name])) {
      @trigger_error('To access the install profile in Drupal 8 use \\Drupal::installProfile() or inject the install_profile container parameter into your service. See https://www.drupal.org/node/2538996', E_USER_DEPRECATED);
    }
    return isset(self::$instance->storage[$name]) ? self::$instance->storage[$name] : $default;
  }

  /**
   * Returns all the settings. This is only used for testing purposes.
   *
   * @return array
   *   All the settings.
   */
  public static function getAll() {
    return self::$instance->storage;
  }

  /**
   * Bootstraps settings.php and the Settings singleton.
   *
   * @param string $app_root
   *   The app root.
   * @param string $site_path
   *   The current site path.
   * @param \Composer\Autoload\ClassLoader $class_loader
   *   The class loader that is used for this request. Passed by reference and
   *   exposed to the local scope of settings.php, so as to allow it to be
   *   decorated with Symfony's ApcClassLoader, for example.
   *
   * @see default.settings.php
   */
  public static function initialize($app_root, $site_path, &$class_loader) {

    // Export these settings.php variables to the global namespace.
    global $config_directories, $config;
    $settings = [];
    $config = [];
    $databases = [];
    if (is_readable($app_root . '/' . $site_path . '/settings.php')) {
      require $app_root . '/' . $site_path . '/settings.php';
    }

    // Initialize databases.
    foreach ($databases as $key => $targets) {
      foreach ($targets as $target => $info) {
        Database::addConnectionInfo($key, $target, $info);

        // If the database driver is provided by a module, then its code may
        // need to be instantiated prior to when the module's root namespace
        // is added to the autoloader, because that happens during service
        // container initialization but the container definition is likely in
        // the database. Therefore, allow the connection info to specify an
        // autoload directory for the driver.
        if (isset($info['autoload'])) {
          $class_loader
            ->addPsr4($info['namespace'] . '\\', $info['autoload']);
        }
      }
    }

    // For BC ensure the $config_directories global is set both in the global
    // and settings.
    if (!isset($settings['config_sync_directory']) && !empty($config_directories['sync'])) {
      @trigger_error('$config_directories[\'sync\'] has moved to $settings[\'config_sync_directory\']. See https://www.drupal.org/node/3018145.', E_USER_DEPRECATED);
      $settings['config_sync_directory'] = $config_directories['sync'];
    }
    elseif (isset($settings['config_sync_directory'])) {
      $config_directories['sync'] = $settings['config_sync_directory'];
    }

    // Initialize Settings.
    new Settings($settings);
  }

  /**
   * Gets a salt useful for hardening against SQL injection.
   *
   * @return string
   *   A salt based on information in settings.php, not in the database.
   *
   * @throws \RuntimeException
   */
  public static function getHashSalt() {
    $hash_salt = self::$instance
      ->get('hash_salt');

    // This should never happen, as it breaks user logins and many other
    // services. Therefore, explicitly notify the user (developer) by throwing
    // an exception.
    if (empty($hash_salt)) {
      throw new \RuntimeException('Missing $settings[\'hash_salt\'] in settings.php.');
    }
    return $hash_salt;
  }

  /**
   * Generates a prefix for APCu user cache keys.
   *
   * A standardized prefix is useful to allow visual inspection of an APCu user
   * cache. By default, this method will produce a unique prefix per site using
   * the hash salt. If the setting 'apcu_ensure_unique_prefix' is set to FALSE
   * then if the caller does not provide a $site_path only the Drupal root will
   * be used. This allows tests to use the same prefix ensuring that the number
   * of APCu items created during a full test run is kept to a minimum.
   * Additionally, if a multi site implementation does not use site specific
   * module directories setting apcu_ensure_unique_prefix would allow the sites
   * to share APCu cache items.
   *
   * @param $identifier
   *   An identifier for the prefix. For example, 'class_loader' or
   *   'cache_backend'.
   *
   * @return string
   *   The prefix for APCu user cache keys.
   *
   * @see https://www.drupal.org/project/drupal/issues/2926309
   */
  public static function getApcuPrefix($identifier, $root, $site_path = '') {
    if (static::get('apcu_ensure_unique_prefix', TRUE)) {
      return 'drupal.' . $identifier . '.' . \Drupal::VERSION . '.' . static::get('deployment_identifier') . '.' . hash_hmac('sha256', $identifier, static::get('hash_salt') . '.' . $root . '/' . $site_path);
    }
    return 'drupal.' . $identifier . '.' . \Drupal::VERSION . '.' . static::get('deployment_identifier') . '.' . Crypt::hashBase64($root . '/' . $site_path);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Settings::$instance	private static	property	Singleton instance.
Settings::$storage	private	property	Array with the settings.
Settings::get	public static	function	Returns a setting.
Settings::getAll	public static	function	Returns all the settings. This is only used for testing purposes.
Settings::getApcuPrefix	public static	function	Generates a prefix for APCu user cache keys.
Settings::getHashSalt	public static	function	Gets a salt useful for hardening against SQL injection.
Settings::getInstance	public static	function	Returns the settings instance.
Settings::initialize	public static	function	Bootstraps settings.php and the Settings singleton.
Settings::__clone	private	function	Protects creating with clone.
Settings::__construct	public	function	Constructor.
Settings::__sleep	public	function	Prevents settings from being serialized.