default.settings.php

You are here

  1. 7 sites/default/default.settings.php
  2. 6 sites/default/default.settings.php
  3. 8 sites/default/default.settings.php

Drupal site-specific configuration file.

IMPORTANT NOTE: This file may have been set to read-only by the Drupal installation program. If you make changes to this file, be sure to protect it again after making your modifications. Failure to remove write permissions to this file is a security risk.

The configuration file to be loaded is based upon the rules below.

The configuration directory will be discovered by stripping the website's hostname from left to right and pathname from right to left. The first configuration file found will be used and any others will be ignored. If no other configuration file is found then the default configuration file at 'sites/default' will be used.

For example, for a fictitious site installed at http://www.drupal.org/mysite/test/, the 'settings.php' is searched in the following directories:

1. sites/www.drupal.org.mysite.test 2. sites/drupal.org.mysite.test 3. sites/org.mysite.test

4. sites/www.drupal.org.mysite 5. sites/drupal.org.mysite 6. sites/org.mysite

7. sites/www.drupal.org 8. sites/drupal.org 9. sites/org

10. sites/default

If you are installing on a non-standard port number, prefix the hostname with that number. For example, http://www.drupal.org:8080/mysite/test/ could be loaded from sites/8080.www.drupal.org.mysite.test/.

File

