|
138 | 138 | * request as needed. The fourth line creates a new database with a name of |
139 | 139 | * "extra". |
140 | 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 | + * |
141 | 156 | * You can optionally set a prefix for all database table names by using the |
142 | 157 | * 'prefix' setting. If a prefix is specified, the table name will be prepended |
143 | 158 | * with its value. Be sure to use valid database characters only, usually |
|
170 | 185 | * information on these defaults and the potential issues. |
171 | 186 | * |
172 | 187 | * More details can be found in the constructor methods for each driver: |
173 | | - * - \Drupal\Core\Database\Driver\mysql\Connection::__construct() |
174 | | - * - \Drupal\Core\Database\Driver\pgsql\Connection::__construct() |
175 | | - * - \Drupal\Core\Database\Driver\sqlite\Connection::__construct() |
| 188 | + * - \Drupal\mysql\Driver\Database\mysql\Connection::__construct() |
| 189 | + * - \Drupal\pgsql\Driver\Database\pgsql\Connection::__construct() |
| 190 | + * - \Drupal\sqlite\Driver\Database\sqlite\Connection::__construct() |
176 | 191 | * |
177 | 192 | * Sample Database configuration format for PostgreSQL (pgsql): |
178 | 193 | * @code |
|
343 | 358 | # $settings['reverse_proxy'] = TRUE; |
344 | 359 |
|
345 | 360 | /** |
346 | | - * Specify every reverse proxy IP address in your environment. |
347 | | - * This setting is required if $settings['reverse_proxy'] is TRUE. |
| 361 | + * Reverse proxy addresses. |
| 362 | + * |
| 363 | + * Specify every reverse proxy IP address in your environment, as an array of |
| 364 | + * IPv4/IPv6 addresses or subnets in CIDR notation. This setting is required if |
| 365 | + * $settings['reverse_proxy'] is TRUE. |
348 | 366 | */ |
349 | | -# $settings['reverse_proxy_addresses'] = ['a.b.c.d', ...]; |
| 367 | +# $settings['reverse_proxy_addresses'] = ['a.b.c.d', 'e.f.g.h/24', ...]; |
350 | 368 |
|
351 | 369 | /** |
352 | 370 | * Reverse proxy trusted headers. |
|
490 | 508 | */ |
491 | 509 | # $settings['file_public_path'] = 'sites/default/files'; |
492 | 510 |
|
| 511 | +/** |
| 512 | + * Additional public file schemes: |
| 513 | + * |
| 514 | + * Public schemes are URI schemes that allow download access to all users for |
| 515 | + * all files within that scheme. |
| 516 | + * |
| 517 | + * The "public" scheme is always public, and the "private" scheme is always |
| 518 | + * private, but other schemes, such as "https", "s3", "example", or others, |
| 519 | + * can be either public or private depending on the site. By default, they're |
| 520 | + * private, and access to individual files is controlled via |
| 521 | + * hook_file_download(). |
| 522 | + * |
| 523 | + * Typically, if a scheme should be public, a module makes it public by |
| 524 | + * implementing hook_file_download(), and granting access to all users for all |
| 525 | + * files. This could be either the same module that provides the stream wrapper |
| 526 | + * for the scheme, or a different module that decides to make the scheme |
| 527 | + * public. However, in cases where a site needs to make a scheme public, but |
| 528 | + * is unable to add code in a module to do so, the scheme may be added to this |
| 529 | + * variable, the result of which is that system_file_download() grants public |
| 530 | + * access to all files within that scheme. |
| 531 | + */ |
| 532 | +# $settings['file_additional_public_schemes'] = ['example']; |
| 533 | + |
| 534 | +/** |
| 535 | + * File schemes whose paths should not be normalized: |
| 536 | + * |
| 537 | + * Normally, Drupal normalizes '/./' and '/../' segments in file URIs in order |
| 538 | + * to prevent unintended file access. For example, 'private://css/../image.png' |
| 539 | + * is normalized to 'private://image.png' before checking access to the file. |
| 540 | + * |
| 541 | + * On Windows, Drupal also replaces '\' with '/' in URIs for the local |
| 542 | + * filesystem. |
| 543 | + * |
| 544 | + * If file URIs with one or more scheme should not be normalized like this, then |
| 545 | + * list the schemes here. For example, if 'porcelain://china/./plate.png' should |
| 546 | + * not be normalized to 'porcelain://china/plate.png', then add 'porcelain' to |
| 547 | + * this array. In this case, make sure that the module providing the 'porcelain' |
| 548 | + * scheme does not allow unintended file access when using '/../' to move up the |
| 549 | + * directory tree. |
| 550 | + */ |
| 551 | +# $settings['file_sa_core_2023_005_schemes'] = ['porcelain']; |
| 552 | + |
493 | 553 | /** |
494 | 554 | * Private file path: |
495 | 555 | * |
|
553 | 613 | * |
554 | 614 | * Note: This setting does not apply to installation and update pages. |
555 | 615 | */ |
556 | | -# $settings['maintenance_theme'] = 'bartik'; |
| 616 | +# $settings['maintenance_theme'] = 'claro'; |
557 | 617 |
|
558 | 618 | /** |
559 | 619 | * PHP settings: |
|
578 | 638 | # ini_set('pcre.backtrack_limit', 200000); |
579 | 639 | # ini_set('pcre.recursion_limit', 200000); |
580 | 640 |
|
581 | | -/** |
582 | | - * Add Permissions-Policy header to disable Google FLoC. |
583 | | - * |
584 | | - * By default, Drupal sends the 'Permissions-Policy: interest-cohort=()' header |
585 | | - * to disable Google's Federated Learning of Cohorts feature, introduced in |
586 | | - * Chrome 89. |
587 | | - * |
588 | | - * See https://en.wikipedia.org/wiki/Federated_Learning_of_Cohorts for more |
589 | | - * information about FLoC. |
590 | | - * |
591 | | - * If you don't wish to disable FLoC in Chrome, you can set this value |
592 | | - * to FALSE. |
593 | | - */ |
594 | | -# $settings['block_interest_cohort'] = TRUE; |
595 | | - |
596 | 641 | /** |
597 | 642 | * Configuration overrides. |
598 | 643 | * |
|
618 | 663 | # $config['system.site']['name'] = 'My Drupal site'; |
619 | 664 | # $config['user.settings']['anonymous'] = 'Visitor'; |
620 | 665 |
|
621 | | -/** |
622 | | - * Fast 404 pages: |
623 | | - * |
624 | | - * Drupal can generate fully themed 404 pages. However, some of these responses |
625 | | - * are for images or other resource files that are not displayed to the user. |
626 | | - * This can waste bandwidth, and also generate server load. |
627 | | - * |
628 | | - * The options below return a simple, fast 404 page for URLs matching a |
629 | | - * specific pattern: |
630 | | - * - $config['system.performance']['fast_404']['exclude_paths']: A regular |
631 | | - * expression to match paths to exclude, such as images generated by image |
632 | | - * styles, or dynamically-resized images. The default pattern provided below |
633 | | - * also excludes the private file system. If you need to add more paths, you |
634 | | - * can add '|path' to the expression. |
635 | | - * - $config['system.performance']['fast_404']['paths']: A regular expression to |
636 | | - * match paths that should return a simple 404 page, rather than the fully |
637 | | - * themed 404 page. If you don't have any aliases ending in htm or html you |
638 | | - * can add '|s?html?' to the expression. |
639 | | - * - $config['system.performance']['fast_404']['html']: The html to return for |
640 | | - * simple 404 pages. |
641 | | - * |
642 | | - * Remove the leading hash signs if you would like to alter this functionality. |
643 | | - */ |
644 | | -# $config['system.performance']['fast_404']['exclude_paths'] = '/\/(?:styles)|(?:system\/files)\//'; |
645 | | -# $config['system.performance']['fast_404']['paths'] = '/\.(?:txt|png|gif|jpe?g|css|js|ico|swf|flv|cgi|bat|pl|dll|exe|asp)$/i'; |
646 | | -# $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>'; |
647 | | - |
648 | 666 | /** |
649 | 667 | * Load services definition file. |
650 | 668 | */ |
|
703 | 721 | * @endcode |
704 | 722 | * will allow the site to run off of all variants of example.com and |
705 | 723 | * example.org, with all subdomains included. |
| 724 | + * |
| 725 | + * @see https://www.drupal.org/docs/installing-drupal/trusted-host-settings |
706 | 726 | */ |
707 | 727 |
|
708 | 728 | /** |
|
752 | 772 | */ |
753 | 773 | $settings['migrate_node_migrate_type_classic'] = FALSE; |
754 | 774 |
|
| 775 | +/** |
| 776 | + * The default settings for migration sources. |
| 777 | + * |
| 778 | + * These settings are used as the default settings on the Credential form at |
| 779 | + * /upgrade/credentials. |
| 780 | + * |
| 781 | + * - migrate_source_version - The version of the source database. This can be |
| 782 | + * '6' or '7'. Defaults to '7'. |
| 783 | + * - migrate_source_connection - The key in the $databases array for the source |
| 784 | + * site. |
| 785 | + * - migrate_file_public_path - The location of the source Drupal 6 or Drupal 7 |
| 786 | + * public files. This can be a local file directory containing the source |
| 787 | + * Drupal 6 or Drupal 7 site (e.g /var/www/docroot), or the site address |
| 788 | + * (e.g http://example.com). |
| 789 | + * - migrate_file_private_path - The location of the source Drupal 7 private |
| 790 | + * files. This can be a local file directory containing the source Drupal 7 |
| 791 | + * site (e.g /var/www/docroot), or empty to use the same value as Public |
| 792 | + * files directory. |
| 793 | + * |
| 794 | + * Sample configuration for a drupal 6 source site with the source files in a |
| 795 | + * local directory. |
| 796 | + * |
| 797 | + * @code |
| 798 | + * $settings['migrate_source_version'] = '6'; |
| 799 | + * $settings['migrate_source_connection'] = 'migrate'; |
| 800 | + * $settings['migrate_file_public_path'] = '/var/www/drupal6'; |
| 801 | + * @endcode |
| 802 | + * |
| 803 | + * Sample configuration for a drupal 7 source site with public source files on |
| 804 | + * the source site and the private files in a local directory. |
| 805 | + * |
| 806 | + * @code |
| 807 | + * $settings['migrate_source_version'] = '7'; |
| 808 | + * $settings['migrate_source_connection'] = 'migrate'; |
| 809 | + * $settings['migrate_file_public_path'] = 'https://drupal7.com'; |
| 810 | + * $settings['migrate_file_private_path'] = '/var/www/drupal7'; |
| 811 | + * @endcode |
| 812 | + */ |
| 813 | +# $settings['migrate_source_connection'] = ''; |
| 814 | +# $settings['migrate_source_version'] = ''; |
| 815 | +# $settings['migrate_file_public_path'] = ''; |
| 816 | +# $settings['migrate_file_private_path'] = ''; |
| 817 | + |
755 | 818 | /** |
756 | 819 | * Load local development override configuration, if available. |
757 | 820 | * |
|
0 commit comments