annotate vendor/chi-teck/drupal-code-generator/templates/d7/settings.twig @ 5:12f9dff5fda9 tip

Update to Drupal core 8.7.1
author Chris Cannam
date Thu, 09 May 2019 15:34:47 +0100
parents c75dbcec494b
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /**
Chris@0 4 * @file
Chris@0 5 * Drupal site-specific configuration file.
Chris@0 6 *
Chris@0 7 * IMPORTANT NOTE:
Chris@0 8 * This file may have been set to read-only by the Drupal installation program.
Chris@0 9 * If you make changes to this file, be sure to protect it again after making
Chris@0 10 * your modifications. Failure to remove write permissions to this file is a
Chris@0 11 * security risk.
Chris@0 12 *
Chris@0 13 * The configuration file to be loaded is based upon the rules below. However
Chris@0 14 * if the multisite aliasing file named sites/sites.php is present, it will be
Chris@0 15 * loaded, and the aliases in the array $sites will override the default
Chris@0 16 * directory rules below. See sites/example.sites.php for more information about
Chris@0 17 * aliases.
Chris@0 18 *
Chris@0 19 * The configuration directory will be discovered by stripping the website's
Chris@0 20 * hostname from left to right and pathname from right to left. The first
Chris@0 21 * configuration file found will be used and any others will be ignored. If no
Chris@0 22 * other configuration file is found then the default configuration file at
Chris@0 23 * 'sites/default' will be used.
Chris@0 24 *
Chris@0 25 * For example, for a fictitious site installed at
Chris@0 26 * http://www.drupal.org:8080/mysite/test/, the 'settings.php' file is searched
Chris@0 27 * for in the following directories:
Chris@0 28 *
Chris@0 29 * - sites/8080.www.drupal.org.mysite.test
Chris@0 30 * - sites/www.drupal.org.mysite.test
Chris@0 31 * - sites/drupal.org.mysite.test
Chris@0 32 * - sites/org.mysite.test
Chris@0 33 *
Chris@0 34 * - sites/8080.www.drupal.org.mysite
Chris@0 35 * - sites/www.drupal.org.mysite
Chris@0 36 * - sites/drupal.org.mysite
Chris@0 37 * - sites/org.mysite
Chris@0 38 *
Chris@0 39 * - sites/8080.www.drupal.org
Chris@0 40 * - sites/www.drupal.org
Chris@0 41 * - sites/drupal.org
Chris@0 42 * - sites/org
Chris@0 43 *
Chris@0 44 * - sites/default
Chris@0 45 *
Chris@0 46 * Note that if you are installing on a non-standard port number, prefix the
Chris@0 47 * hostname with that number. For example,
Chris@0 48 * http://www.drupal.org:8080/mysite/test/ could be loaded from
Chris@0 49 * sites/8080.www.drupal.org.mysite.test/.
Chris@0 50 *
Chris@0 51 * @see example.sites.php
Chris@0 52 * @see conf_path()
Chris@0 53 */
Chris@0 54
Chris@0 55 /**
Chris@0 56 * Database settings:
Chris@0 57 *
Chris@0 58 * The $databases array specifies the database connection or
Chris@0 59 * connections that Drupal may use. Drupal is able to connect
Chris@0 60 * to multiple databases, including multiple types of databases,
Chris@0 61 * during the same request.
Chris@0 62 *
Chris@0 63 * Each database connection is specified as an array of settings,
Chris@0 64 * similar to the following:
Chris@0 65 * @code
Chris@0 66 * array(
Chris@0 67 * 'driver' => 'mysql',
Chris@0 68 * 'database' => 'databasename',
Chris@0 69 * 'username' => 'username',
Chris@0 70 * 'password' => 'password',
Chris@0 71 * 'host' => 'localhost',
Chris@0 72 * 'port' => 3306,
Chris@0 73 * 'prefix' => 'myprefix_',
Chris@0 74 * 'collation' => 'utf8_general_ci',
Chris@0 75 * );
Chris@0 76 * @endcode
Chris@0 77 *
Chris@0 78 * The "driver" property indicates what Drupal database driver the
Chris@0 79 * connection should use. This is usually the same as the name of the
Chris@0 80 * database type, such as mysql or sqlite, but not always. The other
Chris@0 81 * properties will vary depending on the driver. For SQLite, you must
Chris@0 82 * specify a database file name in a directory that is writable by the
Chris@0 83 * webserver. For most other drivers, you must specify a
Chris@0 84 * username, password, host, and database name.
Chris@0 85 *
Chris@0 86 * Transaction support is enabled by default for all drivers that support it,
Chris@0 87 * including MySQL. To explicitly disable it, set the 'transactions' key to
Chris@0 88 * FALSE.
Chris@0 89 * Note that some configurations of MySQL, such as the MyISAM engine, don't
Chris@0 90 * support it and will proceed silently even if enabled. If you experience
Chris@0 91 * transaction related crashes with such configuration, set the 'transactions'
Chris@0 92 * key to FALSE.
Chris@0 93 *
Chris@0 94 * For each database, you may optionally specify multiple "target" databases.
Chris@0 95 * A target database allows Drupal to try to send certain queries to a
Chris@0 96 * different database if it can but fall back to the default connection if not.
Chris@0 97 * That is useful for master/slave replication, as Drupal may try to connect
Chris@0 98 * to a slave server when appropriate and if one is not available will simply
Chris@0 99 * fall back to the single master server.
Chris@0 100 *
Chris@0 101 * The general format for the $databases array is as follows:
Chris@0 102 * @code
Chris@0 103 * $databases['default']['default'] = $info_array;
Chris@0 104 * $databases['default']['slave'][] = $info_array;
Chris@0 105 * $databases['default']['slave'][] = $info_array;
Chris@0 106 * $databases['extra']['default'] = $info_array;
Chris@0 107 * @endcode
Chris@0 108 *
Chris@0 109 * In the above example, $info_array is an array of settings described above.
Chris@0 110 * The first line sets a "default" database that has one master database
Chris@0 111 * (the second level default). The second and third lines create an array
Chris@0 112 * of potential slave databases. Drupal will select one at random for a given
Chris@0 113 * request as needed. The fourth line creates a new database with a name of
Chris@0 114 * "extra".
Chris@0 115 *
Chris@0 116 * For a single database configuration, the following is sufficient:
Chris@0 117 * @code
Chris@0 118 * $databases['default']['default'] = array(
Chris@0 119 * 'driver' => 'mysql',
Chris@0 120 * 'database' => 'databasename',
Chris@0 121 * 'username' => 'username',
Chris@0 122 * 'password' => 'password',
Chris@0 123 * 'host' => 'localhost',
Chris@0 124 * 'prefix' => 'main_',
Chris@0 125 * 'collation' => 'utf8_general_ci',
Chris@0 126 * );
Chris@0 127 * @endcode
Chris@0 128 *
Chris@0 129 * For handling full UTF-8 in MySQL, including multi-byte characters such as
Chris@0 130 * emojis, Asian symbols, and mathematical symbols, you may set the collation
Chris@0 131 * and charset to "utf8mb4" prior to running install.php:
Chris@0 132 * @code
Chris@0 133 * $databases['default']['default'] = array(
Chris@0 134 * 'driver' => 'mysql',
Chris@0 135 * 'database' => 'databasename',
Chris@0 136 * 'username' => 'username',
Chris@0 137 * 'password' => 'password',
Chris@0 138 * 'host' => 'localhost',
Chris@0 139 * 'charset' => 'utf8mb4',
Chris@0 140 * 'collation' => 'utf8mb4_general_ci',
Chris@0 141 * );
Chris@0 142 * @endcode
Chris@0 143 * When using this setting on an existing installation, ensure that all existing
Chris@0 144 * tables have been converted to the utf8mb4 charset, for example by using the
Chris@0 145 * utf8mb4_convert contributed project available at
Chris@0 146 * https://www.drupal.org/project/utf8mb4_convert, so as to prevent mixing data
Chris@0 147 * with different charsets.
Chris@0 148 * Note this should only be used when all of the following conditions are met:
Chris@0 149 * - In order to allow for large indexes, MySQL must be set up with the
Chris@0 150 * following my.cnf settings:
Chris@0 151 * [mysqld]
Chris@0 152 * innodb_large_prefix=true
Chris@0 153 * innodb_file_format=barracuda
Chris@0 154 * innodb_file_per_table=true
Chris@0 155 * These settings are available as of MySQL 5.5.14, and are defaults in
Chris@0 156 * MySQL 5.7.7 and up.
Chris@0 157 * - The PHP MySQL driver must support the utf8mb4 charset (libmysqlclient
Chris@0 158 * 5.5.3 and up, as well as mysqlnd 5.0.9 and up).
Chris@0 159 * - The MySQL server must support the utf8mb4 charset (5.5.3 and up).
Chris@0 160 *
Chris@0 161 * You can optionally set prefixes for some or all database table names
Chris@0 162 * by using the 'prefix' setting. If a prefix is specified, the table
Chris@0 163 * name will be prepended with its value. Be sure to use valid database
Chris@0 164 * characters only, usually alphanumeric and underscore. If no prefixes
Chris@0 165 * are desired, leave it as an empty string ''.
Chris@0 166 *
Chris@0 167 * To have all database names prefixed, set 'prefix' as a string:
Chris@0 168 * @code
Chris@0 169 * 'prefix' => 'main_',
Chris@0 170 * @endcode
Chris@0 171 * To provide prefixes for specific tables, set 'prefix' as an array.
Chris@0 172 * The array's keys are the table names and the values are the prefixes.
Chris@0 173 * The 'default' element is mandatory and holds the prefix for any tables
Chris@0 174 * not specified elsewhere in the array. Example:
Chris@0 175 * @code
Chris@0 176 * 'prefix' => array(
Chris@0 177 * 'default' => 'main_',
Chris@0 178 * 'users' => 'shared_',
Chris@0 179 * 'sessions' => 'shared_',
Chris@0 180 * 'role' => 'shared_',
Chris@0 181 * 'authmap' => 'shared_',
Chris@0 182 * ),
Chris@0 183 * @endcode
Chris@0 184 * You can also use a reference to a schema/database as a prefix. This may be
Chris@0 185 * useful if your Drupal installation exists in a schema that is not the default
Chris@0 186 * or you want to access several databases from the same code base at the same
Chris@0 187 * time.
Chris@0 188 * Example:
Chris@0 189 * @code
Chris@0 190 * 'prefix' => array(
Chris@0 191 * 'default' => 'main.',
Chris@0 192 * 'users' => 'shared.',
Chris@0 193 * 'sessions' => 'shared.',
Chris@0 194 * 'role' => 'shared.',
Chris@0 195 * 'authmap' => 'shared.',
Chris@0 196 * );
Chris@0 197 * @endcode
Chris@0 198 * NOTE: MySQL and SQLite's definition of a schema is a database.
Chris@0 199 *
Chris@0 200 * Advanced users can add or override initial commands to execute when
Chris@0 201 * connecting to the database server, as well as PDO connection settings. For
Chris@0 202 * example, to enable MySQL SELECT queries to exceed the max_join_size system
Chris@0 203 * variable, and to reduce the database connection timeout to 5 seconds:
Chris@0 204 *
Chris@0 205 * @code
Chris@0 206 * $databases['default']['default'] = array(
Chris@0 207 * 'init_commands' => array(
Chris@0 208 * 'big_selects' => 'SET SQL_BIG_SELECTS=1',
Chris@0 209 * ),
Chris@0 210 * 'pdo' => array(
Chris@0 211 * PDO::ATTR_TIMEOUT => 5,
Chris@0 212 * ),
Chris@0 213 * );
Chris@0 214 * @endcode
Chris@0 215 *
Chris@0 216 * WARNING: These defaults are designed for database portability. Changing them
Chris@0 217 * may cause unexpected behavior, including potential data loss.
Chris@0 218 *
Chris@0 219 * @see DatabaseConnection_mysql::__construct
Chris@0 220 * @see DatabaseConnection_pgsql::__construct
Chris@0 221 * @see DatabaseConnection_sqlite::__construct
Chris@0 222 *
Chris@0 223 * Database configuration format:
Chris@0 224 * @code
Chris@0 225 * $databases['default']['default'] = array(
Chris@0 226 * 'driver' => 'mysql',
Chris@0 227 * 'database' => 'databasename',
Chris@0 228 * 'username' => 'username',
Chris@0 229 * 'password' => 'password',
Chris@0 230 * 'host' => 'localhost',
Chris@0 231 * 'prefix' => '',
Chris@0 232 * );
Chris@0 233 * $databases['default']['default'] = array(
Chris@0 234 * 'driver' => 'pgsql',
Chris@0 235 * 'database' => 'databasename',
Chris@0 236 * 'username' => 'username',
Chris@0 237 * 'password' => 'password',
Chris@0 238 * 'host' => 'localhost',
Chris@0 239 * 'prefix' => '',
Chris@0 240 * );
Chris@0 241 * $databases['default']['default'] = array(
Chris@0 242 * 'driver' => 'sqlite',
Chris@0 243 * 'database' => '/path/to/databasefilename',
Chris@0 244 * );
Chris@0 245 * @endcode
Chris@0 246 */
Chris@0 247 $databases = array (
Chris@0 248 'default' =>
Chris@0 249 array (
Chris@0 250 'default' =>
Chris@0 251 array (
Chris@0 252 'database' => '{{ db_name }}',
Chris@0 253 'username' => '{{ db_user }}',
Chris@0 254 'password' => '{{ db_password }}',
Chris@0 255 'host' => 'localhost',
Chris@0 256 'port' => '',
Chris@0 257 'driver' => '{{ db_driver }}',
Chris@0 258 'prefix' => '',
Chris@0 259 ),
Chris@0 260 ),
Chris@0 261 );
Chris@0 262
Chris@0 263 /**
Chris@0 264 * Access control for update.php script.
Chris@0 265 *
Chris@0 266 * If you are updating your Drupal installation using the update.php script but
Chris@0 267 * are not logged in using either an account with the "Administer software
Chris@0 268 * updates" permission or the site maintenance account (the account that was
Chris@0 269 * created during installation), you will need to modify the access check
Chris@0 270 * statement below. Change the FALSE to a TRUE to disable the access check.
Chris@0 271 * After finishing the upgrade, be sure to open this file again and change the
Chris@0 272 * TRUE back to a FALSE!
Chris@0 273 */
Chris@0 274 $update_free_access = FALSE;
Chris@0 275
Chris@0 276 /**
Chris@0 277 * Salt for one-time login links and cancel links, form tokens, etc.
Chris@0 278 *
Chris@0 279 * This variable will be set to a random value by the installer. All one-time
Chris@0 280 * login links will be invalidated if the value is changed. Note that if your
Chris@0 281 * site is deployed on a cluster of web servers, you must ensure that this
Chris@0 282 * variable has the same value on each server. If this variable is empty, a hash
Chris@0 283 * of the serialized database credentials will be used as a fallback salt.
Chris@0 284 *
Chris@0 285 * For enhanced security, you may set this variable to a value using the
Chris@0 286 * contents of a file outside your docroot that is never saved together
Chris@0 287 * with any backups of your Drupal files and database.
Chris@0 288 *
Chris@0 289 * Example:
Chris@0 290 * $drupal_hash_salt = file_get_contents('/home/example/salt.txt');
Chris@0 291 *
Chris@0 292 */
Chris@0 293 $drupal_hash_salt = '{{ hash_salt }}';
Chris@0 294
Chris@0 295 /**
Chris@0 296 * Base URL (optional).
Chris@0 297 *
Chris@0 298 * If Drupal is generating incorrect URLs on your site, which could
Chris@0 299 * be in HTML headers (links to CSS and JS files) or visible links on pages
Chris@0 300 * (such as in menus), uncomment the Base URL statement below (remove the
Chris@0 301 * leading hash sign) and fill in the absolute URL to your Drupal installation.
Chris@0 302 *
Chris@0 303 * You might also want to force users to use a given domain.
Chris@0 304 * See the .htaccess file for more information.
Chris@0 305 *
Chris@0 306 * Examples:
Chris@0 307 * $base_url = 'http://www.example.com';
Chris@0 308 * $base_url = 'http://www.example.com:8888';
Chris@0 309 * $base_url = 'http://www.example.com/drupal';
Chris@0 310 * $base_url = 'https://www.example.com:8888/drupal';
Chris@0 311 *
Chris@0 312 * It is not allowed to have a trailing slash; Drupal will add it
Chris@0 313 * for you.
Chris@0 314 */
Chris@0 315 # $base_url = 'http://www.example.com'; // NO trailing slash!
Chris@0 316
Chris@0 317 /**
Chris@0 318 * PHP settings:
Chris@0 319 *
Chris@0 320 * To see what PHP settings are possible, including whether they can be set at
Chris@0 321 * runtime (by using ini_set()), read the PHP documentation:
Chris@0 322 * http://www.php.net/manual/ini.list.php
Chris@0 323 * See drupal_environment_initialize() in includes/bootstrap.inc for required
Chris@0 324 * runtime settings and the .htaccess file for non-runtime settings. Settings
Chris@0 325 * defined there should not be duplicated here so as to avoid conflict issues.
Chris@0 326 */
Chris@0 327
Chris@0 328 /**
Chris@0 329 * Some distributions of Linux (most notably Debian) ship their PHP
Chris@0 330 * installations with garbage collection (gc) disabled. Since Drupal depends on
Chris@0 331 * PHP's garbage collection for clearing sessions, ensure that garbage
Chris@0 332 * collection occurs by using the most common settings.
Chris@0 333 */
Chris@0 334 ini_set('session.gc_probability', 1);
Chris@0 335 ini_set('session.gc_divisor', 100);
Chris@0 336
Chris@0 337 /**
Chris@0 338 * Set session lifetime (in seconds), i.e. the time from the user's last visit
Chris@0 339 * to the active session may be deleted by the session garbage collector. When
Chris@0 340 * a session is deleted, authenticated users are logged out, and the contents
Chris@0 341 * of the user's $_SESSION variable is discarded.
Chris@0 342 */
Chris@0 343 ini_set('session.gc_maxlifetime', 200000);
Chris@0 344
Chris@0 345 /**
Chris@0 346 * Set session cookie lifetime (in seconds), i.e. the time from the session is
Chris@0 347 * created to the cookie expires, i.e. when the browser is expected to discard
Chris@0 348 * the cookie. The value 0 means "until the browser is closed".
Chris@0 349 */
Chris@0 350 ini_set('session.cookie_lifetime', 2000000);
Chris@0 351
Chris@0 352 /**
Chris@0 353 * If you encounter a situation where users post a large amount of text, and
Chris@0 354 * the result is stripped out upon viewing but can still be edited, Drupal's
Chris@0 355 * output filter may not have sufficient memory to process it. If you
Chris@0 356 * experience this issue, you may wish to uncomment the following two lines
Chris@0 357 * and increase the limits of these variables. For more information, see
Chris@0 358 * http://php.net/manual/pcre.configuration.php.
Chris@0 359 */
Chris@0 360 # ini_set('pcre.backtrack_limit', 200000);
Chris@0 361 # ini_set('pcre.recursion_limit', 200000);
Chris@0 362
Chris@0 363 /**
Chris@0 364 * Drupal automatically generates a unique session cookie name for each site
Chris@0 365 * based on its full domain name. If you have multiple domains pointing at the
Chris@0 366 * same Drupal site, you can either redirect them all to a single domain (see
Chris@0 367 * comment in .htaccess), or uncomment the line below and specify their shared
Chris@0 368 * base domain. Doing so assures that users remain logged in as they cross
Chris@0 369 * between your various domains. Make sure to always start the $cookie_domain
Chris@0 370 * with a leading dot, as per RFC 2109.
Chris@0 371 */
Chris@0 372 # $cookie_domain = '.example.com';
Chris@0 373
Chris@0 374 /**
Chris@0 375 * Variable overrides:
Chris@0 376 *
Chris@0 377 * To override specific entries in the 'variable' table for this site,
Chris@0 378 * set them here. You usually don't need to use this feature. This is
Chris@0 379 * useful in a configuration file for a vhost or directory, rather than
Chris@0 380 * the default settings.php. Any configuration setting from the 'variable'
Chris@0 381 * table can be given a new value. Note that any values you provide in
Chris@0 382 * these variable overrides will not be modifiable from the Drupal
Chris@0 383 * administration interface.
Chris@0 384 *
Chris@0 385 * The following overrides are examples:
Chris@0 386 * - site_name: Defines the site's name.
Chris@0 387 * - theme_default: Defines the default theme for this site.
Chris@0 388 * - anonymous: Defines the human-readable name of anonymous users.
Chris@0 389 * Remove the leading hash signs to enable.
Chris@0 390 */
Chris@0 391 # $conf['site_name'] = 'My Drupal site';
Chris@0 392 # $conf['theme_default'] = 'garland';
Chris@0 393 # $conf['anonymous'] = 'Visitor';
Chris@0 394
Chris@0 395 /**
Chris@0 396 * A custom theme can be set for the offline page. This applies when the site
Chris@0 397 * is explicitly set to maintenance mode through the administration page or when
Chris@0 398 * the database is inactive due to an error. It can be set through the
Chris@0 399 * 'maintenance_theme' key. The template file should also be copied into the
Chris@0 400 * theme. It is located inside 'modules/system/maintenance-page.tpl.php'.
Chris@0 401 * Note: This setting does not apply to installation and update pages.
Chris@0 402 */
Chris@0 403 # $conf['maintenance_theme'] = 'bartik';
Chris@0 404
Chris@0 405 /**
Chris@0 406 * Reverse Proxy Configuration:
Chris@0 407 *
Chris@0 408 * Reverse proxy servers are often used to enhance the performance
Chris@0 409 * of heavily visited sites and may also provide other site caching,
Chris@0 410 * security, or encryption benefits. In an environment where Drupal
Chris@0 411 * is behind a reverse proxy, the real IP address of the client should
Chris@0 412 * be determined such that the correct client IP address is available
Chris@0 413 * to Drupal's logging, statistics, and access management systems. In
Chris@0 414 * the most simple scenario, the proxy server will add an
Chris@0 415 * X-Forwarded-For header to the request that contains the client IP
Chris@0 416 * address. However, HTTP headers are vulnerable to spoofing, where a
Chris@0 417 * malicious client could bypass restrictions by setting the
Chris@0 418 * X-Forwarded-For header directly. Therefore, Drupal's proxy
Chris@0 419 * configuration requires the IP addresses of all remote proxies to be
Chris@0 420 * specified in $conf['reverse_proxy_addresses'] to work correctly.
Chris@0 421 *
Chris@0 422 * Enable this setting to get Drupal to determine the client IP from
Chris@0 423 * the X-Forwarded-For header (or $conf['reverse_proxy_header'] if set).
Chris@0 424 * If you are unsure about this setting, do not have a reverse proxy,
Chris@0 425 * or Drupal operates in a shared hosting environment, this setting
Chris@0 426 * should remain commented out.
Chris@0 427 *
Chris@0 428 * In order for this setting to be used you must specify every possible
Chris@0 429 * reverse proxy IP address in $conf['reverse_proxy_addresses'].
Chris@0 430 * If a complete list of reverse proxies is not available in your
Chris@0 431 * environment (for example, if you use a CDN) you may set the
Chris@0 432 * $_SERVER['REMOTE_ADDR'] variable directly in settings.php.
Chris@0 433 * Be aware, however, that it is likely that this would allow IP
Chris@0 434 * address spoofing unless more advanced precautions are taken.
Chris@0 435 */
Chris@0 436 # $conf['reverse_proxy'] = TRUE;
Chris@0 437
Chris@0 438 /**
Chris@0 439 * Specify every reverse proxy IP address in your environment.
Chris@0 440 * This setting is required if $conf['reverse_proxy'] is TRUE.
Chris@0 441 */
Chris@0 442 # $conf['reverse_proxy_addresses'] = array('a.b.c.d', ...);
Chris@0 443
Chris@0 444 /**
Chris@0 445 * Set this value if your proxy server sends the client IP in a header
Chris@0 446 * other than X-Forwarded-For.
Chris@0 447 */
Chris@0 448 # $conf['reverse_proxy_header'] = 'HTTP_X_CLUSTER_CLIENT_IP';
Chris@0 449
Chris@0 450 /**
Chris@0 451 * Page caching:
Chris@0 452 *
Chris@0 453 * By default, Drupal sends a "Vary: Cookie" HTTP header for anonymous page
Chris@0 454 * views. This tells a HTTP proxy that it may return a page from its local
Chris@0 455 * cache without contacting the web server, if the user sends the same Cookie
Chris@0 456 * header as the user who originally requested the cached page. Without "Vary:
Chris@0 457 * Cookie", authenticated users would also be served the anonymous page from
Chris@0 458 * the cache. If the site has mostly anonymous users except a few known
Chris@0 459 * editors/administrators, the Vary header can be omitted. This allows for
Chris@0 460 * better caching in HTTP proxies (including reverse proxies), i.e. even if
Chris@0 461 * clients send different cookies, they still get content served from the cache.
Chris@0 462 * However, authenticated users should access the site directly (i.e. not use an
Chris@0 463 * HTTP proxy, and bypass the reverse proxy if one is used) in order to avoid
Chris@0 464 * getting cached pages from the proxy.
Chris@0 465 */
Chris@0 466 # $conf['omit_vary_cookie'] = TRUE;
Chris@0 467
Chris@0 468 /**
Chris@0 469 * CSS/JS aggregated file gzip compression:
Chris@0 470 *
Chris@0 471 * By default, when CSS or JS aggregation and clean URLs are enabled Drupal will
Chris@0 472 * store a gzip compressed (.gz) copy of the aggregated files. If this file is
Chris@0 473 * available then rewrite rules in the default .htaccess file will serve these
Chris@0 474 * files to browsers that accept gzip encoded content. This allows pages to load
Chris@0 475 * faster for these users and has minimal impact on server load. If you are
Chris@0 476 * using a webserver other than Apache httpd, or a caching reverse proxy that is
Chris@0 477 * configured to cache and compress these files itself you may want to uncomment
Chris@0 478 * one or both of the below lines, which will prevent gzip files being stored.
Chris@0 479 */
Chris@0 480 # $conf['css_gzip_compression'] = FALSE;
Chris@0 481 # $conf['js_gzip_compression'] = FALSE;
Chris@0 482
Chris@0 483 /**
Chris@0 484 * Block caching:
Chris@0 485 *
Chris@0 486 * Block caching may not be compatible with node access modules depending on
Chris@0 487 * how the original block cache policy is defined by the module that provides
Chris@0 488 * the block. By default, Drupal therefore disables block caching when one or
Chris@0 489 * more modules implement hook_node_grants(). If you consider block caching to
Chris@0 490 * be safe on your site and want to bypass this restriction, uncomment the line
Chris@0 491 * below.
Chris@0 492 */
Chris@0 493 # $conf['block_cache_bypass_node_grants'] = TRUE;
Chris@0 494
Chris@0 495 /**
Chris@0 496 * String overrides:
Chris@0 497 *
Chris@0 498 * To override specific strings on your site with or without enabling the Locale
Chris@0 499 * module, add an entry to this list. This functionality allows you to change
Chris@0 500 * a small number of your site's default English language interface strings.
Chris@0 501 *
Chris@0 502 * Remove the leading hash signs to enable.
Chris@0 503 */
Chris@0 504 # $conf['locale_custom_strings_en'][''] = array(
Chris@0 505 # 'forum' => 'Discussion board',
Chris@0 506 # '@count min' => '@count minutes',
Chris@0 507 # );
Chris@0 508
Chris@0 509 /**
Chris@0 510 *
Chris@0 511 * IP blocking:
Chris@0 512 *
Chris@0 513 * To bypass database queries for denied IP addresses, use this setting.
Chris@0 514 * Drupal queries the {blocked_ips} table by default on every page request
Chris@0 515 * for both authenticated and anonymous users. This allows the system to
Chris@0 516 * block IP addresses from within the administrative interface and before any
Chris@0 517 * modules are loaded. However on high traffic websites you may want to avoid
Chris@0 518 * this query, allowing you to bypass database access altogether for anonymous
Chris@0 519 * users under certain caching configurations.
Chris@0 520 *
Chris@0 521 * If using this setting, you will need to add back any IP addresses which
Chris@0 522 * you may have blocked via the administrative interface. Each element of this
Chris@0 523 * array represents a blocked IP address. Uncommenting the array and leaving it
Chris@0 524 * empty will have the effect of disabling IP blocking on your site.
Chris@0 525 *
Chris@0 526 * Remove the leading hash signs to enable.
Chris@0 527 */
Chris@0 528 # $conf['blocked_ips'] = array(
Chris@0 529 # 'a.b.c.d',
Chris@0 530 # );
Chris@0 531
Chris@0 532 /**
Chris@0 533 * Fast 404 pages:
Chris@0 534 *
Chris@0 535 * Drupal can generate fully themed 404 pages. However, some of these responses
Chris@0 536 * are for images or other resource files that are not displayed to the user.
Chris@0 537 * This can waste bandwidth, and also generate server load.
Chris@0 538 *
Chris@0 539 * The options below return a simple, fast 404 page for URLs matching a
Chris@0 540 * specific pattern:
Chris@0 541 * - 404_fast_paths_exclude: A regular expression to match paths to exclude,
Chris@0 542 * such as images generated by image styles, or dynamically-resized images.
Chris@0 543 * The default pattern provided below also excludes the private file system.
Chris@0 544 * If you need to add more paths, you can add '|path' to the expression.
Chris@0 545 * - 404_fast_paths: A regular expression to match paths that should return a
Chris@0 546 * simple 404 page, rather than the fully themed 404 page. If you don't have
Chris@0 547 * any aliases ending in htm or html you can add '|s?html?' to the expression.
Chris@0 548 * - 404_fast_html: The html to return for simple 404 pages.
Chris@0 549 *
Chris@0 550 * Add leading hash signs if you would like to disable this functionality.
Chris@0 551 */
Chris@0 552 $conf['404_fast_paths_exclude'] = '/\/(?:styles)|(?:system\/files)\//';
Chris@0 553 $conf['404_fast_paths'] = '/\.(?:txt|png|gif|jpe?g|css|js|ico|swf|flv|cgi|bat|pl|dll|exe|asp)$/i';
Chris@0 554 $conf['404_fast_html'] = '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><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>';
Chris@0 555
Chris@0 556 /**
Chris@0 557 * By default the page request process will return a fast 404 page for missing
Chris@0 558 * files if they match the regular expression set in '404_fast_paths' and not
Chris@0 559 * '404_fast_paths_exclude' above. 404 errors will simultaneously be logged in
Chris@0 560 * the Drupal system log.
Chris@0 561 *
Chris@0 562 * You can choose to return a fast 404 page earlier for missing pages (as soon
Chris@0 563 * as settings.php is loaded) by uncommenting the line below. This speeds up
Chris@0 564 * server response time when loading 404 error pages and prevents the 404 error
Chris@0 565 * from being logged in the Drupal system log. In order to prevent valid pages
Chris@0 566 * such as image styles and other generated content that may match the
Chris@0 567 * '404_fast_paths' regular expression from returning 404 errors, it is
Chris@0 568 * necessary to add them to the '404_fast_paths_exclude' regular expression
Chris@0 569 * above. Make sure that you understand the effects of this feature before
Chris@0 570 * uncommenting the line below.
Chris@0 571 */
Chris@0 572 # drupal_fast_404();
Chris@0 573
Chris@0 574 /**
Chris@0 575 * External access proxy settings:
Chris@0 576 *
Chris@0 577 * If your site must access the Internet via a web proxy then you can enter
Chris@0 578 * the proxy settings here. Currently only basic authentication is supported
Chris@0 579 * by using the username and password variables. The proxy_user_agent variable
Chris@0 580 * can be set to NULL for proxies that require no User-Agent header or to a
Chris@0 581 * non-empty string for proxies that limit requests to a specific agent. The
Chris@0 582 * proxy_exceptions variable is an array of host names to be accessed directly,
Chris@0 583 * not via proxy.
Chris@0 584 */
Chris@0 585 # $conf['proxy_server'] = '';
Chris@0 586 # $conf['proxy_port'] = 8080;
Chris@0 587 # $conf['proxy_username'] = '';
Chris@0 588 # $conf['proxy_password'] = '';
Chris@0 589 # $conf['proxy_user_agent'] = '';
Chris@0 590 # $conf['proxy_exceptions'] = array('127.0.0.1', 'localhost');
Chris@0 591
Chris@0 592 /**
Chris@0 593 * Authorized file system operations:
Chris@0 594 *
Chris@0 595 * The Update manager module included with Drupal provides a mechanism for
Chris@0 596 * site administrators to securely install missing updates for the site
Chris@0 597 * directly through the web user interface. On securely-configured servers,
Chris@0 598 * the Update manager will require the administrator to provide SSH or FTP
Chris@0 599 * credentials before allowing the installation to proceed; this allows the
Chris@0 600 * site to update the new files as the user who owns all the Drupal files,
Chris@0 601 * instead of as the user the webserver is running as. On servers where the
Chris@0 602 * webserver user is itself the owner of the Drupal files, the administrator
Chris@0 603 * will not be prompted for SSH or FTP credentials (note that these server
Chris@0 604 * setups are common on shared hosting, but are inherently insecure).
Chris@0 605 *
Chris@0 606 * Some sites might wish to disable the above functionality, and only update
Chris@0 607 * the code directly via SSH or FTP themselves. This setting completely
Chris@0 608 * disables all functionality related to these authorized file operations.
Chris@0 609 *
Chris@0 610 * @see http://drupal.org/node/244924
Chris@0 611 *
Chris@0 612 * Remove the leading hash signs to disable.
Chris@0 613 */
Chris@0 614 # $conf['allow_authorize_operations'] = FALSE;
Chris@0 615
Chris@0 616 /**
Chris@0 617 * Theme debugging:
Chris@0 618 *
Chris@0 619 * When debugging is enabled:
Chris@0 620 * - The markup of each template is surrounded by HTML comments that contain
Chris@0 621 * theming information, such as template file name suggestions.
Chris@0 622 * - Note that this debugging markup will cause automated tests that directly
Chris@0 623 * check rendered HTML to fail.
Chris@0 624 *
Chris@0 625 * For more information about debugging theme templates, see
Chris@0 626 * https://www.drupal.org/node/223440#theme-debug.
Chris@0 627 *
Chris@0 628 * Not recommended in production environments.
Chris@0 629 *
Chris@0 630 * Remove the leading hash sign to enable.
Chris@0 631 */
Chris@0 632 # $conf['theme_debug'] = TRUE;
Chris@0 633
Chris@0 634 /**
Chris@0 635 * CSS identifier double underscores allowance:
Chris@0 636 *
Chris@0 637 * To allow CSS identifiers to contain double underscores (.example__selector)
Chris@0 638 * for Drupal's BEM-style naming standards, uncomment the line below.
Chris@0 639 * Note that if you change this value in existing sites, existing page styles
Chris@0 640 * may be broken.
Chris@0 641 *
Chris@0 642 * @see drupal_clean_css_identifier()
Chris@0 643 */
Chris@0 644 # $conf['allow_css_double_underscores'] = TRUE;