github.com/drud/ddev@v1.21.5-alpha1.0.20230226034409-94fcc4b94453/pkg/ddevapp/drupal/drupal8/settings.php (about) 1 <?php 2 3 // @codingStandardsIgnoreFile 4 5 /** 6 * @file 7 * Drupal site-specific configuration file. 8 * 9 * IMPORTANT NOTE: 10 * This file may have been set to read-only by the Drupal installation program. 11 * If you make changes to this file, be sure to protect it again after making 12 * your modifications. Failure to remove write permissions to this file is a 13 * security risk. 14 * 15 * In order to use the selection rules below the multisite aliasing file named 16 * sites/sites.php must be present. Its optional settings will be loaded, and 17 * the aliases in the array $sites will override the default directory rules 18 * below. See sites/example.sites.php for more information about aliases. 19 * 20 * The configuration directory will be discovered by stripping the website's 21 * hostname from left to right and pathname from right to left. The first 22 * configuration file found will be used and any others will be ignored. If no 23 * other configuration file is found then the default configuration file at 24 * '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 * - sites/www.drupal.org.mysite.test 32 * - sites/drupal.org.mysite.test 33 * - sites/org.mysite.test 34 * 35 * - sites/8080.www.drupal.org.mysite 36 * - sites/www.drupal.org.mysite 37 * - sites/drupal.org.mysite 38 * - sites/org.mysite 39 * 40 * - sites/8080.www.drupal.org 41 * - sites/www.drupal.org 42 * - sites/drupal.org 43 * - 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 * In addition to customizing application settings through variables in 56 * settings.php, you can create a services.yml file in the same directory to 57 * register custom, site-specific service definitions and/or swap out default 58 * implementations with custom ones. 59 */ 60 61 /** 62 * Database settings: 63 * 64 * The $databases array specifies the database connection or 65 * connections that Drupal may use. Drupal is able to connect 66 * to multiple databases, including multiple types of databases, 67 * during the same request. 68 * 69 * One example of the simplest connection array is shown below. To use the 70 * sample settings, copy and uncomment the code below between the @code and 71 * @endcode lines and paste it after the $databases declaration. You will need 72 * to replace the database username and password and possibly the host and port 73 * with the appropriate credentials for your database system. 74 * 75 * The next section describes how to customize the $databases array for more 76 * specific needs. 77 * 78 * @code 79 * $databases['default']['default'] = [ 80 * 'database' => 'databasename', 81 * 'username' => 'sqlusername', 82 * 'password' => 'sqlpassword', 83 * 'host' => 'localhost', 84 * 'port' => '3306', 85 * 'driver' => 'mysql', 86 * 'prefix' => '', 87 * 'collation' => 'utf8mb4_general_ci', 88 * ]; 89 * @endcode 90 */ 91 $databases = []; 92 93 /** 94 * Customizing database settings. 95 * 96 * Many of the values of the $databases array can be customized for your 97 * particular database system. Refer to the sample in the section above as a 98 * starting point. 99 * 100 * The "driver" property indicates what Drupal database driver the 101 * connection should use. This is usually the same as the name of the 102 * database type, such as mysql or sqlite, but not always. The other 103 * properties will vary depending on the driver. For SQLite, you must 104 * specify a database file name in a directory that is writable by the 105 * webserver. For most other drivers, you must specify a 106 * username, password, host, and database name. 107 * 108 * Drupal core implements drivers for mysql, pgsql, and sqlite. Other drivers 109 * can be provided by contributed or custom modules. To use a contributed or 110 * custom driver, the "namespace" property must be set to the namespace of the 111 * driver. The code in this namespace must be autoloadable prior to connecting 112 * to the database, and therefore, prior to when module root namespaces are 113 * added to the autoloader. To add the driver's namespace to the autoloader, 114 * set the "autoload" property to the PSR-4 base directory of the driver's 115 * namespace. This is optional for projects managed with Composer if the 116 * driver's namespace is in Composer's autoloader. 117 * 118 * Transaction support is enabled by default for all drivers that support it, 119 * including MySQL. To explicitly disable it, set the 'transactions' key to 120 * FALSE. 121 * Note that some configurations of MySQL, such as the MyISAM engine, don't 122 * support it and will proceed silently even if enabled. If you experience 123 * transaction related crashes with such configuration, set the 'transactions' 124 * key to FALSE. 125 * 126 * For each database, you may optionally specify multiple "target" databases. 127 * A target database allows Drupal to try to send certain queries to a 128 * different database if it can but fall back to the default connection if not. 129 * That is useful for primary/replica replication, as Drupal may try to connect 130 * to a replica server when appropriate and if one is not available will simply 131 * fall back to the single primary server (The terms primary/replica are 132 * traditionally referred to as master/slave in database server documentation). 133 * 134 * The general format for the $databases array is as follows: 135 * @code 136 * $databases['default']['default'] = $info_array; 137 * $databases['default']['replica'][] = $info_array; 138 * $databases['default']['replica'][] = $info_array; 139 * $databases['extra']['default'] = $info_array; 140 * @endcode 141 * 142 * In the above example, $info_array is an array of settings described above. 143 * The first line sets a "default" database that has one primary database 144 * (the second level default). The second and third lines create an array 145 * of potential replica databases. Drupal will select one at random for a given 146 * request as needed. The fourth line creates a new database with a name of 147 * "extra". 148 * 149 * You can optionally set prefixes for some or all database table names 150 * by using the 'prefix' setting. If a prefix is specified, the table 151 * name will be prepended with its value. Be sure to use valid database 152 * characters only, usually alphanumeric and underscore. If no prefixes 153 * are desired, leave it as an empty string ''. 154 * 155 * To have all database names prefixed, set 'prefix' as a string: 156 * @code 157 * 'prefix' => 'main_', 158 * @endcode 159 * 160 * Per-table prefixes are deprecated as of Drupal 8.2, and will be removed in 161 * Drupal 9.0. After that, only a single prefix for all tables will be 162 * supported. 163 * 164 * To provide prefixes for specific tables, set 'prefix' as an array. 165 * The array's keys are the table names and the values are the prefixes. 166 * The 'default' element is mandatory and holds the prefix for any tables 167 * not specified elsewhere in the array. Example: 168 * @code 169 * 'prefix' => [ 170 * 'default' => 'main_', 171 * 'users' => 'shared_', 172 * 'sessions' => 'shared_', 173 * 'role' => 'shared_', 174 * 'authmap' => 'shared_', 175 * ], 176 * @endcode 177 * You can also use a reference to a schema/database as a prefix. This may be 178 * useful if your Drupal installation exists in a schema that is not the default 179 * or you want to access several databases from the same code base at the same 180 * time. 181 * Example: 182 * @code 183 * 'prefix' => [ 184 * 'default' => 'main.', 185 * 'users' => 'shared.', 186 * 'sessions' => 'shared.', 187 * 'role' => 'shared.', 188 * 'authmap' => 'shared.', 189 * ]; 190 * @endcode 191 * NOTE: MySQL and SQLite's definition of a schema is a database. 192 * 193 * Advanced users can add or override initial commands to execute when 194 * connecting to the database server, as well as PDO connection settings. For 195 * example, to enable MySQL SELECT queries to exceed the max_join_size system 196 * variable, and to reduce the database connection timeout to 5 seconds: 197 * @code 198 * $databases['default']['default'] = [ 199 * 'init_commands' => [ 200 * 'big_selects' => 'SET SQL_BIG_SELECTS=1', 201 * ], 202 * 'pdo' => [ 203 * PDO::ATTR_TIMEOUT => 5, 204 * ], 205 * ]; 206 * @endcode 207 * 208 * WARNING: The above defaults are designed for database portability. Changing 209 * them may cause unexpected behavior, including potential data loss. See 210 * https://www.drupal.org/developing/api/database/configuration for more 211 * information on these defaults and the potential issues. 212 * 213 * More details can be found in the constructor methods for each driver: 214 * - \Drupal\Core\Database\Driver\mysql\Connection::__construct() 215 * - \Drupal\Core\Database\Driver\pgsql\Connection::__construct() 216 * - \Drupal\Core\Database\Driver\sqlite\Connection::__construct() 217 * 218 * Sample Database configuration format for PostgreSQL (pgsql): 219 * @code 220 * $databases['default']['default'] = [ 221 * 'driver' => 'pgsql', 222 * 'database' => 'databasename', 223 * 'username' => 'sqlusername', 224 * 'password' => 'sqlpassword', 225 * 'host' => 'localhost', 226 * 'prefix' => '', 227 * ]; 228 * @endcode 229 * 230 * Sample Database configuration format for SQLite (sqlite): 231 * @code 232 * $databases['default']['default'] = [ 233 * 'driver' => 'sqlite', 234 * 'database' => '/path/to/databasefilename', 235 * ]; 236 * @endcode 237 * 238 * Sample Database configuration format for a driver in a contributed module: 239 * @code 240 * $databases['default']['default'] = [ 241 * 'driver' => 'mydriver', 242 * 'namespace' => 'Drupal\mymodule\Driver\Database\mydriver', 243 * 'autoload' => 'modules/mymodule/src/Driver/Database/mydriver/', 244 * 'database' => 'databasename', 245 * 'username' => 'sqlusername', 246 * 'password' => 'sqlpassword', 247 * 'host' => 'localhost', 248 * 'prefix' => '', 249 * ]; 250 * @endcode 251 */ 252 253 /** 254 * Location of the site configuration files. 255 * 256 * The $settings['config_sync_directory'] specifies the location of file system 257 * directory used for syncing configuration data. On install, the directory is 258 * created. This is used for configuration imports. 259 * 260 * The default location for this directory is inside a randomly-named 261 * directory in the public files path. The setting below allows you to set 262 * its location. 263 */ 264 # $settings['config_sync_directory'] = '/directory/outside/webroot'; 265 266 /** 267 * Settings: 268 * 269 * $settings contains environment-specific configuration, such as the files 270 * directory and reverse proxy address, and temporary configuration, such as 271 * security overrides. 272 * 273 * @see \Drupal\Core\Site\Settings::get() 274 */ 275 276 /** 277 * Salt for one-time login links, cancel links, form tokens, etc. 278 * 279 * This variable will be set to a random value by the installer. All one-time 280 * login links will be invalidated if the value is changed. Note that if your 281 * site is deployed on a cluster of web servers, you must ensure that this 282 * variable has the same value on each server. 283 * 284 * For enhanced security, you may set this variable to the contents of a file 285 * outside your document root; you should also ensure that this file is not 286 * stored with backups of your database. 287 * 288 * Example: 289 * @code 290 * $settings['hash_salt'] = file_get_contents('/home/example/salt.txt'); 291 * @endcode 292 */ 293 $settings['hash_salt'] = ''; 294 295 /** 296 * Deployment identifier. 297 * 298 * Drupal's dependency injection container will be automatically invalidated and 299 * rebuilt when the Drupal core version changes. When updating contributed or 300 * custom code that changes the container, changing this identifier will also 301 * allow the container to be invalidated as soon as code is deployed. 302 */ 303 # $settings['deployment_identifier'] = \Drupal::VERSION; 304 305 /** 306 * Access control for update.php script. 307 * 308 * If you are updating your Drupal installation using the update.php script but 309 * are not logged in using either an account with the "Administer software 310 * updates" permission or the site maintenance account (the account that was 311 * created during installation), you will need to modify the access check 312 * statement below. Change the FALSE to a TRUE to disable the access check. 313 * After finishing the upgrade, be sure to open this file again and change the 314 * TRUE back to a FALSE! 315 */ 316 $settings['update_free_access'] = FALSE; 317 318 /** 319 * External access proxy settings: 320 * 321 * If your site must access the Internet via a web proxy then you can enter the 322 * proxy settings here. Set the full URL of the proxy, including the port, in 323 * variables: 324 * - $settings['http_client_config']['proxy']['http']: The proxy URL for HTTP 325 * requests. 326 * - $settings['http_client_config']['proxy']['https']: The proxy URL for HTTPS 327 * requests. 328 * You can pass in the user name and password for basic authentication in the 329 * URLs in these settings. 330 * 331 * You can also define an array of host names that can be accessed directly, 332 * bypassing the proxy, in $settings['http_client_config']['proxy']['no']. 333 */ 334 # $settings['http_client_config']['proxy']['http'] = 'http://proxy_user:proxy_pass@example.com:8080'; 335 # $settings['http_client_config']['proxy']['https'] = 'http://proxy_user:proxy_pass@example.com:8080'; 336 # $settings['http_client_config']['proxy']['no'] = ['127.0.0.1', 'localhost']; 337 338 /** 339 * Reverse Proxy Configuration: 340 * 341 * Reverse proxy servers are often used to enhance the performance 342 * of heavily visited sites and may also provide other site caching, 343 * security, or encryption benefits. In an environment where Drupal 344 * is behind a reverse proxy, the real IP address of the client should 345 * be determined such that the correct client IP address is available 346 * to Drupal's logging, statistics, and access management systems. In 347 * the most simple scenario, the proxy server will add an 348 * X-Forwarded-For header to the request that contains the client IP 349 * address. However, HTTP headers are vulnerable to spoofing, where a 350 * malicious client could bypass restrictions by setting the 351 * X-Forwarded-For header directly. Therefore, Drupal's proxy 352 * configuration requires the IP addresses of all remote proxies to be 353 * specified in $settings['reverse_proxy_addresses'] to work correctly. 354 * 355 * Enable this setting to get Drupal to determine the client IP from the 356 * X-Forwarded-For header. If you are unsure about this setting, do not have a 357 * reverse proxy, or Drupal operates in a shared hosting environment, this 358 * setting should remain commented out. 359 * 360 * In order for this setting to be used you must specify every possible 361 * reverse proxy IP address in $settings['reverse_proxy_addresses']. 362 * If a complete list of reverse proxies is not available in your 363 * environment (for example, if you use a CDN) you may set the 364 * $_SERVER['REMOTE_ADDR'] variable directly in settings.php. 365 * Be aware, however, that it is likely that this would allow IP 366 * address spoofing unless more advanced precautions are taken. 367 */ 368 # $settings['reverse_proxy'] = TRUE; 369 370 /** 371 * Specify every reverse proxy IP address in your environment. 372 * This setting is required if $settings['reverse_proxy'] is TRUE. 373 */ 374 # $settings['reverse_proxy_addresses'] = ['a.b.c.d', ...]; 375 376 /** 377 * Reverse proxy trusted headers. 378 * 379 * Sets which headers to trust from your reverse proxy. 380 * 381 * Common values are: 382 * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL 383 * - \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED 384 * 385 * Note the default value of 386 * @code 387 * \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL | \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED 388 * @endcode 389 * is not secure by default. The value should be set to only the specific 390 * headers the reverse proxy uses. For example: 391 * @code 392 * \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL 393 * @endcode 394 * This would trust the following headers: 395 * - X_FORWARDED_FOR 396 * - X_FORWARDED_HOST 397 * - X_FORWARDED_PROTO 398 * - X_FORWARDED_PORT 399 * 400 * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL 401 * @see \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED 402 * @see \Symfony\Component\HttpFoundation\Request::setTrustedProxies 403 */ 404 # $settings['reverse_proxy_trusted_headers'] = \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL | \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED; 405 406 407 /** 408 * Page caching: 409 * 410 * By default, Drupal sends a "Vary: Cookie" HTTP header for anonymous page 411 * views. This tells a HTTP proxy that it may return a page from its local 412 * cache without contacting the web server, if the user sends the same Cookie 413 * header as the user who originally requested the cached page. Without "Vary: 414 * Cookie", authenticated users would also be served the anonymous page from 415 * the cache. If the site has mostly anonymous users except a few known 416 * editors/administrators, the Vary header can be omitted. This allows for 417 * better caching in HTTP proxies (including reverse proxies), i.e. even if 418 * clients send different cookies, they still get content served from the cache. 419 * However, authenticated users should access the site directly (i.e. not use an 420 * HTTP proxy, and bypass the reverse proxy if one is used) in order to avoid 421 * getting cached pages from the proxy. 422 */ 423 # $settings['omit_vary_cookie'] = TRUE; 424 425 426 /** 427 * Cache TTL for client error (4xx) responses. 428 * 429 * Items cached per-URL tend to result in a large number of cache items, and 430 * this can be problematic on 404 pages which by their nature are unbounded. A 431 * fixed TTL can be set for these items, defaulting to one hour, so that cache 432 * backends which do not support LRU can purge older entries. To disable caching 433 * of client error responses set the value to 0. Currently applies only to 434 * page_cache module. 435 */ 436 # $settings['cache_ttl_4xx'] = 3600; 437 438 /** 439 * Expiration of cached forms. 440 * 441 * Drupal's Form API stores details of forms in a cache and these entries are 442 * kept for at least 6 hours by default. Expired entries are cleared by cron. 443 * 444 * @see \Drupal\Core\Form\FormCache::setCache() 445 */ 446 # $settings['form_cache_expiration'] = 21600; 447 448 /** 449 * Class Loader. 450 * 451 * If the APC extension is detected, the Symfony APC class loader is used for 452 * performance reasons. Detection can be prevented by setting 453 * class_loader_auto_detect to false, as in the example below. 454 */ 455 # $settings['class_loader_auto_detect'] = FALSE; 456 457 /* 458 * If the APC extension is not detected, either because APC is missing or 459 * because auto-detection has been disabled, auto-loading falls back to 460 * Composer's ClassLoader, which is good for development as it does not break 461 * when code is moved in the file system. You can also decorate the base class 462 * loader with another cached solution than the Symfony APC class loader, as 463 * all production sites should have a cached class loader of some sort enabled. 464 * 465 * To do so, you may decorate and replace the local $class_loader variable. For 466 * example, to use Symfony's APC class loader without automatic detection, 467 * uncomment the code below. 468 */ 469 /* 470 if ($settings['hash_salt']) { 471 $prefix = 'drupal.' . hash('sha256', 'drupal.' . $settings['hash_salt']); 472 $apc_loader = new \Symfony\Component\ClassLoader\ApcClassLoader($prefix, $class_loader); 473 unset($prefix); 474 $class_loader->unregister(); 475 $apc_loader->register(); 476 $class_loader = $apc_loader; 477 } 478 */ 479 480 /** 481 * Authorized file system operations: 482 * 483 * The Update Manager module included with Drupal provides a mechanism for 484 * site administrators to securely install missing updates for the site 485 * directly through the web user interface. On securely-configured servers, 486 * the Update manager will require the administrator to provide SSH or FTP 487 * credentials before allowing the installation to proceed; this allows the 488 * site to update the new files as the user who owns all the Drupal files, 489 * instead of as the user the webserver is running as. On servers where the 490 * webserver user is itself the owner of the Drupal files, the administrator 491 * will not be prompted for SSH or FTP credentials (note that these server 492 * setups are common on shared hosting, but are inherently insecure). 493 * 494 * Some sites might wish to disable the above functionality, and only update 495 * the code directly via SSH or FTP themselves. This setting completely 496 * disables all functionality related to these authorized file operations. 497 * 498 * @see https://www.drupal.org/node/244924 499 * 500 * Remove the leading hash signs to disable. 501 */ 502 # $settings['allow_authorize_operations'] = FALSE; 503 504 /** 505 * Default mode for directories and files written by Drupal. 506 * 507 * Value should be in PHP Octal Notation, with leading zero. 508 */ 509 # $settings['file_chmod_directory'] = 0775; 510 # $settings['file_chmod_file'] = 0664; 511 512 /** 513 * Public file base URL: 514 * 515 * An alternative base URL to be used for serving public files. This must 516 * include any leading directory path. 517 * 518 * A different value from the domain used by Drupal to be used for accessing 519 * public files. This can be used for a simple CDN integration, or to improve 520 * security by serving user-uploaded files from a different domain or subdomain 521 * pointing to the same server. Do not include a trailing slash. 522 */ 523 # $settings['file_public_base_url'] = 'http://downloads.example.com/files'; 524 525 /** 526 * Public file path: 527 * 528 * A local file system path where public files will be stored. This directory 529 * must exist and be writable by Drupal. This directory must be relative to 530 * the Drupal installation directory and be accessible over the web. 531 */ 532 # $settings['file_public_path'] = 'sites/default/files'; 533 534 /** 535 * Private file path: 536 * 537 * A local file system path where private files will be stored. This directory 538 * must be absolute, outside of the Drupal installation directory and not 539 * accessible over the web. 540 * 541 * Note: Caches need to be cleared when this value is changed to make the 542 * private:// stream wrapper available to the system. 543 * 544 * See https://www.drupal.org/documentation/modules/file for more information 545 * about securing private files. 546 */ 547 # $settings['file_private_path'] = ''; 548 549 /** 550 * Temporary file path: 551 * 552 * A local file system path where temporary files will be stored. This directory 553 * must be absolute, outside of the Drupal installation directory and not 554 * accessible over the web. 555 * 556 * If this is not set, the default for the operating system will be used. 557 * 558 * @see \Drupal\Component\FileSystem\FileSystem::getOsTemporaryDirectory() 559 */ 560 # $settings['file_temp_path'] = '/tmp'; 561 562 /** 563 * Session write interval: 564 * 565 * Set the minimum interval between each session write to database. 566 * For performance reasons it defaults to 180. 567 */ 568 # $settings['session_write_interval'] = 180; 569 570 /** 571 * String overrides: 572 * 573 * To override specific strings on your site with or without enabling the Locale 574 * module, add an entry to this list. This functionality allows you to change 575 * a small number of your site's default English language interface strings. 576 * 577 * Remove the leading hash signs to enable. 578 * 579 * The "en" part of the variable name, is dynamic and can be any langcode of 580 * any added language. (eg locale_custom_strings_de for german). 581 */ 582 # $settings['locale_custom_strings_en'][''] = [ 583 # 'forum' => 'Discussion board', 584 # '@count min' => '@count minutes', 585 # ]; 586 587 /** 588 * A custom theme for the offline page: 589 * 590 * This applies when the site is explicitly set to maintenance mode through the 591 * administration page or when the database is inactive due to an error. 592 * The template file should also be copied into the theme. It is located inside 593 * 'core/modules/system/templates/maintenance-page.html.twig'. 594 * 595 * Note: This setting does not apply to installation and update pages. 596 */ 597 # $settings['maintenance_theme'] = 'bartik'; 598 599 /** 600 * PHP settings: 601 * 602 * To see what PHP settings are possible, including whether they can be set at 603 * runtime (by using ini_set()), read the PHP documentation: 604 * http://php.net/manual/ini.list.php 605 * See \Drupal\Core\DrupalKernel::bootEnvironment() for required runtime 606 * settings and the .htaccess file for non-runtime settings. 607 * Settings defined there should not be duplicated here so as to avoid conflict 608 * issues. 609 */ 610 611 /** 612 * If you encounter a situation where users post a large amount of text, and 613 * the result is stripped out upon viewing but can still be edited, Drupal's 614 * output filter may not have sufficient memory to process it. If you 615 * experience this issue, you may wish to uncomment the following two lines 616 * and increase the limits of these variables. For more information, see 617 * http://php.net/manual/pcre.configuration.php. 618 */ 619 # ini_set('pcre.backtrack_limit', 200000); 620 # ini_set('pcre.recursion_limit', 200000); 621 622 /** 623 * Configuration overrides. 624 * 625 * To globally override specific configuration values for this site, 626 * set them here. You usually don't need to use this feature. This is 627 * useful in a configuration file for a vhost or directory, rather than 628 * the default settings.php. 629 * 630 * Note that any values you provide in these variable overrides will not be 631 * viewable from the Drupal administration interface. The administration 632 * interface displays the values stored in configuration so that you can stage 633 * changes to other environments that don't have the overrides. 634 * 635 * There are particular configuration values that are risky to override. For 636 * example, overriding the list of installed modules in 'core.extension' is not 637 * supported as module install or uninstall has not occurred. Other examples 638 * include field storage configuration, because it has effects on database 639 * structure, and 'core.menu.static_menu_link_overrides' since this is cached in 640 * a way that is not config override aware. Also, note that changing 641 * configuration values in settings.php will not fire any of the configuration 642 * change events. 643 */ 644 # $config['system.site']['name'] = 'My Drupal site'; 645 # $config['user.settings']['anonymous'] = 'Visitor'; 646 647 /** 648 * Fast 404 pages: 649 * 650 * Drupal can generate fully themed 404 pages. However, some of these responses 651 * are for images or other resource files that are not displayed to the user. 652 * This can waste bandwidth, and also generate server load. 653 * 654 * The options below return a simple, fast 404 page for URLs matching a 655 * specific pattern: 656 * - $config['system.performance']['fast_404']['exclude_paths']: A regular 657 * expression to match paths to exclude, such as images generated by image 658 * styles, or dynamically-resized images. The default pattern provided below 659 * also excludes the private file system. If you need to add more paths, you 660 * can add '|path' to the expression. 661 * - $config['system.performance']['fast_404']['paths']: A regular expression to 662 * match paths that should return a simple 404 page, rather than the fully 663 * themed 404 page. If you don't have any aliases ending in htm or html you 664 * can add '|s?html?' to the expression. 665 * - $config['system.performance']['fast_404']['html']: The html to return for 666 * simple 404 pages. 667 * 668 * Remove the leading hash signs if you would like to alter this functionality. 669 */ 670 # $config['system.performance']['fast_404']['exclude_paths'] = '/\/(?:styles)|(?:system\/files)\//'; 671 # $config['system.performance']['fast_404']['paths'] = '/\.(?:txt|png|gif|jpe?g|css|js|ico|swf|flv|cgi|bat|pl|dll|exe|asp)$/i'; 672 # $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>'; 673 674 /** 675 * Load services definition file. 676 */ 677 $settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml'; 678 679 /** 680 * Override the default service container class. 681 * 682 * This is useful for example to trace the service container for performance 683 * tracking purposes, for testing a service container with an error condition or 684 * to test a service container that throws an exception. 685 */ 686 # $settings['container_base_class'] = '\Drupal\Core\DependencyInjection\Container'; 687 688 /** 689 * Override the default yaml parser class. 690 * 691 * Provide a fully qualified class name here if you would like to provide an 692 * alternate implementation YAML parser. The class must implement the 693 * \Drupal\Component\Serialization\SerializationInterface interface. 694 */ 695 # $settings['yaml_parser_class'] = NULL; 696 697 /** 698 * Trusted host configuration. 699 * 700 * Drupal core can use the Symfony trusted host mechanism to prevent HTTP Host 701 * header spoofing. 702 * 703 * To enable the trusted host mechanism, you enable your allowable hosts 704 * in $settings['trusted_host_patterns']. This should be an array of regular 705 * expression patterns, without delimiters, representing the hosts you would 706 * like to allow. 707 * 708 * For example: 709 * @code 710 * $settings['trusted_host_patterns'] = [ 711 * '^www\.example\.com$', 712 * ]; 713 * @endcode 714 * will allow the site to only run from www.example.com. 715 * 716 * If you are running multisite, or if you are running your site from 717 * different domain names (eg, you don't redirect http://www.example.com to 718 * http://example.com), you should specify all of the host patterns that are 719 * allowed by your site. 720 * 721 * For example: 722 * @code 723 * $settings['trusted_host_patterns'] = [ 724 * '^example\.com$', 725 * '^.+\.example\.com$', 726 * '^example\.org$', 727 * '^.+\.example\.org$', 728 * ]; 729 * @endcode 730 * will allow the site to run off of all variants of example.com and 731 * example.org, with all subdomains included. 732 */ 733 734 /** 735 * The default list of directories that will be ignored by Drupal's file API. 736 * 737 * By default ignore node_modules and bower_components folders to avoid issues 738 * with common frontend tools and recursive scanning of directories looking for 739 * extensions. 740 * 741 * @see \Drupal\Core\File\FileSystemInterface::scanDirectory() 742 * @see \Drupal\Core\Extension\ExtensionDiscovery::scanDirectory() 743 */ 744 $settings['file_scan_ignore_directories'] = [ 745 'node_modules', 746 'bower_components', 747 ]; 748 749 /** 750 * The default number of entities to update in a batch process. 751 * 752 * This is used by update and post-update functions that need to go through and 753 * change all the entities on a site, so it is useful to increase this number 754 * if your hosting configuration (i.e. RAM allocation, CPU speed) allows for a 755 * larger number of entities to be processed in a single batch run. 756 */ 757 $settings['entity_update_batch_size'] = 50; 758 759 /** 760 * Entity update backup. 761 * 762 * This is used to inform the entity storage handler that the backup tables as 763 * well as the original entity type and field storage definitions should be 764 * retained after a successful entity update process. 765 */ 766 $settings['entity_update_backup'] = TRUE; 767 768 /** 769 * Node migration type. 770 * 771 * This is used to force the migration system to use the classic node migrations 772 * instead of the default complete node migrations. The migration system will 773 * use the classic node migration only if there are existing migrate_map tables 774 * for the classic node migrations and they contain data. These tables may not 775 * exist if you are developing custom migrations and do not want to use the 776 * complete node migrations. Set this to TRUE to force the use of the classic 777 * node migrations. 778 */ 779 $settings['migrate_node_migrate_type_classic'] = FALSE; 780 781 // Automatically generated include for settings managed by ddev. 782 if (file_exists(__DIR__ . '/settings.ddev.php') && getenv('IS_DDEV_PROJECT') == 'true') { 783 include __DIR__ . '/settings.ddev.php'; 784 } 785 786 /** 787 * Load local development override configuration, if available. 788 * 789 * Use settings.local.php to override variables on secondary (staging, 790 * development, etc) installations of this site. Typically used to disable 791 * caching, JavaScript/CSS compression, re-routing of outgoing emails, and 792 * other things that should not happen on development and testing sites. 793 * 794 * Keep this code block at the end of this file to take full effect. 795 */ 796 # 797 # if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) { 798 # include $app_root . '/' . $site_path . '/settings.local.php'; 799 # }