2001-03-10 11:07:52 +00:00
|
|
|
<?php
|
2001-10-20 18:57:09 +00:00
|
|
|
// $Id$
|
2000-05-18 19:52:00 +00:00
|
|
|
|
2004-08-21 06:42:38 +00:00
|
|
|
/**
|
|
|
|
* @file
|
|
|
|
* Drupal site-specific configuration file.
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
2006-12-30 15:28:33 +00:00
|
|
|
* 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.
|
|
|
|
*
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* The configuration file to be loaded is based upon the rules below.
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
|
|
|
* The configuration directory will be discovered by stripping the
|
|
|
|
* website's hostname from left to right and pathname from right to
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* left. The first configuration file found will be used and any
|
|
|
|
* others will be ignored. If no other configuration file is found
|
2005-02-18 18:44:33 +00:00
|
|
|
* then the default configuration file at 'sites/default' will be used.
|
|
|
|
*
|
2005-03-31 21:18:08 +00:00
|
|
|
* For example, for a fictitious site installed at
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* http://www.drupal.org/mysite/test/, the 'settings.php'
|
|
|
|
* is searched in the following directories:
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
|
|
|
* 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
|
2005-09-23 08:47:13 +00:00
|
|
|
*
|
2006-04-22 11:04:19 +00:00
|
|
|
* If you are installing on a non-standard port number, prefix the
|
2006-05-07 00:08:36 +00:00
|
|
|
* hostname with that number. For example,
|
2006-04-24 19:25:37 +00:00
|
|
|
* http://www.drupal.org:8080/mysite/test/ could be loaded from
|
2006-04-22 11:04:19 +00:00
|
|
|
* sites/8080.www.drupal.org.mysite.test/.
|
2004-08-21 06:42:38 +00:00
|
|
|
*/
|
|
|
|
|
2005-02-18 18:44:33 +00:00
|
|
|
/**
|
|
|
|
* Database settings:
|
|
|
|
*
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* Note that the $db_url variable gets parsed using PHP's built-in
|
|
|
|
* URL parser (i.e. using the "parse_url()" function) so make sure
|
2005-04-14 18:34:31 +00:00
|
|
|
* not to confuse the parser. If your username, password
|
|
|
|
* or database name contain characters used to delineate
|
2005-04-08 14:14:24 +00:00
|
|
|
* $db_url parts, you can escape them via URI hex encodings:
|
|
|
|
*
|
|
|
|
* : = %3a / = %2f @ = %40
|
|
|
|
* + = %2b ( = %28 ) = %29
|
|
|
|
* ? = %3f = = %3d & = %26
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* To specify multiple connections to be used in your site (i.e. for
|
|
|
|
* complex custom modules) you can also specify an associative array
|
|
|
|
* of $db_url variables with the 'default' element used until otherwise
|
|
|
|
* requested.
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
2005-04-08 14:14:24 +00:00
|
|
|
* You can optionally set prefixes for some or all database table names
|
|
|
|
* by using the $db_prefix setting. If a prefix is specified, the table
|
|
|
|
* name will be prepended with its value. Be sure to use valid database
|
|
|
|
* characters only, usually alphanumeric and underscore. If no prefixes
|
|
|
|
* are desired, leave it as an empty string ''.
|
|
|
|
*
|
|
|
|
* To have all database names prefixed, set $db_prefix as a string:
|
|
|
|
*
|
|
|
|
* $db_prefix = 'main_';
|
|
|
|
*
|
|
|
|
* To provide prefixes for specific tables, set $db_prefix as an array.
|
|
|
|
* The array's keys are the table names and the values are the prefixes.
|
|
|
|
* The 'default' element holds the prefix for any tables not specified
|
|
|
|
* elsewhere in the array. Example:
|
|
|
|
*
|
|
|
|
* $db_prefix = array(
|
|
|
|
* 'default' => 'main_',
|
|
|
|
* 'users' => 'shared_',
|
|
|
|
* 'sessions' => 'shared_',
|
|
|
|
* 'role' => 'shared_',
|
|
|
|
* 'authmap' => 'shared_',
|
|
|
|
* 'sequences' => 'shared_',
|
|
|
|
* );
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* Database URL format:
|
2005-11-26 19:54:24 +00:00
|
|
|
* $db_url = 'mysql://username:password@localhost/databasename';
|
|
|
|
* $db_url = 'mysqli://username:password@localhost/databasename';
|
|
|
|
* $db_url = 'pgsql://username:password@localhost/databasename';
|
2005-02-18 18:44:33 +00:00
|
|
|
*/
|
2007-03-26 06:01:58 +00:00
|
|
|
$db_url = 'mysql://username:password@localhost/databasename';
|
2005-02-18 18:44:33 +00:00
|
|
|
$db_prefix = '';
|
2003-07-10 17:46:44 +00:00
|
|
|
|
2007-08-28 11:42:56 +00:00
|
|
|
/**
|
|
|
|
* Access control for update.php script
|
|
|
|
*
|
|
|
|
* If you are updating your Drupal installation using the update.php script
|
|
|
|
* being not logged in as administrator, you will need to modify the access
|
|
|
|
* check statement below. Change the FALSE to a TRUE to disable the access
|
|
|
|
* check. After finishing the upgrade, be sure to open this file again
|
|
|
|
* and change the TRUE back to a FALSE!
|
|
|
|
*/
|
|
|
|
$update_free_access = FALSE;
|
|
|
|
|
2005-02-18 18:44:33 +00:00
|
|
|
/**
|
2006-04-12 08:42:47 +00:00
|
|
|
* Base URL (optional).
|
2005-02-18 18:44:33 +00:00
|
|
|
*
|
2006-04-12 08:42:47 +00:00
|
|
|
* If you are experiencing issues with different site domains,
|
|
|
|
* uncomment the Base URL statement below (remove the leading hash sign)
|
|
|
|
* and fill in the URL to your Drupal installation.
|
|
|
|
*
|
|
|
|
* You might also want to force users to use a given domain.
|
|
|
|
* See the .htaccess file for more information.
|
2005-11-26 19:54:24 +00:00
|
|
|
*
|
|
|
|
* Examples:
|
2005-11-29 15:17:58 +00:00
|
|
|
* $base_url = 'http://www.example.com';
|
|
|
|
* $base_url = 'http://www.example.com:8888';
|
|
|
|
* $base_url = 'http://www.example.com/drupal';
|
|
|
|
* $base_url = 'https://www.example.com:8888/drupal';
|
2006-01-08 12:10:12 +00:00
|
|
|
*
|
|
|
|
* It is not allowed to have a trailing slash; Drupal will add it
|
|
|
|
* for you.
|
2005-02-18 18:44:33 +00:00
|
|
|
*/
|
2007-03-28 14:08:23 +00:00
|
|
|
# $base_url = 'http://www.example.com'; // NO trailing slash!
|
2003-02-14 19:52:45 +00:00
|
|
|
|
2005-02-18 18:44:33 +00:00
|
|
|
/**
|
|
|
|
* PHP settings:
|
|
|
|
*
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* To see what PHP settings are possible, including whether they can
|
|
|
|
* be set at runtime (ie., when ini_set() occurs), read the PHP
|
|
|
|
* documentation at http://www.php.net/manual/en/ini.php#ini.list
|
|
|
|
* and take a look at the .htaccess file to see which non-runtime
|
- More improvements by Morbus, Goba, TDobes et al:
Per TDobes' comments:
* INSTALL.txt corrected to use 4.3.3, not 4.33.
* .htaccess: removed allow_call_time_pass_reference. two confirmations that a) the setting was wrong in the first place, b) there were no adverse affects for the incorrect setting, c) the PHP docs say it is deprecated.
* .htaccess: removed short_open_tag. Running grep -r "<? " * across the entire directory tree of both core and contributions only brought up contributions and no core. I agree that the fuller form is better. The following contributions will need to be updated: modules/edit_template/edit_template.module, sandbox/garym/themes/marvin_2k/templates/page.tpl.php, sandbox/killes/compare.php, sandbox/paolino/import/click.php, themes/spreadfirefox/block.tpl.php. For error's sake, I also did a manual verification for "<?" (no space) across core and came up against nothing in addition to the above contribs.
Per Goba's comments:
* .htaccess: Moved session.auto_start back.
* sites/default/settings.php: Removed track_vars.
Per mailing list comments:
* INSTALL.txt: Added text about the files/ directory, creating it, and permissions.
* INSTALL.txt: Added an example of why Drupal requires cron (the search.module) in an attempt to justify why a crontab is a good, nay, required step.
And my own further analities:
* .htaccess: cleaned up some whitespace valleys (i hate 'em, hate 'em!) and fixed a few stray colons.
* settings.php: minor whitespace error.
2005-03-15 21:07:49 +00:00
|
|
|
* settings are used there. Settings defined here should not be
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* duplicated there so as to avoid conflict issues.
|
2005-02-18 18:44:33 +00:00
|
|
|
*/
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
ini_set('arg_separator.output', '&');
|
|
|
|
ini_set('magic_quotes_runtime', 0);
|
|
|
|
ini_set('magic_quotes_sybase', 0);
|
2005-02-21 03:55:06 +00:00
|
|
|
ini_set('session.cache_expire', 200000);
|
|
|
|
ini_set('session.cache_limiter', 'none');
|
|
|
|
ini_set('session.cookie_lifetime', 2000000);
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
ini_set('session.gc_maxlifetime', 200000);
|
2005-02-21 03:55:06 +00:00
|
|
|
ini_set('session.save_handler', 'user');
|
2005-02-18 18:44:33 +00:00
|
|
|
ini_set('session.use_only_cookies', 1);
|
2005-02-21 03:55:06 +00:00
|
|
|
ini_set('session.use_trans_sid', 0);
|
2005-10-06 08:51:05 +00:00
|
|
|
ini_set('url_rewriter.tags', '');
|
2001-10-23 20:26:02 +00:00
|
|
|
|
2007-01-13 10:55:15 +00:00
|
|
|
/**
|
2007-04-30 14:37:36 +00:00
|
|
|
* Drupal automatically generates a unique session cookie name for each site
|
|
|
|
* based on on its full domain name. If you have multiple domains pointing at
|
2007-06-17 10:45:35 +00:00
|
|
|
* the same Drupal site, you can either redirect them all to a single domain
|
|
|
|
* (see comment in .htaccess), or uncomment the line below and specify their
|
|
|
|
* shared base domain. Doing so assures that users remain logged in as they
|
2007-04-30 14:37:36 +00:00
|
|
|
* cross between your various domains.
|
2007-06-17 10:45:35 +00:00
|
|
|
*/
|
|
|
|
# $cookie_domain = 'example.com';
|
2007-02-11 10:26:33 +00:00
|
|
|
|
2005-02-18 18:44:33 +00:00
|
|
|
/**
|
|
|
|
* Variable overrides:
|
|
|
|
*
|
- Patch #18641 by Morbus:
# The INSTALL.txt no longer contains the SERVER CONFIGURATION block. These settings are now hardcoded into sites/default/settings.php, and are merely scary technical junk here.
# The INSTALL.txt has been updated with the latest system requirements. A whole sentence was struck regarding differing versions of PHP for the OSs.
# The INSTALL.txt contains URLs to MySQL and PostgreSQL. If we're including the URL for PHP in the same sentence, then there's no reason why we wouldn't include them for the database engines. What are the minimal requirements for the RDBMS? Those should be included here too.
# The INSTALL.txt's OPTIONAL COMPONENTS has renamed to OPTIONAL REQUIREMENTS. The only difference between the meaning is the amount of user confusion.
# The INSTALL.txt has a new CONTENTS OF THIS FILE, in hopes that people will more immediately notice that there are upgrade instructions at the bottom.
# The INSTALL.txt had some potentially confusing lines adjusted, including further clarifications, standarding to "userid" (instead of using both userid and username interchangebly) and so on.
# I've moved most of .htaccess php_value's to the ini_set system for /sites/. There are a few reasons for this, chiefly that it is centralizing all the PHP setting modifications to one place. But, this also clears up a few initial configuration issues: first, the user doesn't have to worry about whether they have Apache 1 or 2, and whether they need to change an IfModule line. Also, the running assumption is that these php_value's are /going to work by default anyways/, when the INSTALL.txt suggests otherwise (under OPTIONAL REQUIREMENTS, it talks about "the ability to use local .htaccess files", which suggests that "local .htaccess files" INCLUDING "mod_rewrite" are entirely optional.) Some variables, however, had to remain in .htaccess because they can't be overridden at runtime, but the amount was so small that duplicating them for both Apache 1 and Apache 2 possibilities is no longer a prohibitive concern.
# There are two variables in .htaccess that I'm concerned about: track_vars, and allow_call_time_pass_reference. track_vars appears to be no longer necessary (as of 4.0.3, track_vars is always on, and my setting it here had no impact on the results of a phpinfo), and allow_call_time_pass_reference seems, at least here, to ONLY WORK if the .htaccess value is set to "1", and not "On" - meaning that Drupal installations are currently working correctly with its default value (off). According to the PHP docs, this feature is now deprecated. However, since both of these variables require further investigation, track_vars has been moved to settings.php, and allow_call_time_pass_reference has been "fixed" to a 1 (not 'On').
# Along with the changes above for sites/default/settings.php, I've also removed the spacing indent in the documentation, as well as many a few grammatical/punctuation changes here and there. I don't think the leading spacing is "right" according to the style guidelines, but maybe there's a special need for it. Correct me if I'm wrong.
2005-03-12 10:51:32 +00:00
|
|
|
* To override specific entries in the 'variable' table for this site,
|
|
|
|
* set them here. You usually don't need to use this feature. This is
|
|
|
|
* useful in a configuration file for a vhost or directory, rather than
|
|
|
|
* the default settings.php. Any configuration setting from the 'variable'
|
2007-12-19 15:22:27 +00:00
|
|
|
* table can be given a new value. Note that any values you provide in
|
2007-12-20 09:35:10 +00:00
|
|
|
* these variable overrides will not be modifiable from the Drupal
|
2007-12-19 13:42:42 +00:00
|
|
|
* administration interface.
|
2006-04-12 08:42:47 +00:00
|
|
|
*
|
|
|
|
* Remove the leading hash signs to enable.
|
2005-02-18 18:44:33 +00:00
|
|
|
*/
|
2006-04-12 08:42:47 +00:00
|
|
|
# $conf = array(
|
|
|
|
# 'site_name' => 'My Drupal site',
|
2006-11-08 19:24:11 +00:00
|
|
|
# 'theme_default' => 'minnelli',
|
2006-06-22 09:54:48 +00:00
|
|
|
# 'anonymous' => 'Visitor',
|
2007-11-30 12:19:10 +00:00
|
|
|
/**
|
|
|
|
* A custom theme can be set for the off-line page. This applies when the site
|
|
|
|
* is explicitly set to off-line mode through the administration page or when
|
|
|
|
* the database is inactive due to an error. It can be set through the
|
|
|
|
* 'maintenance_theme' key. The template file should also be copied into the
|
|
|
|
* theme. It is located inside 'modules/system/maintenance-page.tpl.php'.
|
|
|
|
* Note: This setting does not apply to installation and update pages.
|
|
|
|
*/
|
|
|
|
# 'maintenance_theme' => 'minnelli',
|
2007-11-26 08:06:52 +00:00
|
|
|
/**
|
|
|
|
* reverse_proxy accepts a boolean value.
|
|
|
|
*
|
|
|
|
* Enable this setting to determine the correct IP address of the remote
|
|
|
|
* client by examining information stored in the X-Forwarded-For headers.
|
|
|
|
* X-Forwarded-For headers are a standard mechanism for identifying client
|
|
|
|
* systems connecting through a reverse proxy server, such as Squid or
|
|
|
|
* Pound. Reverse proxy servers are often used to enhance the performance
|
|
|
|
* of heavily visited sites and may also provide other site caching,
|
|
|
|
* security or encryption benefits. If this Drupal installation operates
|
|
|
|
* behind a reverse proxy, this setting should be enabled so that correct
|
|
|
|
* IP address information is captured in Drupal's session management,
|
|
|
|
* logging, statistics and access management systems; if you are unsure
|
|
|
|
* about this setting, do not have a reverse proxy, or Drupal operates in
|
|
|
|
* a shared hosting environment, this setting should be set to disabled.
|
|
|
|
*/
|
|
|
|
# 'reverse_proxy' => TRUE,
|
|
|
|
/**
|
|
|
|
* reverse_proxy accepts an array of IP addresses.
|
|
|
|
*
|
|
|
|
* Each element of this array is the IP address of any of your reverse
|
|
|
|
* proxies. Filling this array Drupal will trust the information stored
|
|
|
|
* in the X-Forwarded-For headers only if Remote IP address is one of
|
|
|
|
* these, that is the request reaches the web server from one of your
|
|
|
|
* reverse proxies. Otherwise, the client could directly connect to
|
|
|
|
* your web server spoofing the X-Forwarded-For headers.
|
|
|
|
*/
|
|
|
|
# 'reverse_proxy_addresses' => array('a.b.c.d', ...),
|
2006-04-12 08:42:47 +00:00
|
|
|
# );
|
2004-11-15 11:32:13 +00:00
|
|
|
|
2007-05-04 08:32:00 +00:00
|
|
|
/**
|
|
|
|
* String overrides:
|
|
|
|
*
|
|
|
|
* To override specific strings on your site with or without enabling locale
|
|
|
|
* module, add an entry to this list. This functionality allows you to change
|
|
|
|
* a small number of your site's default English language interface strings.
|
|
|
|
*
|
|
|
|
* Remove the leading hash signs to enable.
|
|
|
|
*/
|
|
|
|
# $conf['locale_custom_strings_en'] = array(
|
|
|
|
# 'forum' => 'Discussion board',
|
|
|
|
# '@count min' => '@count minutes',
|
|
|
|
# );
|