default.settings.php 30.8 KB
Newer Older
1
<?php
Dries's avatar
Dries committed
2

3 4
// @codingStandardsIgnoreFile

5 6 7
/**
 * @file
 * Drupal site-specific configuration file.
8
 *
9
 * IMPORTANT NOTE:
10 11 12 13 14
 * This file may have been set to read-only by the Drupal installation program.
 * If you make changes to this file, be sure to protect it again after making
 * your modifications. Failure to remove write permissions to this file is a
 * security risk.
 *
15 16 17 18
 * In order to use the selection rules below the multisite aliasing file named
 * sites/sites.php must be present. Its optional settings will be loaded, and
 * the aliases in the array $sites will override the default directory rules
 * below. See sites/example.sites.php for more information about aliases.
19 20 21 22 23 24
 *
 * The configuration directory will be discovered by stripping the website's
 * hostname from left to right and pathname from right to left. The first
 * configuration file found will be used and any others will be ignored. If no
 * other configuration file is found then the default configuration file at
 * 'sites/default' will be used.
25
 *
26
 * For example, for a fictitious site installed at
27
 * https://www.drupal.org:8080/mysite/test/, the 'settings.php' file is searched
28
 * for in the following directories:
29
 *
30
 * - sites/8080.www.drupal.org.mysite.test
31 32 33
 * - sites/www.drupal.org.mysite.test
 * - sites/drupal.org.mysite.test
 * - sites/org.mysite.test
34
 *
35
 * - sites/8080.www.drupal.org.mysite
36 37 38
 * - sites/www.drupal.org.mysite
 * - sites/drupal.org.mysite
 * - sites/org.mysite
39
 *
40
 * - sites/8080.www.drupal.org
41 42 43
 * - sites/www.drupal.org
 * - sites/drupal.org
 * - sites/org
44
 *
45
 * - sites/default
46
 *
47
 * Note that if you are installing on a non-standard port number, prefix the
48
 * hostname with that number. For example,
49
 * https://www.drupal.org:8080/mysite/test/ could be loaded from
50
 * sites/8080.www.drupal.org.mysite.test/.
51 52
 *
 * @see example.sites.php
53
 * @see \Drupal\Core\DrupalKernel::getSitePath()
54 55 56 57 58
 *
 * In addition to customizing application settings through variables in
 * settings.php, you can create a services.yml file in the same directory to
 * register custom, site-specific service definitions and/or swap out default
 * implementations with custom ones.
59 60
 */

61 62 63
/**
 * Database settings:
 *
64
 * The $databases array specifies the database connection or
65 66 67 68
 * connections that Drupal may use.  Drupal is able to connect
 * to multiple databases, including multiple types of databases,
 * during the same request.
 *
69 70 71 72 73 74 75 76 77
 * One example of the simplest connection array is shown below. To use the
 * sample settings, copy and uncomment the code below between the @code and
 * @endcode lines and paste it after the $databases declaration. You will need
 * to replace the database username and password and possibly the host and port
 * with the appropriate credentials for your database system.
 *
 * The next section describes how to customize the $databases array for more
 * specific needs.
 *
78
 * @code
79
 * $databases['default']['default'] = array (
80
 *   'database' => 'databasename',
81 82
 *   'username' => 'sqlusername',
 *   'password' => 'sqlpassword',
83
 *   'host' => 'localhost',
84 85 86
 *   'port' => '3306',
 *   'driver' => 'mysql',
 *   'prefix' => '',
87
 *   'collation' => 'utf8mb4_general_ci',
88
 * );
89
 * @endcode
90
 */
91
$databases = array();
92 93 94 95 96 97 98

