default.settings.php 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883
  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' => 'databasename',
  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/developing/api/database/configuration for more
  181. * 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' => 'databasename',
  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' => 'databasename',
  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' => 'databasename',
  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, statistics, and access management systems. In
  347. * the most simple scenario, the proxy server will add an
  348. * X-Forwarded-For header to the request that contains the client IP
  349. * address. However, HTTP headers are vulnerable to spoofing, where a
  350. * malicious client could bypass restrictions by setting the
  351. * X-Forwarded-For header directly. Therefore, Drupal's proxy
  352. * configuration requires the IP addresses of all remote proxies to be
  353. * specified in $settings['reverse_proxy_addresses'] to work correctly.
  354. *
  355. * Enable this setting to get Drupal to determine the client IP from the
  356. * X-Forwarded-For header. If you are unsure about this setting, do not have a
  357. * reverse proxy, or Drupal operates in a shared hosting environment, this
  358. * setting should remain commented out.
  359. *
  360. * In order for this setting to be used you must specify every possible
  361. * reverse proxy IP address in $settings['reverse_proxy_addresses'].
  362. * If a complete list of reverse proxies is not available in your
  363. * environment (for example, if you use a CDN) you may set the
  364. * $_SERVER['REMOTE_ADDR'] variable directly in settings.php.
  365. * Be aware, however, that it is likely that this would allow IP
  366. * address spoofing unless more advanced precautions are taken.
  367. */
  368. # $settings['reverse_proxy'] = TRUE;
  369. /**
  370. * Reverse proxy addresses.
  371. *
  372. * Specify every reverse proxy IP address in your environment, as an array of
  373. * IPv4/IPv6 addresses or subnets in CIDR notation. This setting is required if
  374. * $settings['reverse_proxy'] is TRUE.
  375. */
  376. # $settings['reverse_proxy_addresses'] = ['a.b.c.d', 'e.f.g.h/24', ...];
  377. /**
  378. * Reverse proxy trusted headers.
  379. *
  380. * Sets which headers to trust from your reverse proxy.
  381. *
  382. * Common values are:
  383. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR
  384. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST
  385. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT
  386. * - \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO
  387. * - \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
  388. *
  389. * Note the default value of
  390. * @code
  391. * \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
  392. * @endcode
  393. * is not secure by default. The value should be set to only the specific
  394. * headers the reverse proxy uses. For example:
  395. * @code
  396. * \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
  397. * @endcode
  398. * This would trust the following headers:
  399. * - X_FORWARDED_FOR
  400. * - X_FORWARDED_HOST
  401. * - X_FORWARDED_PROTO
  402. * - X_FORWARDED_PORT
  403. *
  404. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_FOR
  405. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_HOST
  406. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PORT
  407. * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_PROTO
  408. * @see \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
  409. * @see \Symfony\Component\HttpFoundation\Request::setTrustedProxies
  410. */
  411. # $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;
  412. /**
  413. * Page caching:
  414. *
  415. * By default, Drupal sends a "Vary: Cookie" HTTP header for anonymous page
  416. * views. This tells a HTTP proxy that it may return a page from its local
  417. * cache without contacting the web server, if the user sends the same Cookie
  418. * header as the user who originally requested the cached page. Without "Vary:
  419. * Cookie", authenticated users would also be served the anonymous page from
  420. * the cache. If the site has mostly anonymous users except a few known
  421. * editors/administrators, the Vary header can be omitted. This allows for
  422. * better caching in HTTP proxies (including reverse proxies), i.e. even if
  423. * clients send different cookies, they still get content served from the cache.
  424. * However, authenticated users should access the site directly (i.e. not use an
  425. * HTTP proxy, and bypass the reverse proxy if one is used) in order to avoid
  426. * getting cached pages from the proxy.
  427. */
  428. # $settings['omit_vary_cookie'] = TRUE;
  429. /**
  430. * Cache TTL for client error (4xx) responses.
  431. *
  432. * Items cached per-URL tend to result in a large number of cache items, and
  433. * this can be problematic on 404 pages which by their nature are unbounded. A
  434. * fixed TTL can be set for these items, defaulting to one hour, so that cache
  435. * backends which do not support LRU can purge older entries. To disable caching
  436. * of client error responses set the value to 0. Currently applies only to
  437. * page_cache module.
  438. */
  439. # $settings['cache_ttl_4xx'] = 3600;
  440. /**
  441. * Expiration of cached forms.
  442. *
  443. * Drupal's Form API stores details of forms in a cache and these entries are
  444. * kept for at least 6 hours by default. Expired entries are cleared by cron.
  445. *
  446. * @see \Drupal\Core\Form\FormCache::setCache()
  447. */
  448. # $settings['form_cache_expiration'] = 21600;
  449. /**
  450. * Class Loader.
  451. *
  452. * If the APCu extension is detected, the classloader will be optimized to use
  453. * it. Set to FALSE to disable this.
  454. *
  455. * @see https://getcomposer.org/doc/articles/autoloader-optimization.md
  456. */
  457. # $settings['class_loader_auto_detect'] = FALSE;
  458. /**
  459. * Authorized file system operations:
  460. *
  461. * The Update Manager module included with Drupal provides a mechanism for
  462. * site administrators to securely install missing updates for the site
  463. * directly through the web user interface. On securely-configured servers,
  464. * the Update manager will require the administrator to provide SSH or FTP
  465. * credentials before allowing the installation to proceed; this allows the
  466. * site to update the new files as the user who owns all the Drupal files,
  467. * instead of as the user the webserver is running as. On servers where the
  468. * webserver user is itself the owner of the Drupal files, the administrator
  469. * will not be prompted for SSH or FTP credentials (note that these server
  470. * setups are common on shared hosting, but are inherently insecure).
  471. *
  472. * Some sites might wish to disable the above functionality, and only update
  473. * the code directly via SSH or FTP themselves. This setting completely
  474. * disables all functionality related to these authorized file operations.
  475. *
  476. * @see https://www.drupal.org/node/244924
  477. *
  478. * Remove the leading hash signs to disable.
  479. */
  480. # $settings['allow_authorize_operations'] = FALSE;
  481. /**
  482. * Default mode for directories and files written by Drupal.
  483. *
  484. * Value should be in PHP Octal Notation, with leading zero.
  485. */
  486. # $settings['file_chmod_directory'] = 0775;
  487. # $settings['file_chmod_file'] = 0664;
  488. /**
  489. * Optimized assets path:
  490. *
  491. * A local file system path where optimized assets will be stored. This directory
  492. * must exist and be writable by Drupal. This directory must be relative to
  493. * the Drupal installation directory and be accessible over the web.
  494. */
  495. # $settings['file_assets_path'] = 'sites/default/files';
  496. /**
  497. * Public file base URL:
  498. *
  499. * An alternative base URL to be used for serving public files. This must
  500. * include any leading directory path.
  501. *
  502. * A different value from the domain used by Drupal to be used for accessing
  503. * public files. This can be used for a simple CDN integration, or to improve
  504. * security by serving user-uploaded files from a different domain or subdomain
  505. * pointing to the same server. Do not include a trailing slash.
  506. */
  507. # $settings['file_public_base_url'] = 'http://downloads.example.com/files';
  508. /**
  509. * Public file path:
  510. *
  511. * A local file system path where public files will be stored. This directory
  512. * must exist and be writable by Drupal. This directory must be relative to
  513. * the Drupal installation directory and be accessible over the web.
  514. */
  515. # $settings['file_public_path'] = 'sites/default/files';
  516. /**
  517. * Additional public file schemes:
  518. *
  519. * Public schemes are URI schemes that allow download access to all users for
  520. * all files within that scheme.
  521. *
  522. * The "public" scheme is always public, and the "private" scheme is always
  523. * private, but other schemes, such as "https", "s3", "example", or others,
  524. * can be either public or private depending on the site. By default, they're
  525. * private, and access to individual files is controlled via
  526. * hook_file_download().
  527. *
  528. * Typically, if a scheme should be public, a module makes it public by
  529. * implementing hook_file_download(), and granting access to all users for all
  530. * files. This could be either the same module that provides the stream wrapper
  531. * for the scheme, or a different module that decides to make the scheme
  532. * public. However, in cases where a site needs to make a scheme public, but
  533. * is unable to add code in a module to do so, the scheme may be added to this
  534. * variable, the result of which is that system_file_download() grants public
  535. * access to all files within that scheme.
  536. */
  537. # $settings['file_additional_public_schemes'] = ['example'];
  538. /**
  539. * File schemes whose paths should not be normalized:
  540. *
  541. * Normally, Drupal normalizes '/./' and '/../' segments in file URIs in order
  542. * to prevent unintended file access. For example, 'private://css/../image.png'
  543. * is normalized to 'private://image.png' before checking access to the file.
  544. *
  545. * On Windows, Drupal also replaces '\' with '/' in URIs for the local
  546. * filesystem.
  547. *
  548. * If file URIs with one or more scheme should not be normalized like this, then
  549. * list the schemes here. For example, if 'porcelain://china/./plate.png' should
  550. * not be normalized to 'porcelain://china/plate.png', then add 'porcelain' to
  551. * this array. In this case, make sure that the module providing the 'porcelain'
  552. * scheme does not allow unintended file access when using '/../' to move up the
  553. * directory tree.
  554. */
  555. # $settings['file_sa_core_2023_005_schemes'] = ['porcelain'];
  556. /**
  557. * Configuration for phpinfo() admin status report.
  558. *
  559. * Drupal's admin UI includes a report at admin/reports/status/php which shows
  560. * the output of phpinfo(). The full output can contain sensitive information
  561. * so by default Drupal removes some sections.
  562. *
  563. * This behavior can be configured by setting this variable to a different
  564. * value corresponding to the flags parameter of phpinfo().
  565. *
  566. * If you need to expose more information in the report - for example to debug a
  567. * problem - consider doing so temporarily.
  568. *
  569. * @see https://www.php.net/manual/function.phpinfo.php
  570. */
  571. # $settings['sa_core_2023_004_phpinfo_flags'] = ~ (INFO_VARIABLES | INFO_ENVIRONMENT);
  572. /**
  573. * Private file path:
  574. *
  575. * A local file system path where private files will be stored. This directory
  576. * must be absolute, outside of the Drupal installation directory and not
  577. * accessible over the web.
  578. *
  579. * Note: Caches need to be cleared when this value is changed to make the
  580. * private:// stream wrapper available to the system.
  581. *
  582. * See https://www.drupal.org/documentation/modules/file for more information
  583. * about securing private files.
  584. */
  585. # $settings['file_private_path'] = '';
  586. /**
  587. * Temporary file path:
  588. *
  589. * A local file system path where temporary files will be stored. This directory
  590. * must be absolute, outside of the Drupal installation directory and not
  591. * accessible over the web.
  592. *
  593. * If this is not set, the default for the operating system will be used.
  594. *
  595. * @see \Drupal\Component\FileSystem\FileSystem::getOsTemporaryDirectory()
  596. */
  597. # $settings['file_temp_path'] = '/tmp';
  598. /**
  599. * Session write interval:
  600. *
  601. * Set the minimum interval between each session write to database.
  602. * For performance reasons it defaults to 180.
  603. */
  604. # $settings['session_write_interval'] = 180;
  605. /**
  606. * String overrides:
  607. *
  608. * To override specific strings on your site with or without enabling the Locale
  609. * module, add an entry to this list. This functionality allows you to change
  610. * a small number of your site's default English language interface strings.
  611. *
  612. * Remove the leading hash signs to enable.
  613. *
  614. * The "en" part of the variable name, is dynamic and can be any langcode of
  615. * any added language. (eg locale_custom_strings_de for german).
  616. */
  617. # $settings['locale_custom_strings_en'][''] = [
  618. # 'Home' => 'Front page',
  619. # '@count min' => '@count minutes',
  620. # ];
  621. /**
  622. * A custom theme for the offline page:
  623. *
  624. * This applies when the site is explicitly set to maintenance mode through the
  625. * administration page or when the database is inactive due to an error.
  626. * The template file should also be copied into the theme. It is located inside
  627. * 'core/modules/system/templates/maintenance-page.html.twig'.
  628. *
  629. * Note: This setting does not apply to installation and update pages.
  630. */
  631. # $settings['maintenance_theme'] = 'claro';
  632. /**
  633. * PHP settings:
  634. *
  635. * To see what PHP settings are possible, including whether they can be set at
  636. * runtime (by using ini_set()), read the PHP documentation:
  637. * http://php.net/manual/ini.list.php
  638. * See \Drupal\Core\DrupalKernel::bootEnvironment() for required runtime
  639. * settings and the .htaccess file for non-runtime settings.
  640. * Settings defined there should not be duplicated here so as to avoid conflict
  641. * issues.
  642. */
  643. /**
  644. * If you encounter a situation where users post a large amount of text, and
  645. * the result is stripped out upon viewing but can still be edited, Drupal's
  646. * output filter may not have sufficient memory to process it. If you
  647. * experience this issue, you may wish to uncomment the following two lines
  648. * and increase the limits of these variables. For more information, see
  649. * http://php.net/manual/pcre.configuration.php.
  650. */
  651. # ini_set('pcre.backtrack_limit', 200000);
  652. # ini_set('pcre.recursion_limit', 200000);
  653. /**
  654. * Configuration overrides.
  655. *
  656. * To globally override specific configuration values for this site,
  657. * set them here. You usually don't need to use this feature. This is
  658. * useful in a configuration file for a vhost or directory, rather than
  659. * the default settings.php.
  660. *
  661. * Note that any values you provide in these variable overrides will not be
  662. * viewable from the Drupal administration interface. The administration
  663. * interface displays the values stored in configuration so that you can stage
  664. * changes to other environments that don't have the overrides.
  665. *
  666. * There are particular configuration values that are risky to override. For
  667. * example, overriding the list of installed modules in 'core.extension' is not
  668. * supported as module install or uninstall has not occurred. Other examples
  669. * include field storage configuration, because it has effects on database
  670. * structure, and 'core.menu.static_menu_link_overrides' since this is cached in
  671. * a way that is not config override aware. Also, note that changing
  672. * configuration values in settings.php will not fire any of the configuration
  673. * change events.
  674. */
  675. # $config['system.site']['name'] = 'My Drupal site';
  676. # $config['user.settings']['anonymous'] = 'Visitor';
  677. /**
  678. * Load services definition file.
  679. */
  680. $settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml';
  681. /**
  682. * Override the default service container class.
  683. *
  684. * This is useful for example to trace the service container for performance
  685. * tracking purposes, for testing a service container with an error condition or
  686. * to test a service container that throws an exception.
  687. */
  688. # $settings['container_base_class'] = '\Drupal\Core\DependencyInjection\Container';
  689. /**
  690. * Override the default yaml parser class.
  691. *
  692. * Provide a fully qualified class name here if you would like to provide an
  693. * alternate implementation YAML parser. The class must implement the
  694. * \Drupal\Component\Serialization\SerializationInterface interface.
  695. */
  696. # $settings['yaml_parser_class'] = NULL;
  697. /**
  698. * Trusted host configuration.
  699. *
  700. * Drupal core can use the Symfony trusted host mechanism to prevent HTTP Host
  701. * header spoofing.
  702. *
  703. * To enable the trusted host mechanism, you enable your allowable hosts
  704. * in $settings['trusted_host_patterns']. This should be an array of regular
  705. * expression patterns, without delimiters, representing the hosts you would
  706. * like to allow.
  707. *
  708. * For example:
  709. * @code
  710. * $settings['trusted_host_patterns'] = [
  711. * '^www\.example\.com$',
  712. * ];
  713. * @endcode
  714. * will allow the site to only run from www.example.com.
  715. *
  716. * If you are running multisite, or if you are running your site from
  717. * different domain names (eg, you don't redirect http://www.example.com to
  718. * http://example.com), you should specify all of the host patterns that are
  719. * allowed by your site.
  720. *
  721. * For example:
  722. * @code
  723. * $settings['trusted_host_patterns'] = [
  724. * '^example\.com$',
  725. * '^.+\.example\.com$',
  726. * '^example\.org$',
  727. * '^.+\.example\.org$',
  728. * ];
  729. * @endcode
  730. * will allow the site to run off of all variants of example.com and
  731. * example.org, with all subdomains included.
  732. *
  733. * @see https://www.drupal.org/docs/installing-drupal/trusted-host-settings
  734. */
  735. # $settings['trusted_host_patterns'] = [];
  736. /**
  737. * The default list of directories that will be ignored by Drupal's file API.
  738. *
  739. * By default ignore node_modules and bower_components folders to avoid issues
  740. * with common frontend tools and recursive scanning of directories looking for
  741. * extensions.
  742. *
  743. * @see \Drupal\Core\File\FileSystemInterface::scanDirectory()
  744. * @see \Drupal\Core\Extension\ExtensionDiscovery::scanDirectory()
  745. */
  746. $settings['file_scan_ignore_directories'] = [
  747. 'node_modules',
  748. 'bower_components',
  749. ];
  750. /**
  751. * The default number of entities to update in a batch process.
  752. *
  753. * This is used by update and post-update functions that need to go through and
  754. * change all the entities on a site, so it is useful to increase this number
  755. * if your hosting configuration (i.e. RAM allocation, CPU speed) allows for a
  756. * larger number of entities to be processed in a single batch run.
  757. */
  758. $settings['entity_update_batch_size'] = 50;
  759. /**
  760. * Entity update backup.
  761. *
  762. * This is used to inform the entity storage handler that the backup tables as
  763. * well as the original entity type and field storage definitions should be
  764. * retained after a successful entity update process.
  765. */
  766. $settings['entity_update_backup'] = TRUE;
  767. /**
  768. * Node migration type.
  769. *
  770. * This is used to force the migration system to use the classic node migrations
  771. * instead of the default complete node migrations. The migration system will
  772. * use the classic node migration only if there are existing migrate_map tables
  773. * for the classic node migrations and they contain data. These tables may not
  774. * exist if you are developing custom migrations and do not want to use the
  775. * complete node migrations. Set this to TRUE to force the use of the classic
  776. * node migrations.
  777. */
  778. $settings['migrate_node_migrate_type_classic'] = FALSE;
  779. /**
  780. * The default settings for migration sources.
  781. *
  782. * These settings are used as the default settings on the Credential form at
  783. * /upgrade/credentials.
  784. *
  785. * - migrate_source_version - The version of the source database. This can be
  786. * '6' or '7'. Defaults to '7'.
  787. * - migrate_source_connection - The key in the $databases array for the source
  788. * site.
  789. * - migrate_file_public_path - The location of the source Drupal 6 or Drupal 7
  790. * public files. This can be a local file directory containing the source
  791. * Drupal 6 or Drupal 7 site (e.g /var/www/docroot), or the site address
  792. * (e.g http://example.com).
  793. * - migrate_file_private_path - The location of the source Drupal 7 private
  794. * files. This can be a local file directory containing the source Drupal 7
  795. * site (e.g /var/www/docroot), or empty to use the same value as Public
  796. * files directory.
  797. *
  798. * Sample configuration for a drupal 6 source site with the source files in a
  799. * local directory.
  800. *
  801. * @code
  802. * $settings['migrate_source_version'] = '6';
  803. * $settings['migrate_source_connection'] = 'migrate';
  804. * $settings['migrate_file_public_path'] = '/var/www/drupal6';
  805. * @endcode
  806. *
  807. * Sample configuration for a drupal 7 source site with public source files on
  808. * the source site and the private files in a local directory.
  809. *
  810. * @code
  811. * $settings['migrate_source_version'] = '7';
  812. * $settings['migrate_source_connection'] = 'migrate';
  813. * $settings['migrate_file_public_path'] = 'https://drupal7.com';
  814. * $settings['migrate_file_private_path'] = '/var/www/drupal7';
  815. * @endcode
  816. */
  817. # $settings['migrate_source_connection'] = '';
  818. # $settings['migrate_source_version'] = '';
  819. # $settings['migrate_file_public_path'] = '';
  820. # $settings['migrate_file_private_path'] = '';
  821. /**
  822. * Load local development override configuration, if available.
  823. *
  824. * Create a settings.local.php file to override variables on secondary (staging,
  825. * development, etc.) installations of this site.
  826. *
  827. * Typical uses of settings.local.php include:
  828. * - Disabling caching.
  829. * - Disabling JavaScript/CSS compression.
  830. * - Rerouting outgoing emails.
  831. *
  832. * Keep this code block at the end of this file to take full effect.
  833. */
  834. #
  835. # if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
  836. # include $app_root . '/' . $site_path . '/settings.local.php';
  837. # }