github.com/ddev/ddev@v1.23.2-0.20240519125000-d824ffe36ff3/pkg/ddevapp/drupal/drupal10/settings.php (about) 1 <?php 2 3 // phpcs:ignoreFile 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 * For each database, you may optionally specify multiple "target" databases. 119 * A target database allows Drupal to try to send certain queries to a 120 * different database if it can but fall back to the default connection if not. 121 * That is useful for primary/replica replication, as Drupal may try to connect 122 * to a replica server when appropriate and if one is not available will simply 123 * fall back to the single primary server (The terms primary/replica are 124 * traditionally referred to as master/slave in database server documentation). 125 * 126 * The general format for the $databases array is as follows: 127 * @code 128 * $databases['default']['default'] = $info_array; 129 * $databases['default']['replica'][] = $info_array; 130 * $databases['default']['replica'][] = $info_array; 131 * $databases['extra']['default'] = $info_array; 132 * @endcode 133 * 134 * In the above example, $info_array is an array of settings described above. 135 * The first line sets a "default" database that has one primary database 136 * (the second level default). The second and third lines create an array 137 * of potential replica databases. Drupal will select one at random for a given 138 * request as needed. The fourth line creates a new database with a name of 139 * "extra". 140 * 141 * For MySQL, MariaDB or equivalent databases the 'isolation_level' option can 142 * be set. The recommended transaction isolation level for Drupal sites is 143 * 'READ COMMITTED'. The 'REPEATABLE READ' option is supported but can result 144 * in deadlocks, the other two options are 'READ UNCOMMITTED' and 'SERIALIZABLE'. 145 * They are available but not supported; use them at your own risk. For more 146 * info: 147 * https://dev.mysql.com/doc/refman/5.7/en/innodb-transaction-isolation-levels.html 148 * 149 * On your settings.php, change the isolation level: 150 * @code 151 * $databases['default']['default']['init_commands'] = [ 152 * 'isolation_level' => 'SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED', 153 * ]; 154 * @endcode 155 * 156 * You can optionally set a prefix for all database table names by using the 157 * 'prefix' setting. If a prefix is specified, the table name will be prepended 158 * with its value. Be sure to use valid database characters only, usually 159 * alphanumeric and underscore. If no prefix is desired, do not set the 'prefix' 160 * key or set its value to an empty string ''. 161 * 162 * For example, to have all database table prefixed with 'main_', set: 163 * @code 164 * 'prefix' => 'main_', 165 * @endcode 166 * 167 * Advanced users can add or override initial commands to execute when 168 * connecting to the database server, as well as PDO connection settings. For 169 * example, to enable MySQL SELECT queries to exceed the max_join_size system 170 * variable, and to reduce the database connection timeout to 5 seconds: 171 * @code 172 * $databases['default']['default'] = [ 173 * 'init_commands' => [ 174 * 'big_selects' => 'SET SQL_BIG_SELECTS=1', 175 * ], 176 * 'pdo' => [ 177 * PDO::ATTR_TIMEOUT => 5, 178 * ], 179 * ]; 180 * @endcode 181 * 182 * WARNING: The above defaults are designed for database portability. Changing 183 * them may cause unexpected behavior, including potential data loss. See 184 * https://www.drupal.org/developing/api/database/configuration for more 185 * information on these defaults and the potential issues. 186 * 187 * More details can be found in the constructor methods for each driver: 188 * - \Drupal\mysql\Driver\Database\mysql\Connection::__construct() 189 * - \Drupal\pgsql\Driver\Database\pgsql\Connection::__construct() 190 * - \Drupal\sqlite\Driver\Database\sqlite\Connection::__construct() 191 * 192 * Sample Database configuration format for PostgreSQL (pgsql): 193 * @code 194 * $databases['default']['default'] = [ 195 * 'driver' => 'pgsql', 196 * 'database' => 'databasename', 197 * 'username' => 'sqlusername', 198 * 'password' => 'sqlpassword', 199 * 'host' => 'localhost', 200 * 'prefix' => '', 201 * ]; 202 * @endcode 203 * 204 * Sample Database configuration format for SQLite (sqlite): 205 * @code 206 * $databases['default']['default'] = [ 207 * 'driver' => 'sqlite', 208 * 'database' => '/path/to/databasefilename', 209 * ]; 210 * @endcode 211 * 212 * Sample Database configuration format for a driver in a contributed module: 213 * @code 214 * $databases['default']['default'] = [ 215 * 'driver' => 'my_driver', 216 * 'namespace' => 'Drupal\my_module\Driver\Database\my_driver', 217 * 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/', 218 * 'database' => 'databasename', 219 * 'username' => 'sqlusername', 220 * 'password' => 'sqlpassword', 221 * 'host' => 'localhost', 222 * 'prefix' => '', 223 * ]; 224 * @endcode 225 */ 226 227 /** 228 * Location of the site configuration files. 229 * 230 * The $settings['config_sync_directory'] specifies the location of file system 231 * directory used for syncing configuration data. On install, the directory is 232 * created. This is used for configuration imports. 233 * 234 * The default location for this directory is inside a randomly-named 235 * directory in the public files path. The setting below allows you to set 236 * its location. 237 */ 238 # $settings['config_sync_directory'] = '/directory/outside/webroot'; 239 240 /** 241 * Settings: 242 * 243 * $settings contains environment-specific configuration, such as the files 244 * directory and reverse proxy address, and temporary configuration, such as 245 * security overrides. 246 * 247 * @see \Drupal\Core\Site\Settings::get() 248 */ 249 250 /** 251 * Salt for one-time login links, cancel links, form tokens, etc. 252 * 253 * This variable will be set to a random value by the installer. All one-time 254 * login links will be invalidated if the value is changed. Note that if your 255 * site is deployed on a cluster of web servers, you must ensure that this 256 * variable has the same value on each server. 257 * 258 * For enhanced security, you may set this variable to the contents of a file 259 * outside your document root, and vary the value across environments (like 260 * production and development); you should also ensure that this file is not 261 * stored with backups of your database. 262 * 263 * Example: 264 * @code 265 * $settings['hash_salt'] = file_get_contents('/home/example/salt.txt'); 266 * @endcode 267 */ 268 $settings['hash_salt'] = ''; 269 270 /** 271 * Deployment identifier. 272 * 273 * Drupal's dependency injection container will be automatically invalidated and 274 * rebuilt when the Drupal core version changes. When updating contributed or 275 * custom code that changes the container, changing this identifier will also 276 * allow the container to be invalidated as soon as code is deployed. 277 */ 278 # $settings['deployment_identifier'] = \Drupal::VERSION; 279 280 /** 281 * Access control for update.php script. 282 * 283 * If you are updating your Drupal installation using the update.php script but 284 * are not logged in using either an account with the "Administer software 285 * updates" permission or the site maintenance account (the account that was 286 * created during installation), you will need to modify the access check 287 * statement below. Change the FALSE to a TRUE to disable the access check. 288 * After finishing the upgrade, be sure to open this file again and change the 289 * TRUE back to a FALSE! 290 */ 291 $settings['update_free_access'] = FALSE; 292 293 /** 294 * Fallback to HTTP for Update Manager and for fetching security advisories. 295 * 296 * If your site fails to connect to updates.drupal.org over HTTPS (either when 297 * fetching data on available updates, or when fetching the feed of critical 298 * security announcements), you may uncomment this setting and set it to TRUE to 299 * allow an insecure fallback to HTTP. Note that doing so will open your site up 300 * to a potential man-in-the-middle attack. You should instead attempt to 301 * resolve the issues before enabling this option. 302 * @see https://www.drupal.org/docs/system-requirements/php-requirements#openssl 303 * @see https://en.wikipedia.org/wiki/Man-in-the-middle_attack 304 * @see \Drupal\update\UpdateFetcher 305 * @see \Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher 306 */ 307 # $settings['update_fetch_with_http_fallback'] = TRUE; 308 309 /** 310 * External access proxy settings: 311 * 312 * If your site must access the Internet via a web proxy then you can enter the 313 * proxy settings here. Set the full URL of the proxy, including the port, in 314 * variables: 315 * - $settings['http_client_config']['proxy']['http']: The proxy URL for HTTP 316 * requests. 317 * - $settings['http_client_config']['proxy']['https']: The proxy URL for HTTPS 318 * requests. 319 * You can pass in the user name and password for basic authentication in the 320 * URLs in these settings. 321 * 322 * You can also define an array of host names that can be accessed directly, 323 * bypassing the proxy, in $settings['http_client_config']['proxy']['no']. 324 */ 325 # $settings['http_client_config']['proxy']['http'] = 'http://proxy_user:proxy_pass@example.com:8080'; 326 # $settings['http_client_config']['proxy']['https'] = 'http://proxy_user:proxy_pass@example.com:8080'; 327 # $settings['http_client_config']['proxy']['no'] = ['127.0.0.1', 'localhost']; 328 329 /** 330 * Reverse Proxy Configuration: 331 * 332 * Reverse proxy servers are often used to enhance the performance 333 * of heavily visited sites and may also provide other site caching, 334 * security, or encryption benefits. In an environment where Drupal 335 * is behind a reverse proxy, the real IP address of the client should 336 * be determined such that the correct client IP address is available 337 * to Drupal's logging, statistics, and access management systems. In 338 * the most simple scenario, the proxy server will add an 339 * X-Forwarded-For header to the request that contains the client IP 340 * address. However, HTTP headers are vulnerable to spoofing, where a 341 * malicious client could bypass restrictions by setting the 342 * X-Forwarded-For header directly. Therefore, Drupal's proxy 343 * configuration requires the IP addresses of all remote proxies to be 344 * specified in $settings['reverse_proxy_addresses'] to work correctly. 345 * 346 * Enable this setting to get Drupal to determine the client IP from the 347 * X-Forwarded-For header. If you are unsure about this setting, do not have a 348 * reverse proxy, or Drupal operates in a shared hosting environment, this 349 * setting should remain commented out. 350 * 351 * In order for this setting to be used you must specify every possible 352 * reverse proxy IP address in $settings['reverse_proxy_addresses']. 353 * If a complete list of reverse proxies is not available in your 354 * environment (for example, if you use a CDN) you may set the 355 * $_SERVER['REMOTE_ADDR'] variable directly in settings.php. 356 * Be aware, however, that it is likely that this would allow IP 357 * address spoofing unless more advanced precautions are taken. 358 */ 359 # $settings['reverse_proxy'] = TRUE; 360 361 /** 362 * Reverse proxy addresses. 363 * 364 * Specify every reverse proxy IP address in your environment, as an array of 365 * IPv4/IPv6 addresses or subnets in CIDR notation. This setting is required if 366 * $settings['reverse_proxy'] is TRUE. 367 */ 368 # $settings['reverse_proxy_addresses'] = ['a.b.c.d', 'e.f.g.h/24', ...]; 369 370 /** 371 * Reverse proxy trusted headers. 372 * 373 * Sets which headers to trust from your reverse proxy. 374 * 375 * Common values are: 376 * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR 377 * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST 378 * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT 379 * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO 380 * - \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED 381 * 382 * Note the default value of 383 * @code 384 * \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO | \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED 385 * @endcode 386 * is not secure by default. The value should be set to only the specific 387 * headers the reverse proxy uses. For example: 388 * @code 389 * \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO 390 * @endcode 391 * This would trust the following headers: 392 * - X_FORWARDED_FOR 393 * - X_FORWARDED_HOST 394 * - X_FORWARDED_PROTO 395 * - X_FORWARDED_PORT 396 * 397 * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR 398 * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST 399 * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT 400 * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO 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_FOR | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT | \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO | \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 APCu extension is detected, the classloader will be optimized to use 452 * it. Set to FALSE to disable this. 453 * 454 * @see https://getcomposer.org/doc/articles/autoloader-optimization.md 455 */ 456 # $settings['class_loader_auto_detect'] = FALSE; 457 458 /** 459 * Authorized file system operations: 460 * 461 * The Update Manager module included with Drupal provides a mechanism for 462 * site administrators to securely install missing updates for the site 463 * directly through the web user interface. On securely-configured servers, 464 * the Update manager will require the administrator to provide SSH or FTP 465 * credentials before allowing the installation to proceed; this allows the 466 * site to update the new files as the user who owns all the Drupal files, 467 * instead of as the user the webserver is running as. On servers where the 468 * webserver user is itself the owner of the Drupal files, the administrator 469 * will not be prompted for SSH or FTP credentials (note that these server 470 * setups are common on shared hosting, but are inherently insecure). 471 * 472 * Some sites might wish to disable the above functionality, and only update 473 * the code directly via SSH or FTP themselves. This setting completely 474 * disables all functionality related to these authorized file operations. 475 * 476 * @see https://www.drupal.org/node/244924 477 * 478 * Remove the leading hash signs to disable. 479 */ 480 # $settings['allow_authorize_operations'] = FALSE; 481 482 /** 483 * Default mode for directories and files written by Drupal. 484 * 485 * Value should be in PHP Octal Notation, with leading zero. 486 */ 487 # $settings['file_chmod_directory'] = 0775; 488 # $settings['file_chmod_file'] = 0664; 489 490 /** 491 * Optimized assets path: 492 * 493 * A local file system path where optimized assets will be stored. This directory 494 * must exist and be writable by Drupal. This directory must be relative to 495 * the Drupal installation directory and be accessible over the web. 496 */ 497 # $settings['file_assets_path'] = 'sites/default/files'; 498 499 /** 500 * Public file base URL: 501 * 502 * An alternative base URL to be used for serving public files. This must 503 * include any leading directory path. 504 * 505 * A different value from the domain used by Drupal to be used for accessing 506 * public files. This can be used for a simple CDN integration, or to improve 507 * security by serving user-uploaded files from a different domain or subdomain 508 * pointing to the same server. Do not include a trailing slash. 509 */ 510 # $settings['file_public_base_url'] = 'http://downloads.example.com/files'; 511 512 /** 513 * Public file path: 514 * 515 * A local file system path where public files will be stored. This directory 516 * must exist and be writable by Drupal. This directory must be relative to 517 * the Drupal installation directory and be accessible over the web. 518 */ 519 # $settings['file_public_path'] = 'sites/default/files'; 520 521 /** 522 * Additional public file schemes: 523 * 524 * Public schemes are URI schemes that allow download access to all users for 525 * all files within that scheme. 526 * 527 * The "public" scheme is always public, and the "private" scheme is always 528 * private, but other schemes, such as "https", "s3", "example", or others, 529 * can be either public or private depending on the site. By default, they're 530 * private, and access to individual files is controlled via 531 * hook_file_download(). 532 * 533 * Typically, if a scheme should be public, a module makes it public by 534 * implementing hook_file_download(), and granting access to all users for all 535 * files. This could be either the same module that provides the stream wrapper 536 * for the scheme, or a different module that decides to make the scheme 537 * public. However, in cases where a site needs to make a scheme public, but 538 * is unable to add code in a module to do so, the scheme may be added to this 539 * variable, the result of which is that system_file_download() grants public 540 * access to all files within that scheme. 541 */ 542 # $settings['file_additional_public_schemes'] = ['example']; 543 544 /** 545 * File schemes whose paths should not be normalized: 546 * 547 * Normally, Drupal normalizes '/./' and '/../' segments in file URIs in order 548 * to prevent unintended file access. For example, 'private://css/../image.png' 549 * is normalized to 'private://image.png' before checking access to the file. 550 * 551 * On Windows, Drupal also replaces '\' with '/' in URIs for the local 552 * filesystem. 553 * 554 * If file URIs with one or more scheme should not be normalized like this, then 555 * list the schemes here. For example, if 'porcelain://china/./plate.png' should 556 * not be normalized to 'porcelain://china/plate.png', then add 'porcelain' to 557 * this array. In this case, make sure that the module providing the 'porcelain' 558 * scheme does not allow unintended file access when using '/../' to move up the 559 * directory tree. 560 */ 561 # $settings['file_sa_core_2023_005_schemes'] = ['porcelain']; 562 563 /** 564 * Configuration for phpinfo() admin status report. 565 * 566 * Drupal's admin UI includes a report at admin/reports/status/php which shows 567 * the output of phpinfo(). The full output can contain sensitive information 568 * so by default Drupal removes some sections. 569 * 570 * This behaviour can be configured by setting this variable to a different 571 * value corresponding to the flags parameter of phpinfo(). 572 * 573 * If you need to expose more information in the report - for example to debug a 574 * problem - consider doing so temporarily. 575 * 576 * @see https://www.php.net/manual/function.phpinfo.php 577 */ 578 # $settings['sa_core_2023_004_phpinfo_flags'] = ~ (INFO_VARIABLES | INFO_ENVIRONMENT); 579 580 /** 581 * Private file path: 582 * 583 * A local file system path where private files will be stored. This directory 584 * must be absolute, outside of the Drupal installation directory and not 585 * accessible over the web. 586 * 587 * Note: Caches need to be cleared when this value is changed to make the 588 * private:// stream wrapper available to the system. 589 * 590 * See https://www.drupal.org/documentation/modules/file for more information 591 * about securing private files. 592 */ 593 # $settings['file_private_path'] = ''; 594 595 /** 596 * Temporary file path: 597 * 598 * A local file system path where temporary files will be stored. This directory 599 * must be absolute, outside of the Drupal installation directory and not 600 * accessible over the web. 601 * 602 * If this is not set, the default for the operating system will be used. 603 * 604 * @see \Drupal\Component\FileSystem\FileSystem::getOsTemporaryDirectory() 605 */ 606 # $settings['file_temp_path'] = '/tmp'; 607 608 /** 609 * Session write interval: 610 * 611 * Set the minimum interval between each session write to database. 612 * For performance reasons it defaults to 180. 613 */ 614 # $settings['session_write_interval'] = 180; 615 616 /** 617 * String overrides: 618 * 619 * To override specific strings on your site with or without enabling the Locale 620 * module, add an entry to this list. This functionality allows you to change 621 * a small number of your site's default English language interface strings. 622 * 623 * Remove the leading hash signs to enable. 624 * 625 * The "en" part of the variable name, is dynamic and can be any langcode of 626 * any added language. (eg locale_custom_strings_de for german). 627 */ 628 # $settings['locale_custom_strings_en'][''] = [ 629 # 'Home' => 'Front page', 630 # '@count min' => '@count minutes', 631 # ]; 632 633 /** 634 * A custom theme for the offline page: 635 * 636 * This applies when the site is explicitly set to maintenance mode through the 637 * administration page or when the database is inactive due to an error. 638 * The template file should also be copied into the theme. It is located inside 639 * 'core/modules/system/templates/maintenance-page.html.twig'. 640 * 641 * Note: This setting does not apply to installation and update pages. 642 */ 643 # $settings['maintenance_theme'] = 'claro'; 644 645 /** 646 * PHP settings: 647 * 648 * To see what PHP settings are possible, including whether they can be set at 649 * runtime (by using ini_set()), read the PHP documentation: 650 * http://php.net/manual/ini.list.php 651 * See \Drupal\Core\DrupalKernel::bootEnvironment() for required runtime 652 * settings and the .htaccess file for non-runtime settings. 653 * Settings defined there should not be duplicated here so as to avoid conflict 654 * issues. 655 */ 656 657 /** 658 * If you encounter a situation where users post a large amount of text, and 659 * the result is stripped out upon viewing but can still be edited, Drupal's 660 * output filter may not have sufficient memory to process it. If you 661 * experience this issue, you may wish to uncomment the following two lines 662 * and increase the limits of these variables. For more information, see 663 * http://php.net/manual/pcre.configuration.php. 664 */ 665 # ini_set('pcre.backtrack_limit', 200000); 666 # ini_set('pcre.recursion_limit', 200000); 667 668 /** 669 * Configuration overrides. 670 * 671 * To globally override specific configuration values for this site, 672 * set them here. You usually don't need to use this feature. This is 673 * useful in a configuration file for a vhost or directory, rather than 674 * the default settings.php. 675 * 676 * Note that any values you provide in these variable overrides will not be 677 * viewable from the Drupal administration interface. The administration 678 * interface displays the values stored in configuration so that you can stage 679 * changes to other environments that don't have the overrides. 680 * 681 * There are particular configuration values that are risky to override. For 682 * example, overriding the list of installed modules in 'core.extension' is not 683 * supported as module install or uninstall has not occurred. Other examples 684 * include field storage configuration, because it has effects on database 685 * structure, and 'core.menu.static_menu_link_overrides' since this is cached in 686 * a way that is not config override aware. Also, note that changing 687 * configuration values in settings.php will not fire any of the configuration 688 * change events. 689 */ 690 # $config['system.site']['name'] = 'My Drupal site'; 691 # $config['user.settings']['anonymous'] = 'Visitor'; 692 693 /** 694 * Load services definition file. 695 */ 696 $settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml'; 697 698 /** 699 * Override the default service container class. 700 * 701 * This is useful for example to trace the service container for performance 702 * tracking purposes, for testing a service container with an error condition or 703 * to test a service container that throws an exception. 704 */ 705 # $settings['container_base_class'] = '\Drupal\Core\DependencyInjection\Container'; 706 707 /** 708 * Override the default yaml parser class. 709 * 710 * Provide a fully qualified class name here if you would like to provide an 711 * alternate implementation YAML parser. The class must implement the 712 * \Drupal\Component\Serialization\SerializationInterface interface. 713 */ 714 # $settings['yaml_parser_class'] = NULL; 715 716 /** 717 * Trusted host configuration. 718 * 719 * Drupal core can use the Symfony trusted host mechanism to prevent HTTP Host 720 * header spoofing. 721 * 722 * To enable the trusted host mechanism, you enable your allowable hosts 723 * in $settings['trusted_host_patterns']. This should be an array of regular 724 * expression patterns, without delimiters, representing the hosts you would 725 * like to allow. 726 * 727 * For example: 728 * @code 729 * $settings['trusted_host_patterns'] = [ 730 * '^www\.example\.com$', 731 * ]; 732 * @endcode 733 * will allow the site to only run from www.example.com. 734 * 735 * If you are running multisite, or if you are running your site from 736 * different domain names (eg, you don't redirect http://www.example.com to 737 * http://example.com), you should specify all of the host patterns that are 738 * allowed by your site. 739 * 740 * For example: 741 * @code 742 * $settings['trusted_host_patterns'] = [ 743 * '^example\.com$', 744 * '^.+\.example\.com$', 745 * '^example\.org$', 746 * '^.+\.example\.org$', 747 * ]; 748 * @endcode 749 * will allow the site to run off of all variants of example.com and 750 * example.org, with all subdomains included. 751 * 752 * @see https://www.drupal.org/docs/installing-drupal/trusted-host-settings 753 */ 754 # $settings['trusted_host_patterns'] = []; 755 756 /** 757 * The default list of directories that will be ignored by Drupal's file API. 758 * 759 * By default ignore node_modules and bower_components folders to avoid issues 760 * with common frontend tools and recursive scanning of directories looking for 761 * extensions. 762 * 763 * @see \Drupal\Core\File\FileSystemInterface::scanDirectory() 764 * @see \Drupal\Core\Extension\ExtensionDiscovery::scanDirectory() 765 */ 766 $settings['file_scan_ignore_directories'] = [ 767 'node_modules', 768 'bower_components', 769 ]; 770 771 /** 772 * The default number of entities to update in a batch process. 773 * 774 * This is used by update and post-update functions that need to go through and 775 * change all the entities on a site, so it is useful to increase this number 776 * if your hosting configuration (i.e. RAM allocation, CPU speed) allows for a 777 * larger number of entities to be processed in a single batch run. 778 */ 779 $settings['entity_update_batch_size'] = 50; 780 781 /** 782 * Entity update backup. 783 * 784 * This is used to inform the entity storage handler that the backup tables as 785 * well as the original entity type and field storage definitions should be 786 * retained after a successful entity update process. 787 */ 788 $settings['entity_update_backup'] = TRUE; 789 790 /** 791 * Node migration type. 792 * 793 * This is used to force the migration system to use the classic node migrations 794 * instead of the default complete node migrations. The migration system will 795 * use the classic node migration only if there are existing migrate_map tables 796 * for the classic node migrations and they contain data. These tables may not 797 * exist if you are developing custom migrations and do not want to use the 798 * complete node migrations. Set this to TRUE to force the use of the classic 799 * node migrations. 800 */ 801 $settings['migrate_node_migrate_type_classic'] = FALSE; 802 803 /** 804 * The default settings for migration sources. 805 * 806 * These settings are used as the default settings on the Credential form at 807 * /upgrade/credentials. 808 * 809 * - migrate_source_version - The version of the source database. This can be 810 * '6' or '7'. Defaults to '7'. 811 * - migrate_source_connection - The key in the $databases array for the source 812 * site. 813 * - migrate_file_public_path - The location of the source Drupal 6 or Drupal 7 814 * public files. This can be a local file directory containing the source 815 * Drupal 6 or Drupal 7 site (e.g /var/www/docroot), or the site address 816 * (e.g http://example.com). 817 * - migrate_file_private_path - The location of the source Drupal 7 private 818 * files. This can be a local file directory containing the source Drupal 7 819 * site (e.g /var/www/docroot), or empty to use the same value as Public 820 * files directory. 821 * 822 * Sample configuration for a drupal 6 source site with the source files in a 823 * local directory. 824 * 825 * @code 826 * $settings['migrate_source_version'] = '6'; 827 * $settings['migrate_source_connection'] = 'migrate'; 828 * $settings['migrate_file_public_path'] = '/var/www/drupal6'; 829 * @endcode 830 * 831 * Sample configuration for a drupal 7 source site with public source files on 832 * the source site and the private files in a local directory. 833 * 834 * @code 835 * $settings['migrate_source_version'] = '7'; 836 * $settings['migrate_source_connection'] = 'migrate'; 837 * $settings['migrate_file_public_path'] = 'https://drupal7.com'; 838 * $settings['migrate_file_private_path'] = '/var/www/drupal7'; 839 * @endcode 840 */ 841 # $settings['migrate_source_connection'] = ''; 842 # $settings['migrate_source_version'] = ''; 843 # $settings['migrate_file_public_path'] = ''; 844 # $settings['migrate_file_private_path'] = ''; 845 846 // Automatically generated include for settings managed by ddev. 847 if (getenv('IS_DDEV_PROJECT') == 'true' && file_exists(__DIR__ . '/settings.ddev.php')) { 848 include __DIR__ . '/settings.ddev.php'; 849 } 850 851 /** 852 * Load local development override configuration, if available. 853 * 854 * Create a settings.local.php file to override variables on secondary (staging, 855 * development, etc.) installations of this site. 856 * 857 * Typical uses of settings.local.php include: 858 * - Disabling caching. 859 * - Disabling JavaScript/CSS compression. 860 * - Rerouting outgoing emails. 861 * 862 * Keep this code block at the end of this file to take full effect. 863 */ 864 # 865 # if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) { 866 # include $app_root . '/' . $site_path . '/settings.local.php'; 867 # }