/**
 * Customizing database settings.
 *
 * Many of the values of the $databases array can be customized for your
 * particular database system. Refer to the sample in the section above as a
 * starting point.
99
 *
100
 * The "driver" property indicates what Drupal database driver the
101 102 103
 * connection should use.  This is usually the same as the name of the
 * database type, such as mysql or sqlite, but not always.  The other
 * properties will vary depending on the driver.  For SQLite, you must
104 105
 * specify a database file name in a directory that is writable by the
 * webserver.  For most other drivers, you must specify a
106
 * username, password, host, and database name.
107
 *
108 109 110 111 112 113 114
 * Transaction support is enabled by default for all drivers that support it,
 * including MySQL. To explicitly disable it, set the 'transactions' key to
 * FALSE.
 * Note that some configurations of MySQL, such as the MyISAM engine, don't
 * support it and will proceed silently even if enabled. If you experience
 * transaction related crashes with such configuration, set the 'transactions'
 * key to FALSE.
115 116 117 118
 *
 * For each database, you may optionally specify multiple "target" databases.
 * A target database allows Drupal to try to send certain queries to a
 * different database if it can but fall back to the default connection if not.
119 120 121 122
 * That is useful for primary/replica replication, as Drupal may try to connect
 * to a replica server when appropriate and if one is not available will simply
 * fall back to the single primary server (The terms primary/replica are
 * traditionally referred to as master/slave in database server documentation).
123 124
 *
 * The general format for the $databases array is as follows:
125
 * @code
126
 * $databases['default']['default'] = $info_array;
127 128
 * $databases['default']['replica'][] = $info_array;
 * $databases['default']['replica'][] = $info_array;
129
 * $databases['extra']['default'] = $info_array;
130
 * @endcode
131 132
 *
 * In the above example, $info_array is an array of settings described above.
133
 * The first line sets a "default" database that has one primary database
134
 * (the second level default).  The second and third lines create an array
135
 * of potential replica databases.  Drupal will select one at random for a given
136
 * request as needed.  The fourth line creates a new database with a name of
137
 * "extra".
138
 *
139
 * You can optionally set prefixes for some or all database table names
140
 * by using the 'prefix' setting. If a prefix is specified, the table
141 142 143 144
 * name will be prepended with its value. Be sure to use valid database
 * characters only, usually alphanumeric and underscore. If no prefixes
 * are desired, leave it as an empty string ''.
 *
145
 * To have all database names prefixed, set 'prefix' as a string:
146
 * @code
147
 *   'prefix' => 'main_',
148
 * @endcode
149 150 151 152 153
 *
 * Per-table prefixes are deprecated as of Drupal 8.2, and will be removed in
 * Drupal 9.0. After that, only a single prefix for all tables will be
 * supported.
 *
154
 * To provide prefixes for specific tables, set 'prefix' as an array.
155
 * The array's keys are the table names and the values are the prefixes.
156 157
 * The 'default' element is mandatory and holds the prefix for any tables
 * not specified elsewhere in the array. Example:
158
 * @code
159
 *   'prefix' => array(
160
 *     'default'   => 'main_',
161
 *     'users'     => 'shared_',
162 163 164
 *     'sessions'  => 'shared_',
 *     'role'      => 'shared_',
 *     'authmap'   => 'shared_',
165
 *   ),
166
 * @endcode
167
 * You can also use a reference to a schema/database as a prefix. This may be
168
 * useful if your Drupal installation exists in a schema that is not the default
169
 * or you want to access several databases from the same code base at the same
170 171
 * time.
 * Example:
172
 * @code
173 174 175
 *   'prefix' => array(
 *     'default'   => 'main.',
 *     'users'     => 'shared.',
176 177 178
 *     'sessions'  => 'shared.',
 *     'role'      => 'shared.',
 *     'authmap'   => 'shared.',
179
 *   );
180
 * @endcode
181 182
 * NOTE: MySQL and SQLite's definition of a schema is a database.
 *
183 184 185 186 187 188 189 190 191 192 193 194 195 196 197
 * Advanced users can add or override initial commands to execute when
 * connecting to the database server, as well as PDO connection settings. For
 * example, to enable MySQL SELECT queries to exceed the max_join_size system
 * variable, and to reduce the database connection timeout to 5 seconds:
 * @code
 * $databases['default']['default'] = array(
 *   'init_commands' => array(
 *     'big_selects' => 'SET SQL_BIG_SELECTS=1',
 *   ),
 *   'pdo' => array(
 *     PDO::ATTR_TIMEOUT => 5,
 *   ),
 * );
 * @endcode
 *
198 199 200 201
 * 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.
202
 *
203 204 205 206
 * More details can be found in the constructor methods for each driver:
 * - \Drupal\Core\Database\Driver\mysql\Connection::__construct()
 * - \Drupal\Core\Database\Driver\pgsql\Connection::__construct()
 * - \Drupal\Core\Database\Driver\sqlite\Connection::__construct()
207
 *
208
 * Sample Database configuration format for PostgreSQL (pgsql):
209
 * @code
210
 *   $databases['default']['default'] = array(
211 212
 *     'driver' => 'pgsql',
 *     'database' => 'databasename',
213 214
 *     'username' => 'sqlusername',
 *     'password' => 'sqlpassword',
215
 *     'host' => 'localhost',
216
 *     'prefix' => '',
217
 *   );
218 219 220 221
 * @endcode
 *
 * Sample Database configuration format for SQLite (sqlite):
 * @code
222
 *   $databases['default']['default'] = array(
223
 *     'driver' => 'sqlite',
224
 *     'database' => '/path/to/databasefilename',
225
 *   );
226
 * @endcode
227
 */