sites/default/default.settings.php
View source
  1. <?php
  2. /**
  3. * @file
  4. * Drupal site-specific configuration file.
  5. *
  6. * IMPORTANT NOTE:
  7. * This file may have been set to read-only by the Drupal installation
  8. * program. If you make changes to this file, be sure to protect it again
  9. * after making your modifications. Failure to remove write permissions
  10. * to this file is a security risk.
  11. *
  12. * The configuration file to be loaded is based upon the rules below.
  13. *
  14. * The configuration directory will be discovered by stripping the
  15. * website's hostname from left to right and pathname from right to
  16. * left. The first configuration file found will be used and any
  17. * others will be ignored. If no other configuration file is found
  18. * then the default configuration file at 'sites/default' will be used.
  19. *
  20. * For example, for a fictitious site installed at
  21. * http://www.drupal.org/mysite/test/, the 'settings.php'
  22. * is searched in the following directories:
  23. *
  24. * 1. sites/www.drupal.org.mysite.test
  25. * 2. sites/drupal.org.mysite.test
  26. * 3. sites/org.mysite.test
  27. *
  28. * 4. sites/www.drupal.org.mysite
  29. * 5. sites/drupal.org.mysite
  30. * 6. sites/org.mysite
  31. *
  32. * 7. sites/www.drupal.org
  33. * 8. sites/drupal.org
  34. * 9. sites/org
  35. *
  36. * 10. sites/default
  37. *
  38. * If you are installing on a non-standard port number, prefix the
  39. * hostname with that number. For example,
  40. * http://www.drupal.org:8080/mysite/test/ could be loaded from
  41. * sites/8080.www.drupal.org.mysite.test/.
  42. */
  43. /**
  44. * Database settings:
  45. *
  46. * Note that the $db_url variable gets parsed using PHP's built-in
  47. * URL parser (i.e. using the "parse_url()" function) so make sure
  48. * not to confuse the parser. If your username, password
  49. * or database name contain characters used to delineate
  50. * $db_url parts, you can escape them via URI hex encodings:
  51. *
  52. * : = %3a / = %2f @ = %40
  53. * + = %2b ( = %28 ) = %29
  54. * ? = %3f = = %3d & = %26
  55. *
  56. * To specify multiple connections to be used in your site (i.e. for
  57. * complex custom modules) you can also specify an associative array
  58. * of $db_url variables with the 'default' element used until otherwise
  59. * requested.
  60. *
  61. * You can optionally set prefixes for some or all database table names
  62. * by using the $db_prefix setting. If a prefix is specified, the table
  63. * name will be prepended with its value. Be sure to use valid database
  64. * characters only, usually alphanumeric and underscore. If no prefixes
  65. * are desired, leave it as an empty string ''.
  66. *
  67. * To have all database names prefixed, set $db_prefix as a string:
  68. *
  69. * $db_prefix = 'main_';
  70. *
  71. * To provide prefixes for specific tables, set $db_prefix as an array.
  72. * The array's keys are the table names and the values are the prefixes.
  73. * The 'default' element holds the prefix for any tables not specified
  74. * elsewhere in the array. Example:
  75. *
  76. * $db_prefix = array(
  77. * 'default' => 'main_',
  78. * 'users' => 'shared_',
  79. * 'sessions' => 'shared_',
  80. * 'role' => 'shared_',
  81. * 'authmap' => 'shared_',
  82. * );
  83. *
  84. * Database URL format:
  85. * $db_url = 'mysql://username:password@localhost/databasename';
  86. * $db_url = 'mysqli://username:password@localhost/databasename';
  87. * $db_url = 'pgsql://username:password@localhost/databasename';
  88. */
  89. $db_url = 'mysql://username:password@localhost/databasename';
  90. $db_prefix = '';
  91. /**
  92. * Database default collation.
  93. *
  94. * All data stored in Drupal is in UTF-8. Certain databases, such as MySQL,
  95. * support different algorithms for comparing, indexing, and sorting characters;
  96. * a so called "collation". The default collation of a database normally works
  97. * for many use-cases, but depending on the language(s) of the stored data, it
  98. * may be necessary to use a different collation.
  99. * Important:
  100. * - Only set or change this value BEFORE installing Drupal, unless you know
  101. * what you are doing.
  102. * - All database tables and columns should be in the same collation. Otherwise,
  103. * string comparisons performed for table JOINs will be significantly slower.
  104. * - Especially when storing data in German or Russian on MySQL 5.1+, you want
  105. * to use the 'utf8_unicode_ci' collation instead.
  106. *
  107. * @see http://drupal.org/node/772678
  108. */
  109. # $db_collation = 'utf8_general_ci';
  110. /**
  111. * Access control for update.php script
  112. *
  113. * If you are updating your Drupal installation using the update.php script
  114. * being not logged in as administrator, you will need to modify the access
  115. * check statement below. Change the FALSE to a TRUE to disable the access
  116. * check. After finishing the upgrade, be sure to open this file again
  117. * and change the TRUE back to a FALSE!
  118. */
  119. $update_free_access = FALSE;
  120. /**
  121. * Base URL (optional).
  122. *
  123. * If you are experiencing issues with different site domains,
  124. * uncomment the Base URL statement below (remove the leading hash sign)
  125. * and fill in the absolute URL to your Drupal installation.
  126. *
  127. * You might also want to force users to use a given domain.
  128. * See the .htaccess file for more information.
  129. *
  130. * Examples:
  131. * $base_url = 'http://www.example.com';
  132. * $base_url = 'http://www.example.com:8888';
  133. * $base_url = 'http://www.example.com/drupal';
  134. * $base_url = 'https://www.example.com:8888/drupal';
  135. *
  136. * It is not allowed to have a trailing slash; Drupal will add it
  137. * for you.
  138. */
  139. # $base_url = 'http://www.example.com'; // NO trailing slash!
  140. /**
  141. * PHP settings:
  142. *
  143. * To see what PHP settings are possible, including whether they can
  144. * be set at runtime (ie., when ini_set() occurs), read the PHP
  145. * documentation at http://www.php.net/manual/en/ini.php#ini.list
  146. * and take a look at the .htaccess file to see which non-runtime
  147. * settings are used there. Settings defined here should not be
  148. * duplicated there so as to avoid conflict issues.
  149. */
  150. ini_set('arg_separator.output', '&amp;');
  151. ini_set('magic_quotes_runtime', 0);
  152. ini_set('magic_quotes_sybase', 0);
  153. ini_set('session.cache_expire', 200000);
  154. ini_set('session.cache_limiter', 'none');
  155. ini_set('session.cookie_lifetime', 2000000);
  156. ini_set('session.gc_maxlifetime', 200000);
  157. ini_set('session.save_handler', 'user');
  158. ini_set('session.use_cookies', 1);
  159. ini_set('session.use_only_cookies', 1);
  160. ini_set('session.use_trans_sid', 0);
  161. ini_set('url_rewriter.tags', '');
  162. /**
  163. * If you encounter a situation where users post a large amount of text, and
  164. * the result is stripped out upon viewing but can still be edited, Drupal's
  165. * output filter may not have sufficient memory to process it. If you
  166. * experience this issue, you may wish to uncomment the following two lines
  167. * and increase the limits of these variables. For more information, see
  168. * http://php.net/manual/en/pcre.configuration.php.
  169. */
  170. # ini_set('pcre.backtrack_limit', 200000);
  171. # ini_set('pcre.recursion_limit', 200000);
  172. /**
  173. * Drupal automatically generates a unique session cookie name for each site
  174. * based on on its full domain name. If you have multiple domains pointing at
  175. * the same Drupal site, you can either redirect them all to a single domain
  176. * (see comment in .htaccess), or uncomment the line below and specify their
  177. * shared base domain. Doing so assures that users remain logged in as they
  178. * cross between your various domains.
  179. */
  180. # $cookie_domain = 'example.com';
  181. /**
  182. * Variable overrides:
  183. *
  184. * To override specific entries in the 'variable' table for this site,
  185. * set them here. You usually don't need to use this feature. This is
  186. * useful in a configuration file for a vhost or directory, rather than
  187. * the default settings.php. Any configuration setting from the 'variable'
  188. * table can be given a new value. Note that any values you provide in
  189. * these variable overrides will not be modifiable from the Drupal
  190. * administration interface.
  191. *
  192. * Remove the leading hash signs to enable.
  193. */
  194. # $conf = array(
  195. # 'site_name' => 'My Drupal site',
  196. # 'theme_default' => 'minnelli',
  197. # 'anonymous' => 'Visitor',
  198. /**
  199. * A custom theme can be set for the off-line page. This applies when the site
  200. * is explicitly set to off-line mode through the administration page or when
  201. * the database is inactive due to an error. It can be set through the
  202. * 'maintenance_theme' key. The template file should also be copied into the
  203. * theme. It is located inside 'modules/system/maintenance-page.tpl.php'.
  204. * Note: This setting does not apply to installation and update pages.
  205. */
  206. # 'maintenance_theme' => 'minnelli',
  207. /**
  208. * reverse_proxy accepts a boolean value.
  209. *
  210. * Enable this setting to determine the correct IP address of the remote
  211. * client by examining information stored in the X-Forwarded-For headers.
  212. * X-Forwarded-For headers are a standard mechanism for identifying client
  213. * systems connecting through a reverse proxy server, such as Squid or
  214. * Pound. Reverse proxy servers are often used to enhance the performance
  215. * of heavily visited sites and may also provide other site caching,
  216. * security or encryption benefits. If this Drupal installation operates
  217. * behind a reverse proxy, this setting should be enabled so that correct
  218. * IP address information is captured in Drupal's session management,
  219. * logging, statistics and access management systems; if you are unsure
  220. * about this setting, do not have a reverse proxy, or Drupal operates in
  221. * a shared hosting environment, this setting should be set to disabled.
  222. */
  223. # 'reverse_proxy' => TRUE,
  224. /**
  225. * reverse_proxy accepts an array of IP addresses.
  226. *
  227. * Each element of this array is the IP address of any of your reverse
  228. * proxies. Filling this array Drupal will trust the information stored
  229. * in the X-Forwarded-For headers only if Remote IP address is one of
  230. * these, that is the request reaches the web server from one of your
  231. * reverse proxies. Otherwise, the client could directly connect to
  232. * your web server spoofing the X-Forwarded-For headers.
  233. */
  234. # 'reverse_proxy_addresses' => array('a.b.c.d', ...),
  235. # );
  236. /**
  237. * String overrides:
  238. *
  239. * To override specific strings on your site with or without enabling locale
  240. * module, add an entry to this list. This functionality allows you to change
  241. * a small number of your site's default English language interface strings.
  242. *
  243. * Remove the leading hash signs to enable.
  244. */
  245. # $conf['locale_custom_strings_en'] = array(
  246. # 'forum' => 'Discussion board',
  247. # '@count min' => '@count minutes',
  248. # );