github.com/drud/ddev@v1.21.5-alpha1.0.20230226034409-94fcc4b94453/pkg/ddevapp/drupal/drupal8/settings.php (about)

     1  <?php
     2  
     3  // @codingStandardsIgnoreFile
     4  
     5  /**
     6   * @file
     7   * Drupal site-specific configuration file.
     8   *
     9   * IMPORTANT NOTE:
    10   * This file may have been set to read-only by the Drupal installation program.
    11   * If you make changes to this file, be sure to protect it again after making
    12   * your modifications. Failure to remove write permissions to this file is a
    13   * security risk.
    14   *
    15   * In order to use the selection rules below the multisite aliasing file named
    16   * sites/sites.php must be present. Its optional settings will be loaded, and
    17   * the aliases in the array $sites will override the default directory rules
    18   * below. See sites/example.sites.php for more information about aliases.
    19   *
    20   * The configuration directory will be discovered by stripping the website's
    21   * hostname from left to right and pathname from right to left. The first
    22   * configuration file found will be used and any others will be ignored. If no
    23   * other configuration file is found then the default configuration file at
    24   * 'sites/default' will be used.
    25   *
    26   * For example, for a fictitious site installed at
    27   * https://www.drupal.org:8080/mysite/test/, the 'settings.php' file is searched
    28   * for in the following directories:
    29   *
    30   * - sites/8080.www.drupal.org.mysite.test
    31   * - sites/www.drupal.org.mysite.test
    32   * - sites/drupal.org.mysite.test
    33   * - sites/org.mysite.test
    34   *
    35   * - sites/8080.www.drupal.org.mysite
    36   * - sites/www.drupal.org.mysite
    37   * - sites/drupal.org.mysite
    38   * - sites/org.mysite
    39   *
    40   * - sites/8080.www.drupal.org
    41   * - sites/www.drupal.org
    42   * - sites/drupal.org
    43   * - sites/org
    44   *
    45   * - sites/default
    46   *
    47   * Note that if you are installing on a non-standard port number, prefix the
    48   * hostname with that number. For example,
    49   * https://www.drupal.org:8080/mysite/test/ could be loaded from
    50   * sites/8080.www.drupal.org.mysite.test/.
    51   *
    52   * @see example.sites.php
    53   * @see \Drupal\Core\DrupalKernel::getSitePath()
    54   *
    55   * In addition to customizing application settings through variables in
    56   * settings.php, you can create a services.yml file in the same directory to
    57   * register custom, site-specific service definitions and/or swap out default
    58   * implementations with custom ones.
    59   */
    60  
    61  /**
    62   * Database settings:
    63   *
    64   * The $databases array specifies the database connection or
    65   * connections that Drupal may use.  Drupal is able to connect
    66   * to multiple databases, including multiple types of databases,
    67   * during the same request.
    68   *
    69   * One example of the simplest connection array is shown below. To use the
    70   * sample settings, copy and uncomment the code below between the @code and
    71   * @endcode lines and paste it after the $databases declaration. You will need
    72   * to replace the database username and password and possibly the host and port
    73   * with the appropriate credentials for your database system.
    74   *
    75   * The next section describes how to customize the $databases array for more
    76   * specific needs.
    77   *
    78   * @code
    79   * $databases['default']['default'] = [
    80   *   'database' => 'databasename',
    81   *   'username' => 'sqlusername',
    82   *   'password' => 'sqlpassword',
    83   *   'host' => 'localhost',
    84   *   'port' => '3306',
    85   *   'driver' => 'mysql',
    86   *   'prefix' => '',
    87   *   'collation' => 'utf8mb4_general_ci',
    88   * ];
    89   * @endcode
    90   */
    91  $databases = [];
    92  
    93  /**
    94   * Customizing database settings.
    95   *
    96   * Many of the values of the $databases array can be customized for your
    97   * particular database system. Refer to the sample in the section above as a
    98   * starting point.
    99   *
   100   * The "driver" property indicates what Drupal database driver the
   101   * connection should use.  This is usually the same as the name of the
   102   * database type, such as mysql or sqlite, but not always.  The other
   103   * properties will vary depending on the driver.  For SQLite, you must
   104   * specify a database file name in a directory that is writable by the
   105   * webserver.  For most other drivers, you must specify a
   106   * username, password, host, and database name.
   107   *
   108   * Drupal core implements drivers for mysql, pgsql, and sqlite. Other drivers
   109   * can be provided by contributed or custom modules. To use a contributed or
   110   * custom driver, the "namespace" property must be set to the namespace of the
   111   * driver. The code in this namespace must be autoloadable prior to connecting
   112   * to the database, and therefore, prior to when module root namespaces are
   113   * added to the autoloader. To add the driver's namespace to the autoloader,
   114   * set the "autoload" property to the PSR-4 base directory of the driver's
   115   * namespace. This is optional for projects managed with Composer if the
   116   * driver's namespace is in Composer's autoloader.
   117   *
   118   * Transaction support is enabled by default for all drivers that support it,
   119   * including MySQL. To explicitly disable it, set the 'transactions' key to
   120   * FALSE.
   121   * Note that some configurations of MySQL, such as the MyISAM engine, don't
   122   * support it and will proceed silently even if enabled. If you experience
   123   * transaction related crashes with such configuration, set the 'transactions'
   124   * key to FALSE.
   125   *
   126   * For each database, you may optionally specify multiple "target" databases.
   127   * A target database allows Drupal to try to send certain queries to a
   128   * different database if it can but fall back to the default connection if not.
   129   * That is useful for primary/replica replication, as Drupal may try to connect
   130   * to a replica server when appropriate and if one is not available will simply
   131   * fall back to the single primary server (The terms primary/replica are
   132   * traditionally referred to as master/slave in database server documentation).
   133   *
   134   * The general format for the $databases array is as follows:
   135   * @code
   136   * $databases['default']['default'] = $info_array;
   137   * $databases['default']['replica'][] = $info_array;
   138   * $databases['default']['replica'][] = $info_array;
   139   * $databases['extra']['default'] = $info_array;
   140   * @endcode
   141   *
   142   * In the above example, $info_array is an array of settings described above.
   143   * The first line sets a "default" database that has one primary database
   144   * (the second level default).  The second and third lines create an array
   145   * of potential replica databases.  Drupal will select one at random for a given
   146   * request as needed.  The fourth line creates a new database with a name of
   147   * "extra".
   148   *
   149   * You can optionally set prefixes for some or all database table names
   150   * by using the 'prefix' setting. If a prefix is specified, the table
   151   * name will be prepended with its value. Be sure to use valid database
   152   * characters only, usually alphanumeric and underscore. If no prefixes
   153   * are desired, leave it as an empty string ''.
   154   *
   155   * To have all database names prefixed, set 'prefix' as a string:
   156   * @code
   157   *   'prefix' => 'main_',
   158   * @endcode
   159   *
   160   * Per-table prefixes are deprecated as of Drupal 8.2, and will be removed in
   161   * Drupal 9.0. After that, only a single prefix for all tables will be
   162   * supported.
   163   *
   164   * To provide prefixes for specific tables, set 'prefix' as an array.
   165   * The array's keys are the table names and the values are the prefixes.
   166   * The 'default' element is mandatory and holds the prefix for any tables
   167   * not specified elsewhere in the array. Example:
   168   * @code
   169   *   'prefix' => [
   170   *     'default'   => 'main_',
   171   *     'users'     => 'shared_',
   172   *     'sessions'  => 'shared_',
   173   *     'role'      => 'shared_',
   174   *     'authmap'   => 'shared_',
   175   *   ],
   176   * @endcode
   177   * You can also use a reference to a schema/database as a prefix. This may be
   178   * useful if your Drupal installation exists in a schema that is not the default
   179   * or you want to access several databases from the same code base at the same
   180   * time.
   181   * Example:
   182   * @code
   183   *   'prefix' => [
   184   *     'default'   => 'main.',
   185   *     'users'     => 'shared.',
   186   *     'sessions'  => 'shared.',
   187   *     'role'      => 'shared.',
   188   *     'authmap'   => 'shared.',
   189   *   ];
   190   * @endcode
   191   * NOTE: MySQL and SQLite's definition of a schema is a database.
   192   *
   193   * Advanced users can add or override initial commands to execute when
   194   * connecting to the database server, as well as PDO connection settings. For
   195   * example, to enable MySQL SELECT queries to exceed the max_join_size system
   196   * variable, and to reduce the database connection timeout to 5 seconds:
   197   * @code
   198   * $databases['default']['default'] = [
   199   *   'init_commands' => [
   200   *     'big_selects' => 'SET SQL_BIG_SELECTS=1',
   201   *   ],
   202   *   'pdo' => [
   203   *     PDO::ATTR_TIMEOUT => 5,
   204   *   ],
   205   * ];
   206   * @endcode
   207   *
   208   * WARNING: The above defaults are designed for database portability. Changing
   209   * them may cause unexpected behavior, including potential data loss. See
   210   * https://www.drupal.org/developing/api/database/configuration for more
   211   * information on these defaults and the potential issues.
   212   *
   213   * More details can be found in the constructor methods for each driver:
   214   * - \Drupal\Core\Database\Driver\mysql\Connection::__construct()
   215   * - \Drupal\Core\Database\Driver\pgsql\Connection::__construct()
   216   * - \Drupal\Core\Database\Driver\sqlite\Connection::__construct()
   217   *
   218   * Sample Database configuration format for PostgreSQL (pgsql):
   219   * @code
   220   *   $databases['default']['default'] = [
   221   *     'driver' => 'pgsql',
   222   *     'database' => 'databasename',
   223   *     'username' => 'sqlusername',
   224   *     'password' => 'sqlpassword',
   225   *     'host' => 'localhost',
   226   *     'prefix' => '',
   227   *   ];
   228   * @endcode
   229   *
   230   * Sample Database configuration format for SQLite (sqlite):
   231   * @code
   232   *   $databases['default']['default'] = [
   233   *     'driver' => 'sqlite',
   234   *     'database' => '/path/to/databasefilename',
   235   *   ];
   236   * @endcode
   237   *
   238   * Sample Database configuration format for a driver in a contributed module:
   239   * @code
   240   *   $databases['default']['default'] = [
   241   *     'driver' => 'mydriver',
   242   *     'namespace' => 'Drupal\mymodule\Driver\Database\mydriver',
   243   *     'autoload' => 'modules/mymodule/src/Driver/Database/mydriver/',
   244   *     'database' => 'databasename',
   245   *     'username' => 'sqlusername',
   246   *     'password' => 'sqlpassword',
   247   *     'host' => 'localhost',
   248   *     'prefix' => '',
   249   *   ];
   250   * @endcode
   251   */
   252  
   253  /**
   254   * Location of the site configuration files.
   255   *
   256   * The $settings['config_sync_directory'] specifies the location of file system
   257   * directory used for syncing configuration data. On install, the directory is
   258   * created. This is used for configuration imports.
   259   *
   260   * The default location for this directory is inside a randomly-named
   261   * directory in the public files path. The setting below allows you to set
   262   * its location.
   263   */
   264  # $settings['config_sync_directory'] = '/directory/outside/webroot';
   265  
   266  /**
   267   * Settings:
   268   *
   269   * $settings contains environment-specific configuration, such as the files
   270   * directory and reverse proxy address, and temporary configuration, such as
   271   * security overrides.
   272   *
   273   * @see \Drupal\Core\Site\Settings::get()
   274   */
   275  
   276  /**
   277   * Salt for one-time login links, cancel links, form tokens, etc.
   278   *
   279   * This variable will be set to a random value by the installer. All one-time
   280   * login links will be invalidated if the value is changed. Note that if your
   281   * site is deployed on a cluster of web servers, you must ensure that this
   282   * variable has the same value on each server.
   283   *
   284   * For enhanced security, you may set this variable to the contents of a file
   285   * outside your document root; you should also ensure that this file is not
   286   * stored with backups of your database.
   287   *
   288   * Example:
   289   * @code
   290   *   $settings['hash_salt'] = file_get_contents('/home/example/salt.txt');
   291   * @endcode
   292   */
   293  $settings['hash_salt'] = '';
   294  
   295  /**
   296   * Deployment identifier.
   297   *
   298   * Drupal's dependency injection container will be automatically invalidated and
   299   * rebuilt when the Drupal core version changes. When updating contributed or
   300   * custom code that changes the container, changing this identifier will also
   301   * allow the container to be invalidated as soon as code is deployed.
   302   */
   303  # $settings['deployment_identifier'] = \Drupal::VERSION;
   304  
   305  /**
   306   * Access control for update.php script.
   307   *
   308   * If you are updating your Drupal installation using the update.php script but
   309   * are not logged in using either an account with the "Administer software
   310   * updates" permission or the site maintenance account (the account that was
   311   * created during installation), you will need to modify the access check
   312   * statement below. Change the FALSE to a TRUE to disable the access check.
   313   * After finishing the upgrade, be sure to open this file again and change the
   314   * TRUE back to a FALSE!
   315   */
   316  $settings['update_free_access'] = FALSE;
   317  
   318  /**
   319   * External access proxy settings:
   320   *
   321   * If your site must access the Internet via a web proxy then you can enter the
   322   * proxy settings here. Set the full URL of the proxy, including the port, in
   323   * variables:
   324   * - $settings['http_client_config']['proxy']['http']: The proxy URL for HTTP
   325   *   requests.
   326   * - $settings['http_client_config']['proxy']['https']: The proxy URL for HTTPS
   327   *   requests.
   328   * You can pass in the user name and password for basic authentication in the
   329   * URLs in these settings.
   330   *
   331   * You can also define an array of host names that can be accessed directly,
   332   * bypassing the proxy, in $settings['http_client_config']['proxy']['no'].
   333   */
   334  # $settings['http_client_config']['proxy']['http'] = 'http://proxy_user:proxy_pass@example.com:8080';
   335  # $settings['http_client_config']['proxy']['https'] = 'http://proxy_user:proxy_pass@example.com:8080';
   336  # $settings['http_client_config']['proxy']['no'] = ['127.0.0.1', 'localhost'];
   337  
   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  /**
   371   * Specify every reverse proxy IP address in your environment.
   372   * This setting is required if $settings['reverse_proxy'] is TRUE.
   373   */
   374  # $settings['reverse_proxy_addresses'] = ['a.b.c.d', ...];
   375  
   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_ALL
   383   * - \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
   384   *
   385   * Note the default value of
   386   * @code
   387   * \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL | \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
   388   * @endcode
   389   * is not secure by default. The value should be set to only the specific
   390   * headers the reverse proxy uses. For example:
   391   * @code
   392   * \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL
   393   * @endcode
   394   * This would trust the following headers:
   395   * - X_FORWARDED_FOR
   396   * - X_FORWARDED_HOST
   397   * - X_FORWARDED_PROTO
   398   * - X_FORWARDED_PORT
   399   *
   400   * @see \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL
   401   * @see \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED
   402   * @see \Symfony\Component\HttpFoundation\Request::setTrustedProxies
   403   */
   404  # $settings['reverse_proxy_trusted_headers'] = \Symfony\Component\HttpFoundation\Request::HEADER_X_FORWARDED_ALL | \Symfony\Component\HttpFoundation\Request::HEADER_FORWARDED;
   405  
   406  
   407  /**
   408   * Page caching:
   409   *
   410   * By default, Drupal sends a "Vary: Cookie" HTTP header for anonymous page
   411   * views. This tells a HTTP proxy that it may return a page from its local
   412   * cache without contacting the web server, if the user sends the same Cookie
   413   * header as the user who originally requested the cached page. Without "Vary:
   414   * Cookie", authenticated users would also be served the anonymous page from
   415   * the cache. If the site has mostly anonymous users except a few known
   416   * editors/administrators, the Vary header can be omitted. This allows for
   417   * better caching in HTTP proxies (including reverse proxies), i.e. even if
   418   * clients send different cookies, they still get content served from the cache.
   419   * However, authenticated users should access the site directly (i.e. not use an
   420   * HTTP proxy, and bypass the reverse proxy if one is used) in order to avoid
   421   * getting cached pages from the proxy.
   422   */
   423  # $settings['omit_vary_cookie'] = TRUE;
   424  
   425  
   426  /**
   427   * Cache TTL for client error (4xx) responses.
   428   *
   429   * Items cached per-URL tend to result in a large number of cache items, and
   430   * this can be problematic on 404 pages which by their nature are unbounded. A
   431   * fixed TTL can be set for these items, defaulting to one hour, so that cache
   432   * backends which do not support LRU can purge older entries. To disable caching
   433   * of client error responses set the value to 0. Currently applies only to
   434   * page_cache module.
   435   */
   436  # $settings['cache_ttl_4xx'] = 3600;
   437  
   438  /**
   439   * Expiration of cached forms.
   440   *
   441   * Drupal's Form API stores details of forms in a cache and these entries are
   442   * kept for at least 6 hours by default. Expired entries are cleared by cron.
   443   *
   444   * @see \Drupal\Core\Form\FormCache::setCache()
   445   */
   446  # $settings['form_cache_expiration'] = 21600;
   447  
   448  /**
   449   * Class Loader.
   450   *
   451   * If the APC extension is detected, the Symfony APC class loader is used for
   452   * performance reasons. Detection can be prevented by setting
   453   * class_loader_auto_detect to false, as in the example below.
   454   */
   455  # $settings['class_loader_auto_detect'] = FALSE;
   456  
   457  /*
   458   * If the APC extension is not detected, either because APC is missing or
   459   * because auto-detection has been disabled, auto-loading falls back to
   460   * Composer's ClassLoader, which is good for development as it does not break
   461   * when code is moved in the file system. You can also decorate the base class
   462   * loader with another cached solution than the Symfony APC class loader, as
   463   * all production sites should have a cached class loader of some sort enabled.
   464   *
   465   * To do so, you may decorate and replace the local $class_loader variable. For
   466   * example, to use Symfony's APC class loader without automatic detection,
   467   * uncomment the code below.
   468   */
   469  /*
   470  if ($settings['hash_salt']) {
   471    $prefix = 'drupal.' . hash('sha256', 'drupal.' . $settings['hash_salt']);
   472    $apc_loader = new \Symfony\Component\ClassLoader\ApcClassLoader($prefix, $class_loader);
   473    unset($prefix);
   474    $class_loader->unregister();
   475    $apc_loader->register();
   476    $class_loader = $apc_loader;
   477  }
   478  */
   479  
   480  /**
   481   * Authorized file system operations:
   482   *
   483   * The Update Manager module included with Drupal provides a mechanism for
   484   * site administrators to securely install missing updates for the site
   485   * directly through the web user interface. On securely-configured servers,
   486   * the Update manager will require the administrator to provide SSH or FTP
   487   * credentials before allowing the installation to proceed; this allows the
   488   * site to update the new files as the user who owns all the Drupal files,
   489   * instead of as the user the webserver is running as. On servers where the
   490   * webserver user is itself the owner of the Drupal files, the administrator
   491   * will not be prompted for SSH or FTP credentials (note that these server
   492   * setups are common on shared hosting, but are inherently insecure).
   493   *
   494   * Some sites might wish to disable the above functionality, and only update
   495   * the code directly via SSH or FTP themselves. This setting completely
   496   * disables all functionality related to these authorized file operations.
   497   *
   498   * @see https://www.drupal.org/node/244924
   499   *
   500   * Remove the leading hash signs to disable.
   501   */
   502  # $settings['allow_authorize_operations'] = FALSE;
   503  
   504  /**
   505   * Default mode for directories and files written by Drupal.
   506   *
   507   * Value should be in PHP Octal Notation, with leading zero.
   508   */
   509  # $settings['file_chmod_directory'] = 0775;
   510  # $settings['file_chmod_file'] = 0664;
   511  
   512  /**
   513   * Public file base URL:
   514   *
   515   * An alternative base URL to be used for serving public files. This must
   516   * include any leading directory path.
   517   *
   518   * A different value from the domain used by Drupal to be used for accessing
   519   * public files. This can be used for a simple CDN integration, or to improve
   520   * security by serving user-uploaded files from a different domain or subdomain
   521   * pointing to the same server. Do not include a trailing slash.
   522   */
   523  # $settings['file_public_base_url'] = 'http://downloads.example.com/files';
   524  
   525  /**
   526   * Public file path:
   527   *
   528   * A local file system path where public files will be stored. This directory
   529   * must exist and be writable by Drupal. This directory must be relative to
   530   * the Drupal installation directory and be accessible over the web.
   531   */
   532  # $settings['file_public_path'] = 'sites/default/files';
   533  
   534  /**
   535   * Private file path:
   536   *
   537   * A local file system path where private files will be stored. This directory
   538   * must be absolute, outside of the Drupal installation directory and not
   539   * accessible over the web.
   540   *
   541   * Note: Caches need to be cleared when this value is changed to make the
   542   * private:// stream wrapper available to the system.
   543   *
   544   * See https://www.drupal.org/documentation/modules/file for more information
   545   * about securing private files.
   546   */
   547  # $settings['file_private_path'] = '';
   548  
   549  /**
   550   * Temporary file path:
   551   *
   552   * A local file system path where temporary files will be stored. This directory
   553   * must be absolute, outside of the Drupal installation directory and not
   554   * accessible over the web.
   555   *
   556   * If this is not set, the default for the operating system will be used.
   557   *
   558   * @see \Drupal\Component\FileSystem\FileSystem::getOsTemporaryDirectory()
   559   */
   560  # $settings['file_temp_path'] = '/tmp';
   561  
   562  /**
   563   * Session write interval:
   564   *
   565   * Set the minimum interval between each session write to database.
   566   * For performance reasons it defaults to 180.
   567   */
   568  # $settings['session_write_interval'] = 180;
   569  
   570  /**
   571   * String overrides:
   572   *
   573   * To override specific strings on your site with or without enabling the Locale
   574   * module, add an entry to this list. This functionality allows you to change
   575   * a small number of your site's default English language interface strings.
   576   *
   577   * Remove the leading hash signs to enable.
   578   *
   579   * The "en" part of the variable name, is dynamic and can be any langcode of
   580   * any added language. (eg locale_custom_strings_de for german).
   581   */
   582  # $settings['locale_custom_strings_en'][''] = [
   583  #   'forum'      => 'Discussion board',
   584  #   '@count min' => '@count minutes',
   585  # ];
   586  
   587  /**
   588   * A custom theme for the offline page:
   589   *
   590   * This applies when the site is explicitly set to maintenance mode through the
   591   * administration page or when the database is inactive due to an error.
   592   * The template file should also be copied into the theme. It is located inside
   593   * 'core/modules/system/templates/maintenance-page.html.twig'.
   594   *
   595   * Note: This setting does not apply to installation and update pages.
   596   */
   597  # $settings['maintenance_theme'] = 'bartik';
   598  
   599  /**
   600   * PHP settings:
   601   *
   602   * To see what PHP settings are possible, including whether they can be set at
   603   * runtime (by using ini_set()), read the PHP documentation:
   604   * http://php.net/manual/ini.list.php
   605   * See \Drupal\Core\DrupalKernel::bootEnvironment() for required runtime
   606   * settings and the .htaccess file for non-runtime settings.
   607   * Settings defined there should not be duplicated here so as to avoid conflict
   608   * issues.
   609   */
   610  
   611  /**
   612   * If you encounter a situation where users post a large amount of text, and
   613   * the result is stripped out upon viewing but can still be edited, Drupal's
   614   * output filter may not have sufficient memory to process it.  If you
   615   * experience this issue, you may wish to uncomment the following two lines
   616   * and increase the limits of these variables.  For more information, see
   617   * http://php.net/manual/pcre.configuration.php.
   618   */
   619  # ini_set('pcre.backtrack_limit', 200000);
   620  # ini_set('pcre.recursion_limit', 200000);
   621  
   622  /**
   623   * Configuration overrides.
   624   *
   625   * To globally override specific configuration values for this site,
   626   * set them here. You usually don't need to use this feature. This is
   627   * useful in a configuration file for a vhost or directory, rather than
   628   * the default settings.php.
   629   *
   630   * Note that any values you provide in these variable overrides will not be
   631   * viewable from the Drupal administration interface. The administration
   632   * interface displays the values stored in configuration so that you can stage
   633   * changes to other environments that don't have the overrides.
   634   *
   635   * There are particular configuration values that are risky to override. For
   636   * example, overriding the list of installed modules in 'core.extension' is not
   637   * supported as module install or uninstall has not occurred. Other examples
   638   * include field storage configuration, because it has effects on database
   639   * structure, and 'core.menu.static_menu_link_overrides' since this is cached in
   640   * a way that is not config override aware. Also, note that changing
   641   * configuration values in settings.php will not fire any of the configuration
   642   * change events.
   643   */
   644  # $config['system.site']['name'] = 'My Drupal site';
   645  # $config['user.settings']['anonymous'] = 'Visitor';
   646  
   647  /**
   648   * Fast 404 pages:
   649   *
   650   * Drupal can generate fully themed 404 pages. However, some of these responses
   651   * are for images or other resource files that are not displayed to the user.
   652   * This can waste bandwidth, and also generate server load.
   653   *
   654   * The options below return a simple, fast 404 page for URLs matching a
   655   * specific pattern:
   656   * - $config['system.performance']['fast_404']['exclude_paths']: A regular
   657   *   expression to match paths to exclude, such as images generated by image
   658   *   styles, or dynamically-resized images. The default pattern provided below
   659   *   also excludes the private file system. If you need to add more paths, you
   660   *   can add '|path' to the expression.
   661   * - $config['system.performance']['fast_404']['paths']: A regular expression to
   662   *   match paths that should return a simple 404 page, rather than the fully
   663   *   themed 404 page. If you don't have any aliases ending in htm or html you
   664   *   can add '|s?html?' to the expression.
   665   * - $config['system.performance']['fast_404']['html']: The html to return for
   666   *   simple 404 pages.
   667   *
   668   * Remove the leading hash signs if you would like to alter this functionality.
   669   */
   670  # $config['system.performance']['fast_404']['exclude_paths'] = '/\/(?:styles)|(?:system\/files)\//';
   671  # $config['system.performance']['fast_404']['paths'] = '/\.(?:txt|png|gif|jpe?g|css|js|ico|swf|flv|cgi|bat|pl|dll|exe|asp)$/i';
   672  # $config['system.performance']['fast_404']['html'] = '<!DOCTYPE html><html><head><title>404 Not Found</title></head><body><h1>Not Found</h1><p>The requested URL "@path" was not found on this server.</p></body></html>';
   673  
   674  /**
   675   * Load services definition file.
   676   */
   677  $settings['container_yamls'][] = $app_root . '/' . $site_path . '/services.yml';
   678  
   679  /**
   680   * Override the default service container class.
   681   *
   682   * This is useful for example to trace the service container for performance
   683   * tracking purposes, for testing a service container with an error condition or
   684   * to test a service container that throws an exception.
   685   */
   686  # $settings['container_base_class'] = '\Drupal\Core\DependencyInjection\Container';
   687  
   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  /**
   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  
   734  /**
   735   * The default list of directories that will be ignored by Drupal's file API.
   736   *
   737   * By default ignore node_modules and bower_components folders to avoid issues
   738   * with common frontend tools and recursive scanning of directories looking for
   739   * extensions.
   740   *
   741   * @see \Drupal\Core\File\FileSystemInterface::scanDirectory()
   742   * @see \Drupal\Core\Extension\ExtensionDiscovery::scanDirectory()
   743   */
   744  $settings['file_scan_ignore_directories'] = [
   745    'node_modules',
   746    'bower_components',
   747  ];
   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  /**
   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  /**
   769   * Node migration type.
   770   *
   771   * This is used to force the migration system to use the classic node migrations
   772   * instead of the default complete node migrations. The migration system will
   773   * use the classic node migration only if there are existing migrate_map tables
   774   * for the classic node migrations and they contain data. These tables may not
   775   * exist if you are developing custom migrations and do not want to use the
   776   * complete node migrations. Set this to TRUE to force the use of the classic
   777   * node migrations.
   778   */
   779  $settings['migrate_node_migrate_type_classic'] = FALSE;
   780  
   781  // Automatically generated include for settings managed by ddev.
   782  if (file_exists(__DIR__ . '/settings.ddev.php') && getenv('IS_DDEV_PROJECT') == 'true') {
   783    include __DIR__ . '/settings.ddev.php';
   784  }
   785  
   786  /**
   787   * Load local development override configuration, if available.
   788   *
   789   * Use settings.local.php to override variables on secondary (staging,
   790   * development, etc) installations of this site. Typically used to disable
   791   * caching, JavaScript/CSS compression, re-routing of outgoing emails, and
   792   * other things that should not happen on development and testing sites.
   793   *
   794   * Keep this code block at the end of this file to take full effect.
   795   */
   796  #
   797  # if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
   798  #   include $app_root . '/' . $site_path . '/settings.local.php';
   799  # }