228

229 230 231
/**
 * Location of the site configuration files.
 *
232
 * The $config_directories array specifies the location of file system
233 234 235 236 237 238 239 240 241 242 243 244 245
 * directories used for configuration data. On install, the "sync" directory is
 * created. This is used for configuration imports. The "active" directory is
 * not created by default since the default storage for active configuration is
 * the database rather than the file system. (This can be changed. See "Active
 * configuration settings" below).
 *
 * The default location for the "sync" directory is inside a randomly-named
 * directory in the public files path. The setting below allows you to override
 * the "sync" location.
 *
 * If you use files for the "active" configuration, you can tell the
 * Configuration system where this directory is located by adding an entry with
 * array key CONFIG_ACTIVE_DIRECTORY.
246 247
 *
 * Example:
248 249
 * @code
 *   $config_directories = array(
250
 *     CONFIG_SYNC_DIRECTORY => '/directory/outside/webroot',
251 252
 *   );
 * @endcode
253
 */
254
$config_directories = array();
255

256 257 258
/**
 * Settings:
 *
259 260
 * $settings contains environment-specific configuration, such as the files
 * directory and reverse proxy address, and temporary configuration, such as
261
 * security overrides.
262
 *
263
 * @see \Drupal\Core\Site\Settings::get()
264 265
 */

266 267 268 269 270 271 272 273 274
/**
 * The active installation profile.
 *
 * Changing this after installation is not recommended as it changes which
 * directories are scanned during extension discovery. If this is set prior to
 * installation this value will be rewritten according to the profile selected
 * by the user.
 *
 * @see install_select_profile()
275 276 277 278 279
 *
 * @deprecated in Drupal 8.3.0 and will be removed before Drupal 9.0.0. The
 *   install profile is written to the core.extension configuration. If a
 *   service requires the install profile use the 'install_profile' container
 *   parameter. Functional code can use \Drupal::installProfile().
280 281 282
 */
# $settings['install_profile'] = '';

283 284 285 286 287 288 289 290
/**
 * Salt for one-time login links, cancel links, form tokens, etc.
 *
 * This variable will be set to a random value by the installer. All one-time
 * login links will be invalidated if the value is changed. Note that if your
 * site is deployed on a cluster of web servers, you must ensure that this
 * variable has the same value on each server.
 *
291 292 293
 * For enhanced security, you may set this variable to the contents of a file
 * outside your document root; you should also ensure that this file is not
 * stored with backups of your database.
294 295 296 297 298 299 300 301
 *
 * Example:
 * @code
 *   $settings['hash_salt'] = file_get_contents('/home/example/salt.txt');
 * @endcode
 */
