default.settings.php 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892
  1. <?php
  2. // phpcs:ignoreFile
  3. /**
  4. * @file
  5. * Drupal site-specific configuration file.
  6. *
  7. * IMPORTANT NOTE:
  8. * This file may have been set to read-only by the Drupal installation program.
  9. * If you make changes to this file, be sure to protect it again after making
  10. * your modifications. Failure to remove write permissions to this file is a
  11. * security risk.
  12. *
  13. * In order to use the selection rules below the multisite aliasing file named
  14. * sites/sites.php must be present. Its optional settings will be loaded, and
  15. * the aliases in the array $sites will override the default directory rules
  16. * below. See sites/example.sites.php for more information about aliases.
  17. *
  18. * The configuration directory will be discovered by stripping the website's
  19. * hostname from left to right and pathname from right to left. The first
  20. * configuration file found will be used and any others will be ignored. If no
  21. * other configuration file is found then the default configuration file at
  22. * 'sites/default' will be used.
  23. *
  24. * For example, for a fictitious site installed at
  25. * https://www.drupal.org:8080/my-site/test/, the 'settings.php' file is searched
  26. * for in the following directories:
  27. *
  28. * - sites/8080.www.drupal.org.my-site.test
  29. * - sites/www.drupal.org.my-site.test
  30. * - sites/drupal.org.my-site.test
  31. * - sites/org.my-site.test
  32. *
  33. * - sites/8080.www.drupal.org.my-site
  34. * - sites/www.drupal.org.my-site
  35. * - sites/drupal.org.my-site
  36. * - sites/org.my-site
  37. *
  38. * - sites/8080.www.drupal.org
  39. * - sites/www.drupal.org
  40. * - sites/drupal.org
  41. * - sites/org
  42. *
  43. * - sites/default
  44. *
  45. * Note that if you are installing on a non-standard port number, prefix the
  46. * hostname with that number. For example,
  47. * https://www.drupal.org:8080/my-site/test/ could be loaded from
  48. * sites/8080.www.drupal.org.my-site.test/.
  49. *
  50. * @see example.sites.php
  51. * @see \Drupal\Core\DrupalKernel::getSitePath()
  52. *
  53. * In addition to customizing application settings through variables in
  54. * settings.php, you can create a services.yml file in the same directory to
  55. * register custom, site-specific service definitions and/or swap out default
  56. * implementations with custom ones.
  57. */
  58. /**
  59. * Database settings:
  60. *
  61. * The $databases array specifies the database connection or
  62. * connections that Drupal may use. Drupal is able to connect
  63. * to multiple databases, including multiple types of databases,
  64. * during the same request.
  65. *
  66. * One example of the simplest connection array is shown below. To use the
  67. * sample settings, copy and uncomment the code below between the @code and
  68. * @endcode lines and paste it after the $databases declaration. You will need
  69. * to replace the database username and password and possibly the host and port
  70. * with the appropriate credentials for your database system.
  71. *
  72. * The next section describes how to customize the $databases array for more
  73. * specific needs.
  74. *
  75. * @code
  76. * $databases['default']['default'] = [
  77. * 'database' => 'database_name',
  78. * 'username' => 'sql_username',
  79. * 'password' => 'sql_password',
  80. * 'host' => 'localhost',
  81. * 'port' => '3306',
  82. * 'driver' => 'mysql',
  83. * 'prefix' => '',
  84. * 'collation' => 'utf8mb4_general_ci',
  85. * ];
  86. * @endcode
  87. */
  88. $databases = [];
  89. /**
  90. * Customizing database settings.
  91. *
  92. * Many of the values of the $databases array can be customized for your
  93. * particular database system. Refer to the sample in the section above as a
  94. * starting point.
  95. *
  96. * The "driver" property indicates what Drupal database driver the
  97. * connection should use. This is usually the same as the name of the
  98. * database type, such as mysql or sqlite, but not always. The other
  99. * properties will vary depending on the driver. For SQLite, you must
  100. * specify a database file name in a directory that is writable by the
  101. * webserver. For most other drivers, you must specify a
  102. * username, password, host, and database name.
  103. *
  104. * Drupal core implements drivers for mysql, pgsql, and sqlite. Other drivers
  105. * can be provided by contributed or custom modules. To use a contributed or
  106. * custom driver, the "namespace" property must be set to the namespace of the
  107. * driver. The code in this namespace must be autoloadable prior to connecting
  108. * to the database, and therefore, prior to when module root namespaces are
  109. * added to the autoloader. To add the driver's namespace to the autoloader,
  110. * set the "autoload" property to the PSR-4 base directory of the driver's
  111. * namespace. This is optional for projects managed with Composer if the
  112. * driver's namespace is in Composer's autoloader.
  113. *
  114. * For each database, you may optionally specify multiple "target" databases.
  115. * A target database allows Drupal to try to send certain queries to a
  116. * different database if it can but fall back to the default connection if not.
  117. * That is useful for primary/replica replication, as Drupal may try to connect
  118. * to a replica server when appropriate and if one is not available will simply
  119. * fall back to the single primary server (The terms primary/replica are
  120. * traditionally referred to as master/slave in database server documentation).
  121. *
  122. * The general format for the $databases array is as follows:
  123. * @code
  124. * $databases['default']['default'] = $info_array;
  125. * $databases['default']['replica'][] = $info_array;
  126. * $databases['default']['replica'][] = $info_array;
  127. * $databases['extra']['default'] = $info_array;
  128. * @endcode
  129. *
  130. * In the above example, $info_array is an array of settings described above.
  131. * The first line sets a "default" database that has one primary database
  132. * (the second level default). The second and third lines create an array
  133. * of potential replica databases. Drupal will select one at random for a given
  134. * request as needed. The fourth line creates a new database with a name of
  135. * "extra".
  136. *
  137. * For MySQL, MariaDB or equivalent databases the 'isolation_level' option can
  138. * be set. The recommended transaction isolation level for Drupal sites is
  139. * 'READ COMMITTED'. The 'REPEATABLE READ' option is supported but can result
  140. * in deadlocks, the other two options are 'READ UNCOMMITTED' and 'SERIALIZABLE'.
  141. * They are available but not supported; use them at your own risk. For more
  142. * info:
  143. * https://dev.mysql.com/doc/refman/5.7/en/innodb-transaction-isolation-levels.html
  144. *
  145. * On your settings.php, change the isolation level:
  146. * @code
  147. * $databases['default']['default']['init_commands'] = [
  148. * 'isolation_level' => 'SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED',
  149. * ];
  150. * @endcode
  151. *
  152. * You can optionally set a prefix for all database table names by using the
  153. * 'prefix' setting. If a prefix is specified, the table name will be prepended
  154. * with its value. Be sure to use valid database characters only, usually
  155. * alphanumeric and underscore. If no prefix is desired, do not set the 'prefix'
  156. * key or set its value to an empty string ''.
  157. *
  158. * For example, to have all database table prefixed with 'main_', set:
  159. * @code
  160. * 'prefix' => 'main_',
  161. * @endcode
  162. *
  163. * Advanced users can add or override initial commands to execute when
  164. * connecting to the database server, as well as PDO connection settings. For
  165. * example, to enable MySQL SELECT queries to exceed the max_join_size system
  166. * variable, and to reduce the database connection timeout to 5 seconds:
  167. * @code
  168. * $databases['default']['default'] = [
  169. * 'init_commands' => [
  170. * 'big_selects' => 'SET SQL_BIG_SELECTS=1',
  171. * ],
  172. * 'pdo' => [
  173. * PDO::ATTR_TIMEOUT => 5,
  174. * ],
  175. * ];
  176. * @endcode
  177. *
  178. * WARNING: The above defaults are designed for database portability. Changing
  179. * them may cause unexpected behavior, including potential data loss. See
  180. * https://www.drupal.org/docs/8/api/database-api/database-configuration for
  181. * more information on these defaults and the potential issues.
  182. *
  183. * More details can be found in the constructor methods for each driver:
  184. * - \Drupal\mysql\Driver\Database\mysql\Connection::__construct()
  185. * - \Drupal\pgsql\Driver\Database\pgsql\Connection::__construct()
  186. * - \Drupal\sqlite\Driver\Database\sqlite\Connection::__construct()
  187. *
  188. * Sample Database configuration format for PostgreSQL (pgsql):
  189. * @code
  190. * $databases['default']['default'] = [
  191. * 'driver' => 'pgsql',
  192. * 'database' => 'database_name',
  193. * 'username' => 'sql_username',
  194. * 'password' => 'sql_password',
  195. * 'host' => 'localhost',
  196. * 'prefix' => '',
  197. * ];
  198. * @endcode
  199. *
  200. * Sample Database configuration format for SQLite (sqlite):
  201. * @code
  202. * $databases['default']['default'] = [
  203. * 'driver' => 'sqlite',
  204. * 'database' => '/path/to/database_filename',
  205. * ];
  206. * @endcode
  207. *
  208. * Sample Database configuration format for a driver in a contributed module:
  209. * @code
  210. * $databases['default']['default'] = [
  211. * 'driver' => 'my_driver',
  212. * 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
  213. * 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
  214. * 'database' => 'database_name',
  215. * 'username' => 'sql_username',
  216. * 'password' => 'sql_password',
  217. * 'host' => 'localhost',
  218. * 'prefix' => '',
  219. * ];
  220. * @endcode
  221. *
  222. * Sample Database configuration format for a driver that is extending another
  223. * database driver.
  224. * @code
  225. * $databases['default']['default'] = [
  226. * 'driver' => 'my_driver',
  227. * 'namespace' => 'Drupal\my_module\Driver\Database\my_driver',
  228. * 'autoload' => 'modules/my_module/src/Driver/Database/my_driver/',
  229. * 'database' => 'database_name',
  230. * 'username' => 'sql_username',
  231. * 'password' => 'sql_password',
  232. * 'host' => 'localhost',
  233. * 'prefix' => '',
  234. * 'dependencies' => [
  235. * 'parent_module' => [
  236. * 'namespace' => 'Drupal\parent_module',
  237. * 'autoload' => 'core/modules/parent_module/src/',
  238. * ],
  239. * ],
  240. * ];
  241. * @endcode
  242. */
  243. /**
  244. * Location of the site configuration files.
  245. *
  246. * The $settings['config_sync_directory'] specifies the location of file system
  247. * directory used for syncing configuration data. On install, the directory is
  248. * created. This is used for configuration imports.
  249. *
  250. * The default location for this directory is inside a randomly-named
  251. * directory in the public files path. The setting below allows you to set
  252. * its location.
  253. */
  254. # $settings['config_sync_directory'] = '/directory/outside/webroot';
  255. /**
  256. * Settings:
  257. *
  258. * $settings contains environment-specific configuration, such as the files
  259. * directory and reverse proxy address, and temporary configuration, such as
  260. * security overrides.
  261. *
  262. * @see \Drupal\Core\Site\Settings::get()
  263. */
  264. /**
  265. * Salt for one-time login links, cancel links, form tokens, etc.
  266. *
  267. * This variable will be set to a random value by the installer. All one-time
  268. * login links will be invalidated if the value is changed. Note that if your
  269. * site is deployed on a cluster of web servers, you must ensure that this
  270. * variable has the same value on each server.
  271. *
  272. * For enhanced security, you may set this variable to the contents of a file
  273. * outside your document root, and vary the value across environments (like
  274. * production and development); you should also ensure that this file is not
  275. * stored with backups of your database.
  276. *
  277. * Example:
  278. * @code
  279. * $settings['hash_salt'] = file_get_contents('/home/example/salt.txt');
  280. * @endcode
  281. */
  282. $settings['hash_salt'] = '';
  283. /**
  284. * Deployment identifier.
  285. *
  286. * Drupal's dependency injection container will be automatically invalidated and
  287. * rebuilt when the Drupal core version changes. When updating contributed or
  288. * custom code that changes the container, changing this identifier will also
  289. * allow the container to be invalidated as soon as code is deployed.
  290. */
  291. # $settings['deployment_identifier'] = \Drupal::VERSION;
  292. /**
  293. * Access control for update.php script.
  294. *
  295. * If you are updating your Drupal installation using the update.php script but
  296. * are not logged in using either an account with the "Administer software
  297. * updates" permission or the site maintenance account (the account that was
  298. * created during installation), you will need to modify the access check
  299. * statement below. Change the FALSE to a TRUE to disable the access check.
  300. * After finishing the upgrade, be sure to open this file again and change the
  301. * TRUE back to a FALSE!
  302. */
  303. $settings['update_free_access'] = FALSE;
  304. /**
  305. * Fallback to HTTP for Update Manager and for fetching security advisories.
  306. *
  307. * If your site fails to connect to updates.drupal.org over HTTPS (either when
  308. * fetching data on available updates, or when fetching the feed of critical
  309. * security announcements), you may uncomment this setting and set it to TRUE to
  310. * allow an insecure fallback to HTTP. Note that doing so will open your site up
  311. * to a potential man-in-the-middle attack. You should instead attempt to
  312. * resolve the issues before enabling this option.
  313. * @see https://www.drupal.org/docs/system-requirements/php-requirements#openssl
  314. * @see https://en.wikipedia.org/wiki/Man-in-the-middle_attack
  315. * @see \Drupal\update\UpdateFetcher
  316. * @see \Drupal\system\SecurityAdvisories\SecurityAdvisoriesFetcher
  317. */
  318. # $settings['update_fetch_with_http_fallback'] = TRUE;
  319. /**
  320. * External access proxy settings:
  321. *
  322. * If your site must access the Internet via a web proxy then you can enter the
  323. * proxy settings here. Set the full URL of the proxy, including the port, in
  324. * variables:
  325. * - $settings['http_client_config']['proxy']['http']: The proxy URL for HTTP
  326. * requests.
  327. * - $settings['http_client_config']['proxy']['https']: The proxy URL for HTTPS
  328. * requests.
  329. * You can pass in the user name and password for basic authentication in the
  330. * URLs in these settings.
  331. *
  332. * You can also define an array of host names that can be accessed directly,
  333. * bypassing the proxy, in $settings['http_client_config']['proxy']['no'].
  334. */
  335. # $settings['http_client_config']['proxy']['http'] = 'http://proxy_user:proxy_pass@example.com:8080';
  336. # $settings['http_client_config']['proxy']['https'] = 'http://proxy_user:proxy_pass@example.com:8080';
  337. # $settings['http_client_config']['proxy']['no'] = ['127.0.0.1', 'localhost'];
  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 and access management systems. In the most simple
  347. * scenario, the proxy server will add an X-Forwarded-For header to the request
  348. * that contains the client IP address. However, HTTP headers are vulnerable to
  349. * spoofing, where a malicious client could bypass restrictions by setting the
  350. * X-Forwarded-For header directly. Therefore, Drupal's proxy configuration
  351. * requires the IP addresses of all remote proxies to be specified in
  352. * $settings['reverse_proxy_addresses'] to work correctly.
  353. *
  354. * Enable this setting to get Drupal to determine the client IP from the
  355. * X-Forwarded-For header. If you are unsure about this setting, do not have a
  356. * reverse proxy, or Drupal operates in a shared hosting environment, this
  357. * setting should remain commented out.
  358. *
  359. * In order for this setting to be used you must specify every possible
  360. * reverse proxy IP address in $settings['reverse_proxy_addresses'].
  361. * If a complete list of reverse proxies is not available in your
  362. * environment (for example, if you use a CDN) you may set the
  363. * $_SERVER['REMOTE_ADDR'] variable directly in settings.php.
  364. * Be aware, however, that it is likely that this would allow IP
  365. * address spoofing unless more advanced precautions are taken.
  366. */
  367. # $settings['reverse_proxy'] = TRUE;
  368. /**
  369. * Reverse proxy addresses.
  370. *
  371. * Specify every reverse proxy IP address in your environment, as an array of
  372. * IPv4/IPv6 addresses or subnets in CIDR notation. This setting is required if
  373. * $settings['reverse_proxy'] is TRUE.
  374. */
  375. # $settings['reverse_proxy_addresses'] = ['a.b.c.d', 'e.f.g.h/24', ...];
  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_FOR
  383. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST
  384. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT
  385. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO
  386. * - \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
  387. *
  388. * Note the default value of
  389. * @code
  390. * \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
  391. * @endcode
  392. * is not secure by default. The value should be set to only the specific
  393. * headers the reverse proxy uses. For example:
  394. * @code
  395. * \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
  396. * @endcode
  397. * This would trust the following headers:
  398. * - X_FORWARDED_FOR
  399. * - X_FORWARDED_HOST
  400. * - X_FORWARDED_PROTO
  401. * - X_FORWARDED_PORT
  402. *
  403. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR
  404. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST
  405. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT
  406. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO
  407. * @see \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
  408. * @see \Symfony\Component\HttpFoundation\Request::setTrustedProxies
  409. */
  410. # $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;
  411. /**
  412. * Page caching:
  413. *
  414. * By default, Drupal sends a "Vary: Cookie" HTTP header for anonymous page
  415. * views. This tells a HTTP proxy that it may return a page from its local
  416. * cache without contacting the web server, if the user sends the same Cookie
  417. * header as the user who originally requested the cached page. Without "Vary:
  418. * Cookie", authenticated users would also be served the anonymous page from
  419. * the cache. If the site has mostly anonymous users except a few known
  420. * editors/administrators, the Vary header can be omitted. This allows for
  421. * better caching in HTTP proxies (including reverse proxies), i.e. even if
  422. * clients send different cookies, they still get content served from the cache.
  423. * However, authenticated users should access the site directly (i.e. not use an
  424. * HTTP proxy, and bypass the reverse proxy if one is used) in order to avoid
  425. * getting cached pages from the proxy.
  426. */
  427. # $settings['omit_vary_cookie'] = TRUE;
  428. /**
  429. * Cache TTL for client error (4xx) responses.
  430. *
  431. * Items cached per-URL tend to result in a large number of cache items, and
  432. * this can be problematic on 404 pages which by their nature are unbounded. A
  433. * fixed TTL can be set for these items, defaulting to one hour, so that cache
  434. * backends which do not support LRU can purge older entries. To disable caching
  435. * of client error responses set the value to 0. Currently applies only to
  436. * page_cache module.
  437. */
  438. # $settings['cache_ttl_4xx'] = 3600;
  439. /**
  440. * Expiration of cached forms.
  441. *
  442. * Drupal's Form API stores details of forms in a cache and these entries are
  443. * kept for at least 6 hours by default. Expired entries are cleared by cron.
  444. *
  445. * @see \Drupal\Core\Form\FormCache::setCache()
  446. */
  447. # $settings['form_cache_expiration'] = 21600;
  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. * Authorized file system operations:
  459. *
  460. * The Update Manager module included with Drupal provides a mechanism for
  461. * site administrators to securely install missing updates for the site
  462. * directly through the web user interface. On securely-configured servers,
  463. * the Update manager will require the administrator to provide SSH or FTP
  464. * credentials before allowing the installation to proceed; this allows the
  465. * site to update the new files as the user who owns all the Drupal files,
  466. * instead of as the user the webserver is running as. On servers where the
  467. * webserver user is itself the owner of the Drupal files, the administrator
  468. * will not be prompted for SSH or FTP credentials (note that these server
  469. * setups are common on shared hosting, but are inherently insecure).
  470. *
  471. * Some sites might wish to disable the above functionality, and only update
  472. * the code directly via SSH or FTP themselves. This setting completely
  473. * disables all functionality related to these authorized file operations.
  474. *
  475. * @see https://www.drupal.org/node/244924
  476. *
  477. * Remove the leading hash signs to disable.
  478. */
  479. # $settings['allow_authorize_operations'] = FALSE;
  480. /**
  481. * Default mode for directories and files written by Drupal.
  482. *
  483. * Value should be in PHP Octal Notation, with leading zero.
  484. */
  485. # $settings['file_chmod_directory'] = 0775;
  486. # $settings['file_chmod_file'] = 0664;
  487. /**
  488. * Optimized assets path:
  489. *
  490. * A local file system path where optimized assets will be stored. This directory
  491. * must exist and be writable by Drupal. This directory must be relative to
  492. * the Drupal installation directory and be accessible over the web.
  493. */
  494. # $settings['file_assets_path'] = 'sites/default/files';
  495. /**
  496. * Public file base URL:
  497. *
  498. * An alternative base URL to be used for serving public files. This must
  499. * include any leading directory path.
  500. *
  501. * A different value from the domain used by Drupal to be used for accessing
  502. * public files. This can be used for a simple CDN integration, or to improve
  503. * security by serving user-uploaded files from a different domain or subdomain
  504. * pointing to the same server. Do not include a trailing slash.
  505. */
  506. # $settings['file_public_base_url'] = 'http://downloads.example.com/files';
  507. /**
  508. * Public file path:
  509. *
  510. * A local file system path where public files will be stored. This directory
  511. * must exist and be writable by Drupal. This directory must be relative to
  512. * the Drupal installation directory and be accessible over the web.
  513. */
  514. # $settings['file_public_path'] = 'sites/default/files';
  515. /**
  516. * Additional public file schemes:
  517. *
  518. * Public schemes are URI schemes that allow download access to all users for
  519. * all files within that scheme.
  520. *
  521. * The "public" scheme is always public, and the "private" scheme is always
  522. * private, but other schemes, such as "https", "s3", "example", or others,
  523. * can be either public or private depending on the site. By default, they're
  524. * private, and access to individual files is controlled via
  525. * hook_file_download().
  526. *
  527. * Typically, if a scheme should be public, a module makes it public by
  528. * implementing hook_file_download(), and granting access to all users for all
  529. * files. This could be either the same module that provides the stream wrapper
  530. * for the scheme, or a different module that decides to make the scheme
  531. * public. However, in cases where a site needs to make a scheme public, but
  532. * is unable to add code in a module to do so, the scheme may be added to this
  533. * variable, the result of which is that system_file_download() grants public
  534. * access to all files within that scheme.
  535. */
  536. # $settings['file_additional_public_schemes'] = ['example'];
  537. /**
  538. * File schemes whose paths should not be normalized:
  539. *
  540. * Normally, Drupal normalizes '/./' and '/../' segments in file URIs in order
  541. * to prevent unintended file access. For example, 'private://css/../image.png'
  542. * is normalized to 'private://image.png' before checking access to the file.
  543. *
  544. * On Windows, Drupal also replaces '\' with '/' in URIs for the local
  545. * filesystem.
  546. *
  547. * If file URIs with one or more scheme should not be normalized like this, then
  548. * list the schemes here. For example, if 'porcelain://china/./plate.png' should
  549. * not be normalized to 'porcelain://china/plate.png', then add 'porcelain' to
  550. * this array. In this case, make sure that the module providing the 'porcelain'
  551. * scheme does not allow unintended file access when using '/../' to move up the
  552. * directory tree.
  553. */
  554. # $settings['file_sa_core_2023_005_schemes'] = ['porcelain'];
  555. /**
  556. * Configuration for phpinfo() admin status report.
  557. *
  558. * Drupal's admin UI includes a report at admin/reports/status/php which shows
  559. * the output of phpinfo(). The full output can contain sensitive information
  560. * so by default Drupal removes some sections.
  561. *
  562. * This behavior can be configured by setting this variable to a different
  563. * value corresponding to the flags parameter of phpinfo().
  564. *
  565. * If you need to expose more information in the report - for example to debug a
  566. * problem - consider doing so temporarily.
  567. *
  568. * @see https://www.php.net/manual/function.phpinfo.php
  569. */
  570. # $settings['sa_core_2023_004_phpinfo_flags'] = ~ (INFO_VARIABLES | INFO_ENVIRONMENT);
  571. /**
  572. * Private file path:
  573. *
  574. * A local file system path where private files will be stored. This directory
  575. * must be absolute, outside of the Drupal installation directory and not
  576. * accessible over the web.
  577. *
  578. * Note: Caches need to be cleared when this value is changed to make the
  579. * private:// stream wrapper available to the system.
  580. *
  581. * See https://www.drupal.org/documentation/modules/file for more information
  582. * about securing private files.
  583. */
  584. # $settings['file_private_path'] = '';
  585. /**
  586. * Temporary file path:
  587. *
  588. * A local file system path where temporary files will be stored. This directory
  589. * must be absolute, outside of the Drupal installation directory and not
  590. * accessible over the web.
  591. *
  592. * If this is not set, the default for the operating system will be used.
  593. *
  594. * @see \Drupal\Component\FileSystem\FileSystem::getOsTemporaryDirectory()
  595. */
  596. # $settings['file_temp_path'] = '/tmp';
  597. /**
  598. * Session write interval:
  599. *
  600. * Set the minimum interval between each session write to database.
  601. * For performance reasons it defaults to 180.
  602. */
  603. # $settings['session_write_interval'] = 180;
  604. /**
  605. * String overrides:
  606. *
  607. * To override specific strings on your site with or without enabling the Locale
  608. * module, add an entry to this list. This functionality allows you to change
  609. * a small number of your site's default English language interface strings.
  610. *
  611. * Remove the leading hash signs to enable.
  612. *
  613. * The "en" part of the variable name, is dynamic and can be any langcode of
  614. * any added language. (eg locale_custom_strings_de for german).
  615. */
  616. # $settings['locale_custom_strings_en'][''] = [
  617. # 'Home' => 'Front page',
  618. # '@count min' => '@count minutes',
  619. # ];
  620. /**
  621. * A custom theme for the offline page:
  622. *
  623. * This applies when the site is explicitly set to maintenance mode through the
  624. * administration page or when the database is inactive due to an error.
  625. * The template file should also be copied into the theme. It is located inside
  626. * 'core/modules/system/templates/maintenance-page.html.twig'.
  627. *
  628. * Note: This setting does not apply to installation and update pages.
  629. */
  630. # $settings['maintenance_theme'] = 'claro';
  631. /**
  632. * PHP settings:
  633. *
  634. * To see what PHP settings are possible, including whether they can be set at
  635. * runtime (by using ini_set()), read the PHP documentation:
  636. * http://php.net/manual/ini.list.php
  637. * See \Drupal\Core\DrupalKernel::bootEnvironment() for required runtime
  638. * settings and the .htaccess file for non-runtime settings.
  639. * Settings defined there should not be duplicated here so as to avoid conflict
  640. * issues.
  641. */
  642. /**
  643. * If you encounter a situation where users post a large amount of text, and
  644. * the result is stripped out upon viewing but can still be edited, Drupal's
  645. * output filter may not have sufficient memory to process it. If you
  646. * experience this issue, you may wish to uncomment the following two lines
  647. * and increase the limits of these variables. For more information, see
  648. * http://php.net/manual/pcre.configuration.php.
  649. */
  650. # ini_set('pcre.backtrack_limit', 200000);
  651. # ini_set('pcre.recursion_limit', 200000);
  652. /**
  653. * Configuration overrides.
  654. *
  655. * To globally override specific configuration values for this site,
  656. * set them here. You usually don't need to use this feature. This is
  657. * useful in a configuration file for a vhost or directory, rather than
  658. * the default settings.php.
  659. *
  660. * Note that any values you provide in these variable overrides will not be
  661. * viewable from the Drupal administration interface. The administration
  662. * interface displays the values stored in configuration so that you can stage
  663. * changes to other environments that don't have the overrides.
  664. *
  665. * There are particular configuration values that are risky to override. For
  666. * example, overriding the list of installed modules in 'core.extension' is not
  667. * supported as module install or uninstall has not occurred. Other examples
  668. * include field storage configuration, because it has effects on database
  669. * structure, and 'core.menu.static_menu_link_overrides' since this is cached in
  670. * a way that is not config override aware. Also, note that changing
  671. * configuration values in settings.php will not fire any of the configuration
  672. * change events.
  673. */
  674. # $config['system.site']['name'] = 'My Drupal site';
  675. # $config['user.settings']['anonymous'] = 'Visitor';
  676. /**
  677. * Load services definition file.
  678. */
  679. $settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml';
  680. /**
  681. * Override the default service container class.
  682. *
  683. * This is useful for example to trace the service container for performance
  684. * tracking purposes, for testing a service container with an error condition or
  685. * to test a service container that throws an exception.
  686. */
  687. # $settings['container_base_class'] = '\Drupal\Core\DependencyInjection\Container';
  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. * Trusted host configuration.
  698. *
  699. * Drupal core can use the Symfony trusted host mechanism to prevent HTTP Host
  700. * header spoofing.
  701. *
  702. * To enable the trusted host mechanism, you enable your allowable hosts
  703. * in $settings['trusted_host_patterns']. This should be an array of regular
  704. * expression patterns, without delimiters, representing the hosts you would
  705. * like to allow.
  706. *
  707. * For example:
  708. * @code
  709. * $settings['trusted_host_patterns'] = [
  710. * '^www\.example\.com$',
  711. * ];
  712. * @endcode
  713. * will allow the site to only run from www.example.com.
  714. *
  715. * If you are running multisite, or if you are running your site from
  716. * different domain names (eg, you don't redirect http://www.example.com to
  717. * http://example.com), you should specify all of the host patterns that are
  718. * allowed by your site.
  719. *
  720. * For example:
  721. * @code
  722. * $settings['trusted_host_patterns'] = [
  723. * '^example\.com$',
  724. * '^.+\.example\.com$',
  725. * '^example\.org$',
  726. * '^.+\.example\.org$',
  727. * ];
  728. * @endcode
  729. * will allow the site to run off of all variants of example.com and
  730. * example.org, with all subdomains included.
  731. *
  732. * @see https://www.drupal.org/docs/installing-drupal/trusted-host-settings
  733. */
  734. # $settings['trusted_host_patterns'] = [];
  735. /**
  736. * The default list of directories that will be ignored by Drupal's file API.
  737. *
  738. * By default ignore node_modules and bower_components folders to avoid issues
  739. * with common frontend tools and recursive scanning of directories looking for
  740. * extensions.
  741. *
  742. * @see \Drupal\Core\File\FileSystemInterface::scanDirectory()
  743. * @see \Drupal\Core\Extension\ExtensionDiscovery::scanDirectory()
  744. */
  745. $settings['file_scan_ignore_directories'] = [
  746. 'node_modules',
  747. 'bower_components',
  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. * Entity update backup.
  760. *
  761. * This is used to inform the entity storage handler that the backup tables as
  762. * well as the original entity type and field storage definitions should be
  763. * retained after a successful entity update process.
  764. */
  765. $settings['entity_update_backup'] = TRUE;
  766. /**
  767. * State caching.
  768. *
  769. * State caching uses the cache collector pattern to cache all requested keys
  770. * from the state API in a single cache entry, which can greatly reduce the
  771. * amount of database queries. However, some sites may use state with a
  772. * lot of dynamic keys which could result in a very large cache.
  773. */
  774. $settings['state_cache'] = TRUE;
  775. /**
  776. * Node migration type.
  777. *
  778. * This is used to force the migration system to use the classic node migrations
  779. * instead of the default complete node migrations. The migration system will
  780. * use the classic node migration only if there are existing migrate_map tables
  781. * for the classic node migrations and they contain data. These tables may not
  782. * exist if you are developing custom migrations and do not want to use the
  783. * complete node migrations. Set this to TRUE to force the use of the classic
  784. * node migrations.
  785. */
  786. $settings['migrate_node_migrate_type_classic'] = FALSE;
  787. /**
  788. * The default settings for migration sources.
  789. *
  790. * These settings are used as the default settings on the Credential form at
  791. * /upgrade/credentials.
  792. *
  793. * - migrate_source_version - The version of the source database. This can be
  794. * '6' or '7'. Defaults to '7'.
  795. * - migrate_source_connection - The key in the $databases array for the source
  796. * site.
  797. * - migrate_file_public_path - The location of the source Drupal 6 or Drupal 7
  798. * public files. This can be a local file directory containing the source
  799. * Drupal 6 or Drupal 7 site (e.g /var/www/docroot), or the site address
  800. * (e.g http://example.com).
  801. * - migrate_file_private_path - The location of the source Drupal 7 private
  802. * files. This can be a local file directory containing the source Drupal 7
  803. * site (e.g /var/www/docroot), or empty to use the same value as Public
  804. * files directory.
  805. *
  806. * Sample configuration for a drupal 6 source site with the source files in a
  807. * local directory.
  808. *
  809. * @code
  810. * $settings['migrate_source_version'] = '6';
  811. * $settings['migrate_source_connection'] = 'migrate';
  812. * $settings['migrate_file_public_path'] = '/var/www/drupal6';
  813. * @endcode
  814. *
  815. * Sample configuration for a drupal 7 source site with public source files on
  816. * the source site and the private files in a local directory.
  817. *
  818. * @code
  819. * $settings['migrate_source_version'] = '7';
  820. * $settings['migrate_source_connection'] = 'migrate';
  821. * $settings['migrate_file_public_path'] = 'https://drupal7.com';
  822. * $settings['migrate_file_private_path'] = '/var/www/drupal7';
  823. * @endcode
  824. */
  825. # $settings['migrate_source_connection'] = '';
  826. # $settings['migrate_source_version'] = '';
  827. # $settings['migrate_file_public_path'] = '';
  828. # $settings['migrate_file_private_path'] = '';
  829. /**
  830. * Load local development override configuration, if available.
  831. *
  832. * Create a settings.local.php file to override variables on secondary (staging,
  833. * development, etc.) installations of this site.
  834. *
  835. * Typical uses of settings.local.php include:
  836. * - Disabling caching.
  837. * - Disabling JavaScript/CSS compression.
  838. * - Rerouting outgoing emails.
  839. *
  840. * Keep this code block at the end of this file to take full effect.
  841. */
  842. #
  843. # if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
  844. # include $app_root . '/' . $site_path . '/settings.local.php';
  845. # }