|
|
@@ -24,18 +24,18 @@
|
|
|
* 'sites/default' will be used.
|
|
|
*
|
|
|
* For example, for a fictitious site installed at
|
|
|
- * https://www.drupal.org:8080/mysite/test/, the 'settings.php' file is searched
|
|
|
+ * https://www.drupal.org:8080/my-site/test/, the 'settings.php' file is searched
|
|
|
* for in the following directories:
|
|
|
*
|
|
|
- * - sites/8080.www.drupal.org.mysite.test
|
|
|
- * - sites/www.drupal.org.mysite.test
|
|
|
- * - sites/drupal.org.mysite.test
|
|
|
- * - sites/org.mysite.test
|
|
|
+ * - sites/8080.www.drupal.org.my-site.test
|
|
|
+ * - sites/www.drupal.org.my-site.test
|
|
|
+ * - sites/drupal.org.my-site.test
|
|
|
+ * - sites/org.my-site.test
|
|
|
*
|
|
|
- * - sites/8080.www.drupal.org.mysite
|
|
|
- * - sites/www.drupal.org.mysite
|
|
|
- * - sites/drupal.org.mysite
|
|
|
- * - sites/org.mysite
|
|
|
+ * - sites/8080.www.drupal.org.my-site
|
|
|
+ * - sites/www.drupal.org.my-site
|
|
|
+ * - sites/drupal.org.my-site
|
|
|
+ * - sites/org.my-site
|
|
|
*
|
|
|
* - sites/8080.www.drupal.org
|
|
|
* - sites/www.drupal.org
|
|
|
@@ -46,8 +46,8 @@
|
|
|
*
|
|
|
* Note that if you are installing on a non-standard port number, prefix the
|
|
|
* hostname with that number. For example,
|
|
|
- * https://www.drupal.org:8080/mysite/test/ could be loaded from
|
|
|
- * sites/8080.www.drupal.org.mysite.test/.
|
|
|
+ * https://www.drupal.org:8080/my-site/test/ could be loaded from
|
|
|
+ * sites/8080.www.drupal.org.my-site.test/.
|
|
|
*
|
|
|
* @see example.sites.php
|
|
|
* @see \Drupal\Core\DrupalKernel::getSitePath()
|
|
|
@@ -77,9 +77,9 @@
|
|
|
*
|
|
|
* @code
|
|
|
* $databases['default']['default'] = [
|
|
|
- * 'database' => 'databasename',
|
|
|
- * 'username' => 'sqlusername',
|
|
|
- * 'password' => 'sqlpassword',
|
|
|
+ * 'database' => 'database_name',
|
|
|
+ * 'username' => 'sql_username',
|
|
|
+ * 'password' => 'sql_password',
|
|
|
* 'host' => 'localhost',
|
|
|
* 'port' => '3306',
|
|
|
* 'driver' => 'mysql',
|
|
|
@@ -181,8 +181,8 @@ $databases = [];
|
|
|
*
|
|
|
* WARNING: The above defaults are designed for database portability. Changing
|
|
|
* them may cause unexpected behavior, including potential data loss. See
|
|
|
- * https://www.drupal.org/developing/api/database/configuration for more
|
|
|
- * information on these defaults and the potential issues.
|
|
|
+ * https://www.drupal.org/docs/8/api/database-api/database-configuration for
|
|
|
+ * more information on these defaults and the potential issues.
|
|
|
*
|
|
|
* More details can be found in the constructor methods for each driver:
|
|
|
* - \Drupal\mysql\Driver\Database\mysql\Connection::__construct()
|
|
|
@@ -193,9 +193,9 @@ $databases = [];
|
|
|
* @code
|
|
|
* $databases['default']['default'] = [
|
|
|
* 'driver' => 'pgsql',
|
|
|
- * 'database' => 'databasename',
|
|
|
- * 'username' => 'sqlusername',
|
|
|
- * 'password' => 'sqlpassword',
|
|
|
+ * 'database' => 'database_name',
|
|
|
+ * 'username' => 'sql_username',
|
|
|
+ * 'password' => 'sql_password',
|
|
|
* 'host' => 'localhost',
|
|
|
* 'prefix' => '',
|
|
|
* ];
|
|
|
@@ -205,7 +205,7 @@ $databases = [];
|
|
|
* @code
|
|
|
* $databases['default']['default'] = [
|
|
|
* 'driver' => 'sqlite',
|
|
|
- * 'database' => '/path/to/databasefilename',
|
|
|
+ * 'database' => '/path/to/database_filename',
|
|
|
* ];
|
|
|
* @endcode
|
|
|
*
|
|
|
@@ -215,13 +215,34 @@ $databases = [];
|
|
|
* 'driver' => 'my_driver',
|
|
|
* 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
|
|
|
* 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
|
|
|
- * 'database' => 'databasename',
|
|
|
- * 'username' => 'sqlusername',
|
|
|
- * 'password' => 'sqlpassword',
|
|
|
+ * 'database' => 'database_name',
|
|
|
+ * 'username' => 'sql_username',
|
|
|
+ * 'password' => 'sql_password',
|
|
|
* 'host' => 'localhost',
|
|
|
* 'prefix' => '',
|
|
|
* ];
|
|
|
* @endcode
|
|
|
+ *
|
|
|
+ * Sample Database configuration format for a driver that is extending another
|
|
|
+ * database driver.
|
|
|
+ * @code
|
|
|
+ * $databases['default']['default'] = [
|
|
|
+ * 'driver' => 'my_driver',
|
|
|
+ * 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
|
|
|
+ * 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
|
|
|
+ * 'database' => 'database_name',
|
|
|
+ * 'username' => 'sql_username',
|
|
|
+ * 'password' => 'sql_password',
|
|
|
+ * 'host' => 'localhost',
|
|
|
+ * 'prefix' => '',
|
|
|
+ * 'dependencies' => [
|
|
|
+ * 'parent_module' => [
|
|
|
+ * 'namespace' => 'Drupal\parent_module',
|
|
|
+ * 'autoload' => 'core/modules/parent_module/src/',
|
|
|
+ * ],
|
|
|
+ * ],
|
|
|
+ * ];
|
|
|
+ * @endcode
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
@@ -334,14 +355,13 @@ $settings['update_free_access'] = FALSE;
|
|
|
* security, or encryption benefits. In an environment where Drupal
|
|
|
* is behind a reverse proxy, the real IP address of the client should
|
|
|
* be determined such that the correct client IP address is available
|
|
|
- * to Drupal's logging, statistics, and access management systems. In
|
|
|
- * the most simple scenario, the proxy server will add an
|
|
|
- * X-Forwarded-For header to the request that contains the client IP
|
|
|
- * address. However, HTTP headers are vulnerable to spoofing, where a
|
|
|
- * malicious client could bypass restrictions by setting the
|
|
|
- * X-Forwarded-For header directly. Therefore, Drupal's proxy
|
|
|
- * configuration requires the IP addresses of all remote proxies to be
|
|
|
- * specified in $settings['reverse_proxy_addresses'] to work correctly.
|
|
|
+ * to Drupal's logging and access management systems. In the most simple
|
|
|
+ * scenario, the proxy server will add an X-Forwarded-For header to the request
|
|
|
+ * that contains the client IP address. However, HTTP headers are vulnerable to
|
|
|
+ * spoofing, where a malicious client could bypass restrictions by setting the
|
|
|
+ * X-Forwarded-For header directly. Therefore, Drupal's proxy configuration
|
|
|
+ * requires the IP addresses of all remote proxies to be specified in
|
|
|
+ * $settings['reverse_proxy_addresses'] to work correctly.
|
|
|
*
|
|
|
* Enable this setting to get Drupal to determine the client IP from the
|
|
|
* X-Forwarded-For header. If you are unsure about this setting, do not have a
|
|
|
@@ -567,7 +587,7 @@ $settings['update_free_access'] = FALSE;
|
|
|
* the output of phpinfo(). The full output can contain sensitive information
|
|
|
* so by default Drupal removes some sections.
|
|
|
*
|
|
|
- * This behaviour can be configured by setting this variable to a different
|
|
|
+ * This behavior can be configured by setting this variable to a different
|
|
|
* value corresponding to the flags parameter of phpinfo().
|
|
|
*
|
|
|
* If you need to expose more information in the report - for example to debug a
|
|
|
@@ -710,6 +730,8 @@ $settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml';
|
|
|
* Provide a fully qualified class name here if you would like to provide an
|
|
|
* alternate implementation YAML parser. The class must implement the
|
|
|
* \Drupal\Component\Serialization\SerializationInterface interface.
|
|
|
+ *
|
|
|
+ * This setting is deprecated in Drupal 10.3 and removed in Drupal 11.
|
|
|
*/
|
|
|
# $settings['yaml_parser_class'] = NULL;
|
|
|
|
|
|
@@ -787,6 +809,16 @@ $settings['entity_update_batch_size'] = 50;
|
|
|
*/
|
|
|
$settings['entity_update_backup'] = TRUE;
|
|
|
|
|
|
+/**
|
|
|
+ * State caching.
|
|
|
+ *
|
|
|
+ * State caching uses the cache collector pattern to cache all requested keys
|
|
|
+ * from the state API in a single cache entry, which can greatly reduce the
|
|
|
+ * amount of database queries. However, some sites may use state with a
|
|
|
+ * lot of dynamic keys which could result in a very large cache.
|
|
|
+ */
|
|
|
+$settings['state_cache'] = TRUE;
|
|
|
+
|
|
|
/**
|
|
|
* Node migration type.
|
|
|
*
|