$settings['hash_salt'] = '';

302 303 304 305 306 307 308 309 310 311
/**
 * Deployment identifier.
 *
 * Drupal's dependency injection container will be automatically invalidated and
 * rebuilt when the Drupal core version changes. When updating contributed or
 * custom code that changes the container, changing this identifier will also
 * allow the container to be invalidated as soon as code is deployed.
 */
# $settings['deployment_identifier'] = \Drupal::VERSION;

312 313 314 315 316 317 318 319 320 321 322 323
/**
 * Access control for update.php script.
 *
 * If you are updating your Drupal installation using the update.php script but
 * are not logged in using either an account with the "Administer software
 * updates" permission or the site maintenance account (the account that was
 * created during installation), you will need to modify the access check
 * statement below. Change the FALSE to a TRUE to disable the access check.
 * After finishing the upgrade, be sure to open this file again and change the
 * TRUE back to a FALSE!
 */
$settings['update_free_access'] = FALSE;
324

325 326 327
/**
 * External access proxy settings:
 *
328 329 330 331 332 333 334 335 336 337 338 339
 * If your site must access the Internet via a web proxy then you can enter the
 * proxy settings here. Set the full URL of the proxy, including the port, in
 * variables:
 * - $settings['http_client_config']['proxy']['http']: The proxy URL for HTTP
 *   requests.
 * - $settings['http_client_config']['proxy']['https']: The proxy URL for HTTPS
 *   requests.
 * You can pass in the user name and password for basic authentication in the
 * URLs in these settings.
 *
 * You can also define an array of host names that can be accessed directly,
 * bypassing the proxy, in $settings['http_client_config']['proxy']['no'].
340
 */
341 342 343
# $settings['http_client_config']['proxy']['http'] = 'http://proxy_user:proxy_pass@example.com:8080';
# $settings['http_client_config']['proxy']['https'] = 'http://proxy_user:proxy_pass@example.com:8080';
# $settings['http_client_config']['proxy']['no'] = ['127.0.0.1', 'localhost'];
344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387

/**
 * Reverse Proxy Configuration:
 *
 * Reverse proxy servers are often used to enhance the performance
 * of heavily visited sites and may also provide other site caching,
 * 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.
 *
 * Enable this setting to get Drupal to determine the client IP from
 * the X-Forwarded-For header (or $settings['reverse_proxy_header'] if set).
 * If you are unsure about this setting, do not have a reverse proxy,
 * or Drupal operates in a shared hosting environment, this setting
 * should remain commented out.
 *
 * In order for this setting to be used you must specify every possible
 * reverse proxy IP address in $settings['reverse_proxy_addresses'].
 * If a complete list of reverse proxies is not available in your
 * environment (for example, if you use a CDN) you may set the
 * $_SERVER['REMOTE_ADDR'] variable directly in settings.php.
 * Be aware, however, that it is likely that this would allow IP
 * address spoofing unless more advanced precautions are taken.
 */
# $settings['reverse_proxy'] = TRUE;

/**
 * Specify every reverse proxy IP address in your environment.
 * This setting is required if $settings['reverse_proxy'] is TRUE.
 */
# $settings['reverse_proxy_addresses'] = array('a.b.c.d', ...);

/**
 * Set this value if your proxy server sends the client IP in a header
 * other than X-Forwarded-For.
 */
388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412
# $settings['reverse_proxy_header'] = 'X_CLUSTER_CLIENT_IP';

/**
 * Set this value if your proxy server sends the client protocol in a header
 * other than X-Forwarded-Proto.
 */
# $settings['reverse_proxy_proto_header'] = 'X_FORWARDED_PROTO';

