annotate sites/example.settings.local.php @ 4:a9cd425dd02b

Update, including to Drupal core 8.6.10
author Chris Cannam
date Thu, 28 Feb 2019 13:11:55 +0000
parents c75dbcec494b
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 // @codingStandardsIgnoreFile
Chris@0 4
Chris@0 5 /**
Chris@0 6 * @file
Chris@0 7 * Local development override configuration feature.
Chris@0 8 *
Chris@0 9 * To activate this feature, copy and rename it such that its path plus
Chris@0 10 * filename is 'sites/default/settings.local.php'. Then, go to the bottom of
Chris@0 11 * 'sites/default/settings.php' and uncomment the commented lines that mention
Chris@0 12 * 'settings.local.php'.
Chris@0 13 *
Chris@0 14 * If you are using a site name in the path, such as 'sites/example.com', copy
Chris@0 15 * this file to 'sites/example.com/settings.local.php', and uncomment the lines
Chris@0 16 * at the bottom of 'sites/example.com/settings.php'.
Chris@0 17 */
Chris@0 18
Chris@0 19 /**
Chris@0 20 * Assertions.
Chris@0 21 *
Chris@0 22 * The Drupal project primarily uses runtime assertions to enforce the
Chris@0 23 * expectations of the API by failing when incorrect calls are made by code
Chris@0 24 * under development.
Chris@0 25 *
Chris@0 26 * @see http://php.net/assert
Chris@0 27 * @see https://www.drupal.org/node/2492225
Chris@0 28 *
Chris@0 29 * If you are using PHP 7.0 it is strongly recommended that you set
Chris@0 30 * zend.assertions=1 in the PHP.ini file (It cannot be changed from .htaccess
Chris@0 31 * or runtime) on development machines and to 0 in production.
Chris@0 32 *
Chris@0 33 * @see https://wiki.php.net/rfc/expectations
Chris@0 34 */
Chris@0 35 assert_options(ASSERT_ACTIVE, TRUE);
Chris@0 36 \Drupal\Component\Assertion\Handle::register();
Chris@0 37
Chris@0 38 /**
Chris@0 39 * Enable local development services.
Chris@0 40 */
Chris@0 41 $settings['container_yamls'][] = DRUPAL_ROOT . '/sites/development.services.yml';
Chris@0 42
Chris@0 43 /**
Chris@0 44 * Show all error messages, with backtrace information.
Chris@0 45 *
Chris@0 46 * In case the error level could not be fetched from the database, as for
Chris@0 47 * example the database connection failed, we rely only on this value.
Chris@0 48 */
Chris@0 49 $config['system.logging']['error_level'] = 'verbose';
Chris@0 50
Chris@0 51 /**
Chris@0 52 * Disable CSS and JS aggregation.
Chris@0 53 */
Chris@0 54 $config['system.performance']['css']['preprocess'] = FALSE;
Chris@0 55 $config['system.performance']['js']['preprocess'] = FALSE;
Chris@0 56
Chris@0 57 /**
Chris@0 58 * Disable the render cache.
Chris@0 59 *
Chris@0 60 * Note: you should test with the render cache enabled, to ensure the correct
Chris@0 61 * cacheability metadata is present. However, in the early stages of
Chris@0 62 * development, you may want to disable it.
Chris@0 63 *
Chris@0 64 * This setting disables the render cache by using the Null cache back-end
Chris@0 65 * defined by the development.services.yml file above.
Chris@0 66 *
Chris@0 67 * Only use this setting once the site has been installed.
Chris@0 68 */
Chris@0 69 # $settings['cache']['bins']['render'] = 'cache.backend.null';
Chris@0 70
Chris@0 71 /**
Chris@0 72 * Disable caching for migrations.
Chris@0 73 *
Chris@0 74 * Uncomment the code below to only store migrations in memory and not in the
Chris@0 75 * database. This makes it easier to develop custom migrations.
Chris@0 76 */
Chris@0 77 # $settings['cache']['bins']['discovery_migration'] = 'cache.backend.memory';
Chris@0 78
Chris@0 79 /**
Chris@0 80 * Disable Internal Page Cache.
Chris@0 81 *
Chris@0 82 * Note: you should test with Internal Page Cache enabled, to ensure the correct
Chris@0 83 * cacheability metadata is present. However, in the early stages of
Chris@0 84 * development, you may want to disable it.
Chris@0 85 *
Chris@0 86 * This setting disables the page cache by using the Null cache back-end
Chris@0 87 * defined by the development.services.yml file above.
Chris@0 88 *
Chris@0 89 * Only use this setting once the site has been installed.
Chris@0 90 */
Chris@0 91 # $settings['cache']['bins']['page'] = 'cache.backend.null';
Chris@0 92
Chris@0 93 /**
Chris@0 94 * Disable Dynamic Page Cache.
Chris@0 95 *
Chris@0 96 * Note: you should test with Dynamic Page Cache enabled, to ensure the correct
Chris@0 97 * cacheability metadata is present (and hence the expected behavior). However,
Chris@0 98 * in the early stages of development, you may want to disable it.
Chris@0 99 */
Chris@0 100 # $settings['cache']['bins']['dynamic_page_cache'] = 'cache.backend.null';
Chris@0 101
Chris@0 102 /**
Chris@0 103 * Allow test modules and themes to be installed.
Chris@0 104 *
Chris@0 105 * Drupal ignores test modules and themes by default for performance reasons.
Chris@0 106 * During development it can be useful to install test extensions for debugging
Chris@0 107 * purposes.
Chris@0 108 */
Chris@0 109 # $settings['extension_discovery_scan_tests'] = TRUE;
Chris@0 110
Chris@0 111 /**
Chris@0 112 * Enable access to rebuild.php.
Chris@0 113 *
Chris@0 114 * This setting can be enabled to allow Drupal's php and database cached
Chris@0 115 * storage to be cleared via the rebuild.php page. Access to this page can also
Chris@0 116 * be gained by generating a query string from rebuild_token_calculator.sh and
Chris@0 117 * using these parameters in a request to rebuild.php.
Chris@0 118 */
Chris@0 119 $settings['rebuild_access'] = TRUE;
Chris@0 120
Chris@0 121 /**
Chris@0 122 * Skip file system permissions hardening.
Chris@0 123 *
Chris@0 124 * The system module will periodically check the permissions of your site's
Chris@0 125 * site directory to ensure that it is not writable by the website user. For
Chris@0 126 * sites that are managed with a version control system, this can cause problems
Chris@0 127 * when files in that directory such as settings.php are updated, because the
Chris@0 128 * user pulling in the changes won't have permissions to modify files in the
Chris@0 129 * directory.
Chris@0 130 */
Chris@0 131 $settings['skip_permissions_hardening'] = TRUE;