/**
 * Set this value if your proxy server sends the client protocol in a header
 * other than X-Forwarded-Host.
 */
# $settings['reverse_proxy_host_header'] = 'X_FORWARDED_HOST';

/**
 * Set this value if your proxy server sends the client protocol in a header
 * other than X-Forwarded-Port.
 */
# $settings['reverse_proxy_port_header'] = 'X_FORWARDED_PORT';

/**
 * Set this value if your proxy server sends the client protocol in a header
 * other than Forwarded.
 */
# $settings['reverse_proxy_forwarded_header'] = 'FORWARDED';
413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431

/**
 * Page caching:
 *
 * By default, Drupal sends a "Vary: Cookie" HTTP header for anonymous page
 * views. This tells a HTTP proxy that it may return a page from its local
 * cache without contacting the web server, if the user sends the same Cookie
 * header as the user who originally requested the cached page. Without "Vary:
 * Cookie", authenticated users would also be served the anonymous page from
 * the cache. If the site has mostly anonymous users except a few known
 * editors/administrators, the Vary header can be omitted. This allows for
 * better caching in HTTP proxies (including reverse proxies), i.e. even if
 * clients send different cookies, they still get content served from the cache.
 * However, authenticated users should access the site directly (i.e. not use an
 * HTTP proxy, and bypass the reverse proxy if one is used) in order to avoid
 * getting cached pages from the proxy.
 */
# $settings['omit_vary_cookie'] = TRUE;

432 433 434 435 436 437 438 439 440 441 442 443 444

/**
 * Cache TTL for client error (4xx) responses.
 *
 * Items cached per-URL tend to result in a large number of cache items, and
 * this can be problematic on 404 pages which by their nature are unbounded. A
 * fixed TTL can be set for these items, defaulting to one hour, so that cache
 * backends which do not support LRU can purge older entries. To disable caching
 * of client error responses set the value to 0. Currently applies only to
 * page_cache module.
 */
# $settings['cache_ttl_4xx'] = 3600;

445 446 447 448 449 450 451 452 453
/**
 * Expiration of cached forms.
 *
 * Drupal's Form API stores details of forms in a cache and these entries are
 * kept for at least 6 hours by default. Expired entries are cleared by cron.
 *
 * @see \Drupal\Core\Form\FormCache::setCache()
 */
# $settings['form_cache_expiration'] = 21600;
454

455 456 457
/**
 * Class Loader.
 *
458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474
 * If the APC extension is detected, the Symfony APC class loader is used for
 * performance reasons. Detection can be prevented by setting
 * class_loader_auto_detect to false, as in the example below.
 */
# $settings['class_loader_auto_detect'] = FALSE;

/*
 * If the APC extension is not detected, either because APC is missing or
 * because auto-detection has been disabled, auto-loading falls back to
 * Composer's ClassLoader, which is good for development as it does not break
 * when code is moved in the file system. You can also decorate the base class
 * loader with another cached solution than the Symfony APC class loader, as
 * all production sites should have a cached class loader of some sort enabled.
 *
 * To do so, you may decorate and replace the local $class_loader variable. For
 * example, to use Symfony's APC class loader without automatic detection,
 * uncomment the code below.
475
 */
476 477
/*
if ($settings['hash_salt']) {
478 479 480
  $prefix = 'drupal.' . hash('sha256', 'drupal.' . $settings['hash_salt']);
  $apc_loader = new \Symfony\Component\ClassLoader\ApcClassLoader($prefix, $class_loader);
  unset($prefix);
481 482 483 484 485
  $class_loader->unregister();
  $apc_loader->register();
  $class_loader = $apc_loader;
}
*/
486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504

/**
 * Authorized file system operations:
 *
 * The Update Manager module included with Drupal provides a mechanism for
 * site administrators to securely install missing updates for the site
 * directly through the web user interface. On securely-configured servers,
 * the Update manager will require the administrator to provide SSH or FTP
 * credentials before allowing the installation to proceed; this allows the
 * site to update the new files as the user who owns all the Drupal files,
 * instead of as the user the webserver is running as. On servers where the
 * webserver user is itself the owner of the Drupal files, the administrator
 * will not be prompted for SSH or FTP credentials (note that these server
 * setups are common on shared hosting, but are inherently insecure).
 *
 * Some sites might wish to disable the above functionality, and only update
 * the code directly via SSH or FTP themselves. This setting completely
 * disables all functionality related to these authorized file operations.
 *
505
 * @see https://www.drupal.org/node/244924
506 507 508 509 510
 *
 * Remove the leading hash signs to disable.
 */
# $settings['allow_authorize_operations'] = FALSE;

511
/**
512
 * Default mode for directories and files written by Drupal.
513 514 515 516 517 518
 *
 * Value should be in PHP Octal Notation, with leading zero.
 */
# $settings['file_chmod_directory'] = 0775;
# $settings['file_chmod_file'] = 0664;

519 520 521 522 523 524 525 526 527 528 529 530 531
/**
 * Public file base URL:
 *
 * An alternative base URL to be used for serving public files. This must
 * include any leading directory path.
 *
 * A different value from the domain used by Drupal to be used for accessing
 * public files. This can be used for a simple CDN integration, or to improve
 * security by serving user-uploaded files from a different domain or subdomain
 * pointing to the same server. Do not include a trailing slash.
 */
# $settings['file_public_base_url'] = 'http://downloads.example.com/files';

532 533 534 535 536 537 538 539 540
/**
 * Public file path:
 *
 * A local file system path where public files will be stored. This directory
 * must exist and be writable by Drupal. This directory must be relative to
 * the Drupal installation directory and be accessible over the web.
 */
# $settings['file_public_path'] = 'sites/default/files';

541 542 543 544
/**
 * Private file path:
 *
 * A local file system path where private files will be stored. This directory
545
 * must be absolute, outside of the Drupal installation directory and not
546 547
 * accessible over the web.
 *
548 549 550
 * Note: Caches need to be cleared when this value is changed to make the
 * private:// stream wrapper available to the system.
 *
551 552
 * See https://www.drupal.org/documentation/modules/file for more information
 * about securing private files.
553 554 555
 */
# $settings['file_private_path'] = '';

556 557 558 559 560 561 562 563
/**
 * Session write interval:
 *
 * Set the minimum interval between each session write to database.
 * For performance reasons it defaults to 180.
 */
# $settings['session_write_interval'] = 180;

564 565 566 567 568 569 570 571 572 573
/**
 * String overrides:
 *
 * To override specific strings on your site with or without enabling the Locale
 * module, add an entry to this list. This functionality allows you to change
 * a small number of your site's default English language interface strings.
 *
 * Remove the leading hash signs to enable.
 *
 * The "en" part of the variable name, is dynamic and can be any langcode of
574
 * any added language. (eg locale_custom_strings_de for german).
575 576 577 578 579 580
 */
# $settings['locale_custom_strings_en'][''] = array(
#   'forum'      => 'Discussion board',
#   '@count min' => '@count minutes',
# );

581 582 583 584 585 586
/**
 * A custom theme for the offline page:
 *
 * This applies when the site is explicitly set to maintenance mode through the
 * administration page or when the database is inactive due to an error.
 * The template file should also be copied into the theme. It is located inside
587 588
 * 'core/modules/system/templates/maintenance-page.html.twig'.
 *
589 590 591 592
 * Note: This setting does not apply to installation and update pages.
 */
# $settings['maintenance_theme'] = 'bartik';

593 594 595
/**
 * PHP settings:
 *
596
 * To see what PHP settings are possible, including whether they can be set at
597
 * runtime (by using ini_set()), read the PHP documentation:
598
 * http://php.net/manual/ini.list.php
599 600
 * See \Drupal\Core\DrupalKernel::bootEnvironment() for required runtime
 * settings and the .htaccess file for non-runtime settings.
601 602
 * Settings defined there should not be duplicated here so as to avoid conflict
 * issues.
603 604
 */

605 606 607 608 609 610
/**
 * If you encounter a situation where users post a large amount of text, and
 * the result is stripped out upon viewing but can still be edited, Drupal's
 * output filter may not have sufficient memory to process it.  If you
 * experience this issue, you may wish to uncomment the following two lines
 * and increase the limits of these variables.  For more information, see
611
 * http://php.net/manual/pcre.configuration.php.
612 613 614 615
 */
# ini_set('pcre.backtrack_limit', 200000);
# ini_set('pcre.recursion_limit', 200000);

616 617 618 619
/**
 * Active configuration settings.
 *
 * By default, the active configuration is stored in the database in the
620 621
 * {config} table. To use a different storage mechanism for the active
 * configuration, do the following prior to installing:
622 623 624 625
 * - Create an "active" directory and declare its path in $config_directories
 *   as explained under the 'Location of the site configuration files' section
 *   above in this file. To enhance security, you can declare a path that is
 *   outside your document root.
626 627 628 629 630 631
 * - Override the 'bootstrap_config_storage' setting here. It must be set to a
 *   callable that returns an object that implements
 *   \Drupal\Core\Config\StorageInterface.
 * - Override the service definition 'config.storage.active'. Put this
 *   override in a services.yml file in the same directory as settings.php
 *   (definitions in this file will override service definition defaults).
632
 */
633
# $settings['bootstrap_config_storage'] = array('Drupal\Core\Config\BootstrapConfigStorageFactory', 'getFileStorage');
634

635
/**
636
 * Configuration overrides.
637
 *
638
 * To globally override specific configuration values for this site,
Dries's avatar
Dries committed
639 640
 * set them here. You usually don't need to use this feature. This is
 * useful in a configuration file for a vhost or directory, rather than
641 642 643
 * the default settings.php.
 *
 * Note that any values you provide in these variable overrides will not be
644 645 646 647 648 649 650 651 652 653 654 655
 * viewable from the Drupal administration interface. The administration
 * interface displays the values stored in configuration so that you can stage
 * changes to other environments that don't have the overrides.
 *
 * There are particular configuration values that are risky to override. For
 * example, overriding the list of installed modules in 'core.extension' is not
 * supported as module install or uninstall has not occurred. Other examples
 * include field storage configuration, because it has effects on database
 * structure, and 'core.menu.static_menu_link_overrides' since this is cached in
 * a way that is not config override aware. Also, note that changing
 * configuration values in settings.php will not fire any of the configuration
 * change events.
656
 */
657
# $config['system.file']['path']['temporary'] = '/tmp';
658 659 660
# $config['system.site']['name'] = 'My Drupal site';
# $config['system.theme']['default'] = 'stark';
# $config['user.settings']['anonymous'] = 'Visitor';
661

662 663 664 665 666 667 668 669 670
/**
 * Fast 404 pages:
 *
 * Drupal can generate fully themed 404 pages. However, some of these responses
 * are for images or other resource files that are not displayed to the user.
 * This can waste bandwidth, and also generate server load.
 *
 * The options below return a simple, fast 404 page for URLs matching a
 * specific pattern:
671
 * - $config['system.performance']['fast_404']['exclude_paths']: A regular
672
 *   expression to match paths to exclude, such as images generated by image
673 674
 *   styles, or dynamically-resized images. The default pattern provided below
 *   also excludes the private file system. If you need to add more paths, you
675
 *   can add '|path' to the expression.
676
 * - $config['system.performance']['fast_404']['paths']: A regular expression to
677 678 679
 *   match paths that should return a simple 404 page, rather than the fully
 *   themed 404 page. If you don't have any aliases ending in htm or html you
 *   can add '|s?html?' to the expression.
680
 * - $config['system.performance']['fast_404']['html']: The html to return for
681
 *   simple 404 pages.
682
 *
683
 * Remove the leading hash signs if you would like to alter this functionality.
684
 */
685
# $config['system.performance']['fast_404']['exclude_paths'] = '/\/(?:styles)|(?:system\/files)\//';
686 687
# $config['system.performance']['fast_404']['paths'] = '/\.(?:txt|png|gif|jpe?g|css|js|ico|swf|flv|cgi|bat|pl|dll|exe|asp)$/i';
# $config['system.performance']['fast_404']['html'] = '<!DOCTYPE html><html><head><title>404 Not Found</title></head><body><h1>Not Found</h1><p>The requested URL "@path" was not found on this server.</p></body></html>';
688

689 690 691
/**
 * Load services definition file.
 */
692
$settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml';
693

694 695 696 697 698 699 700 701 702
/**
 * Override the default service container class.
 *
 * This is useful for example to trace the service container for performance
 * tracking purposes, for testing a service container with an error condition or
 * to test a service container that throws an exception.
 */
# $settings['container_base_class'] = '\Drupal\Core\DependencyInjection\Container';

703 704 705 706 707 708 709 710 711
/**
 * Override the default yaml parser class.
 *
 * 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.
 */
# $settings['yaml_parser_class'] = NULL;

712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740
/**
 * Trusted host configuration.
 *
 * Drupal core can use the Symfony trusted host mechanism to prevent HTTP Host
 * header spoofing.
 *
 * To enable the trusted host mechanism, you enable your allowable hosts
 * in $settings['trusted_host_patterns']. This should be an array of regular
 * expression patterns, without delimiters, representing the hosts you would
 * like to allow.
 *
 * For example:
 * @code
 * $settings['trusted_host_patterns'] = array(
 *   '^www\.example\.com$',
 * );
 * @endcode
 * will allow the site to only run from www.example.com.
 *
 * If you are running multisite, or if you are running your site from
 * different domain names (eg, you don't redirect http://www.example.com to
 * http://example.com), you should specify all of the host patterns that are
 * allowed by your site.
 *
 * For example:
 * @code
 * $settings['trusted_host_patterns'] = array(
 *   '^example\.com$',
 *   '^.+\.example\.com$',
741 742
 *   '^example\.org$',
 *   '^.+\.example\.org$',
743 744 745 746 747
 * );
 * @endcode
 * will allow the site to run off of all variants of example.com and
 * example.org, with all subdomains included.
 */
748

749 750 751 752 753 754 755 756 757 758 759 760 761 762 763
/**
 * The default list of directories that will be ignored by Drupal's file API.
 *
 * By default ignore node_modules and bower_components folders to avoid issues
 * with common frontend tools and recursive scanning of directories looking for
 * extensions.
 *
 * @see file_scan_directory()
 * @see \Drupal\Core\Extension\ExtensionDiscovery::scanDirectory()
 */
$settings['file_scan_ignore_directories'] = [
  'node_modules',
  'bower_components',
];

764 765 766 767 768 769 770 771 772 773
/**
 * The default number of entities to update in a batch process.
 *
 * This is used by update and post-update functions that need to go through and
 * change all the entities on a site, so it is useful to increase this number
 * if your hosting configuration (i.e. RAM allocation, CPU speed) allows for a
 * larger number of entities to be processed in a single batch run.
 */
$settings['entity_update_batch_size'] = 50;

774 775 776 777 778 779 780 781 782 783
/**
 * Load local development override configuration, if available.
 *
 * Use settings.local.php to override variables on secondary (staging,
 * development, etc) installations of this site. Typically used to disable
 * caching, JavaScript/CSS compression, re-routing of outgoing emails, and
 * other things that should not happen on development and testing sites.
 *
 * Keep this code block at the end of this file to take full effect.
 */
784 785 786
#
# if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
#   include $app_root . '/' . $site_path . '/settings.local.php';
787
# }