rfc:newinis
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
rfc:newinis [2009/02/17 07:03] – Updated production ini with recommended changes. ericstewart | rfc:newinis [2017/09/22 13:28] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Request for Comments: New INI's for PHP ====== | ====== Request for Comments: New INI's for PHP ====== | ||
- | * Version: 1.0 | + | * Version: 1.2 |
- | * Date: 2009-02-09 | + | * Date: 2009-02-22 |
* Author: Eric Lee Stewart < | * Author: Eric Lee Stewart < | ||
- | * Status: | + | * Status: |
* First Published at: http:// | * First Published at: http:// | ||
+ | |||
===== Introduction ===== | ===== Introduction ===== | ||
Line 28: | Line 29: | ||
; PHP attempts to find and load this configuration from a number of locations. | ; PHP attempts to find and load this configuration from a number of locations. | ||
- | ; The following is a summary of it' | + | ; The following is a summary of its search order: |
; 1. SAPI module specific location. | ; 1. SAPI module specific location. | ||
; 2. The PHPRC environment variable. (As of PHP 5.2.0) | ; 2. The PHPRC environment variable. (As of PHP 5.2.0) | ||
Line 35: | Line 36: | ||
; 5. The web server' | ; 5. The web server' | ||
; (otherwise in Windows) | ; (otherwise in Windows) | ||
- | ; 6. Windows | + | ; 6. The directory |
- | ; compile time option. | + | ; Windows directory (C:\windows or C:\winnt) |
; See the PHP docs for more specific information. | ; See the PHP docs for more specific information. | ||
; http:// | ; http:// | ||
Line 83: | Line 84: | ||
; php.ini-production contains settings which hold security, performance and | ; php.ini-production contains settings which hold security, performance and | ||
- | ; best practices at it' | + | ; best practices at its core. But please be aware, these settings may break |
; compatibility with older or less security conscience applications. We | ; compatibility with older or less security conscience applications. We | ||
; recommending using the production ini in production and testing environments. | ; recommending using the production ini in production and testing environments. | ||
- | ; php.ini-development is very similar to it' | + | ; php.ini-development is very similar to its production variant, except it's |
; much more verbose when it comes to errors. We recommending using the | ; much more verbose when it comes to errors. We recommending using the | ||
; development version only in development environments as errors shown to | ; development version only in development environments as errors shown to | ||
Line 103: | Line 104: | ||
; | ; | ||
; | ; | ||
- | ; | + | ; |
; display_errors | ; display_errors | ||
Line 118: | Line 119: | ||
; | ; | ||
; | ; | ||
- | ; | + | ; |
; html_errors | ; html_errors | ||
Line 250: | Line 251: | ||
; data to the client. If your application' | ; data to the client. If your application' | ||
; will send that data in chunks of roughly the size you specify. | ; will send that data in chunks of roughly the size you specify. | ||
- | ; Turning on this setting and managing | + | ; Turning on this setting and managing |
; interesting side-effects depending on your application and web server. | ; interesting side-effects depending on your application and web server. | ||
; You may be able to send headers and cookies after you've already sent output | ; You may be able to send headers and cookies after you've already sent output | ||
Line 262: | Line 263: | ||
; On = Enabled and buffer is unlimited. (Use with caution) | ; On = Enabled and buffer is unlimited. (Use with caution) | ||
; Off = Disabled | ; Off = Disabled | ||
- | ; | + | ; |
; Default Value: Off | ; Default Value: Off | ||
; Development Value: 4096 | ; Development Value: 4096 | ||
Line 336: | Line 337: | ||
; Default Value: On (Suppress warnings) | ; Default Value: On (Suppress warnings) | ||
; Development Value: Off (Issue warnings) | ; Development Value: Off (Issue warnings) | ||
- | ; Production Value: | + | ; Production Value: |
; http:// | ; http:// | ||
- | allow_call_time_pass_reference = On | + | allow_call_time_pass_reference = Off |
; Safe Mode | ; Safe Mode | ||
Line 514: | Line 515: | ||
; Default Value: E_ALL & ~E_NOTICE | ; Default Value: E_ALL & ~E_NOTICE | ||
; Development Value: E_ALL | E_STRICT | ; Development Value: E_ALL | E_STRICT | ||
- | ; Production Value: E_ALL | ~E_DEPRECATED | + | ; Production Value: E_ALL & ~E_DEPRECATED |
; http:// | ; http:// | ||
- | error_reporting = E_ALL | ~E_DEPRECATED | + | error_reporting = E_ALL & ~E_DEPRECATED |
; This directive controls whether or not and where PHP will output errors, | ; This directive controls whether or not and where PHP will output errors, | ||
Line 587: | Line 588: | ||
; Development Value: On | ; Development Value: On | ||
; Production Value: Off | ; Production Value: Off | ||
- | http:// | + | ; http:// |
track_errors = Off | track_errors = Off | ||
Line 811: | Line 812: | ||
; Directory in which the loadable extensions (modules) reside. | ; Directory in which the loadable extensions (modules) reside. | ||
; http:// | ; http:// | ||
- | extension_dir = " | + | ; extension_dir = " |
; Whether or not to enable the dl() function. | ; Whether or not to enable the dl() function. | ||
Line 817: | Line 818: | ||
; disabled on them. | ; disabled on them. | ||
; http:// | ; http:// | ||
- | enable_dl = On | + | enable_dl = Off |
; cgi.force_redirect is necessary to provide security running PHP as a CGI under | ; cgi.force_redirect is necessary to provide security running PHP as a CGI under | ||
Line 840: | Line 841: | ||
; previous behaviour was to set PATH_TRANSLATED to SCRIPT_FILENAME, | ; previous behaviour was to set PATH_TRANSLATED to SCRIPT_FILENAME, | ||
; what PATH_INFO is. For more information on PATH_INFO, see the cgi specs. | ; what PATH_INFO is. For more information on PATH_INFO, see the cgi specs. | ||
- | ; this to 1 will cause PHP CGI to fix it' | + | ; this to 1 will cause PHP CGI to fix its paths to conform to the spec. A setting |
; of zero causes PHP to behave as before. | ; of zero causes PHP to behave as before. | ||
; to use SCRIPT_FILENAME rather than PATH_TRANSLATED. | ; to use SCRIPT_FILENAME rather than PATH_TRANSLATED. | ||
Line 933: | Line 934: | ||
; | ; | ||
; | ; | ||
- | ; Note that it should be the name of the module only; no directory information | + | ; ... or with a path: |
- | ; needs to go here. | + | ; |
- | ; extension_dir directive above. | + | ; extension=/ |
+ | ; | ||
+ | ; If you only provide | ||
+ | ; default extension directory. | ||
; | ; | ||
; Windows Extensions | ; Windows Extensions | ||
Line 1191: | Line 1195: | ||
; Maximum number of links. | ; Maximum number of links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.max_links = -1 | mysqli.max_links = -1 | ||
Line 1198: | Line 1202: | ||
; compile-time value defined MYSQL_PORT (in that order). | ; compile-time value defined MYSQL_PORT (in that order). | ||
; at MYSQL_PORT. | ; at MYSQL_PORT. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_port = 3306 | mysqli.default_port = 3306 | ||
; Default socket name for local MySQL connects. | ; Default socket name for local MySQL connects. | ||
; MySQL defaults. | ; MySQL defaults. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_socket = | mysqli.default_socket = | ||
; Default host for mysql_connect() (doesn' | ; Default host for mysql_connect() (doesn' | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_host = | mysqli.default_host = | ||
; Default user for mysql_connect() (doesn' | ; Default user for mysql_connect() (doesn' | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_user = | mysqli.default_user = | ||
Line 1219: | Line 1223: | ||
; and reveal this password! | ; and reveal this password! | ||
; file will be able to reveal the password as well. | ; file will be able to reveal the password as well. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_pw = | mysqli.default_pw = | ||
Line 1229: | Line 1233: | ||
; Connection: Enables privileged connections using external | ; Connection: Enables privileged connections using external | ||
; credentials (OCI_SYSOPER, | ; credentials (OCI_SYSOPER, | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Connection: The maximum number of persistent OCI8 connections per | ; Connection: The maximum number of persistent OCI8 connections per | ||
; process. Using -1 means no limit. | ; process. Using -1 means no limit. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1240: | Line 1244: | ||
; maintain an idle persistent connection. Using -1 means idle | ; maintain an idle persistent connection. Using -1 means idle | ||
; persistent connections will be maintained forever. | ; persistent connections will be maintained forever. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1247: | Line 1251: | ||
; set to 0, each oci_pconnect() will cause a ping. Using -1 disables | ; set to 0, each oci_pconnect() will cause a ping. Using -1 disables | ||
; pings completely. | ; pings completely. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1265: | Line 1269: | ||
; Tuning: This option enables statement caching, and specifies how | ; Tuning: This option enables statement caching, and specifies how | ||
; many statements to cache. Using 0 disables statement caching. | ; many statements to cache. Using 0 disables statement caching. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Tuning: Enables statement prefetching and sets the default number of | ; Tuning: Enables statement prefetching and sets the default number of | ||
; rows that will be fetched automatically after statement execution. | ; rows that will be fetched automatically after statement execution. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Compatibility. Using On means oci_close() will not close | ; Compatibility. Using On means oci_close() will not close | ||
; oci_connect() and oci_new_connect() connections. | ; oci_connect() and oci_new_connect() connections. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[PostgresSQL] | [PostgresSQL] | ||
; Allow or prevent persistent links. | ; Allow or prevent persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.allow_persistent = On | pgsql.allow_persistent = On | ||
; Detect broken persistent links always with pg_pconnect(). | ; Detect broken persistent links always with pg_pconnect(). | ||
; Auto reset feature requires a little overheads. | ; Auto reset feature requires a little overheads. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.auto_reset_persistent = Off | pgsql.auto_reset_persistent = Off | ||
; Maximum number of persistent links. | ; Maximum number of persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.max_persistent = -1 | pgsql.max_persistent = -1 | ||
; Maximum number of links (persistent+non persistent). | ; Maximum number of links (persistent+non persistent). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.max_links = -1 | pgsql.max_links = -1 | ||
; Ignore PostgreSQL backends Notice message or not. | ; Ignore PostgreSQL backends Notice message or not. | ||
; Notice message logging require a little overheads. | ; Notice message logging require a little overheads. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.ignore_notice = 0 | pgsql.ignore_notice = 0 | ||
; Log PostgreSQL backends Noitce message or not. | ; Log PostgreSQL backends Noitce message or not. | ||
; Unless pgsql.ignore_notice=0, | ; Unless pgsql.ignore_notice=0, | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.log_notice = 0 | pgsql.log_notice = 0 | ||
[Sybase-CT] | [Sybase-CT] | ||
; Allow or prevent persistent links. | ; Allow or prevent persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.allow_persistent = On | sybct.allow_persistent = On | ||
; Maximum number of persistent links. | ; Maximum number of persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.max_persistent = -1 | sybct.max_persistent = -1 | ||
; Maximum number of links (persistent + non-persistent). | ; Maximum number of links (persistent + non-persistent). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.max_links = -1 | sybct.max_links = -1 | ||
; Minimum server message severity to display. | ; Minimum server message severity to display. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.min_server_severity = 10 | sybct.min_server_severity = 10 | ||
; Minimum client message severity to display. | ; Minimum client message severity to display. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.min_client_severity = 10 | sybct.min_client_severity = 10 | ||
; Set per-context timeout | ; Set per-context timeout | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1335: | Line 1339: | ||
[bcmath] | [bcmath] | ||
; Number of decimal digits for all bcmath functions. | ; Number of decimal digits for all bcmath functions. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
bcmath.scale = 0 | bcmath.scale = 0 | ||
[browscap] | [browscap] | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
;browscap = extra/ | ;browscap = extra/ | ||
[Session] | [Session] | ||
; Handler used to store/ | ; Handler used to store/ | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.save_handler = files | session.save_handler = files | ||
Line 1373: | Line 1377: | ||
; where MODE is the octal representation of the mode. Note that this | ; where MODE is the octal representation of the mode. Note that this | ||
; does not overwrite the process' | ; does not overwrite the process' | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Whether to use cookies. | ; Whether to use cookies. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.use_cookies = 1 | session.use_cookies = 1 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1391: | Line 1395: | ||
; Name of the session (used as cookie name). | ; Name of the session (used as cookie name). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.name = PHPSESSID | session.name = PHPSESSID | ||
; Initialize session on request startup. | ; Initialize session on request startup. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.auto_start = 0 | session.auto_start = 0 | ||
; Lifetime in seconds of cookie or, if 0, until browser is restarted. | ; Lifetime in seconds of cookie or, if 0, until browser is restarted. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_lifetime = 0 | session.cookie_lifetime = 0 | ||
; The path for which the cookie is valid. | ; The path for which the cookie is valid. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_path = / | session.cookie_path = / | ||
; The domain for which the cookie is valid. | ; The domain for which the cookie is valid. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_domain = | session.cookie_domain = | ||
; Whether or not to add the httpOnly flag to the cookie, which makes it inaccessible to browser scripting languages such as JavaScript. | ; Whether or not to add the httpOnly flag to the cookie, which makes it inaccessible to browser scripting languages such as JavaScript. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_httponly = | session.cookie_httponly = | ||
; Handler used to serialize data. php is the standard serializer of PHP. | ; Handler used to serialize data. php is the standard serializer of PHP. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.serialize_handler = php | session.serialize_handler = php | ||
Line 1427: | Line 1431: | ||
; Development Value: 1 | ; Development Value: 1 | ||
; Production Value: 1 | ; Production Value: 1 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.gc_probability = 1 | session.gc_probability = 1 | ||
Line 1441: | Line 1445: | ||
; Development Value: 1000 | ; Development Value: 1000 | ||
; Production Value: 1000 | ; Production Value: 1000 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.gc_divisor = 1000 | session.gc_divisor = 1000 | ||
; After this number of seconds, stored data will be seen as ' | ; After this number of seconds, stored data will be seen as ' | ||
; cleaned up by the garbage collection process. | ; cleaned up by the garbage collection process. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.gc_maxlifetime = 1440 | session.gc_maxlifetime = 1440 | ||
Line 1470: | Line 1474: | ||
; Development Value: On | ; Development Value: On | ||
; Production Value: Off | ; Production Value: Off | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.bug_compat_42 = Off | session.bug_compat_42 = Off | ||
Line 1479: | Line 1483: | ||
; Development Value: On | ; Development Value: On | ||
; Production Value: Off | ; Production Value: Off | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.bug_compat_warn = Off | session.bug_compat_warn = Off | ||
Line 1485: | Line 1489: | ||
; HTTP_REFERER has to contain this substring for the session to be | ; HTTP_REFERER has to contain this substring for the session to be | ||
; considered as valid. | ; considered as valid. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.referer_check = | session.referer_check = | ||
; How many bytes to read from the file. | ; How many bytes to read from the file. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.entropy_length = 0 | session.entropy_length = 0 | ||
; Specified here to create the session id. | ; Specified here to create the session id. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
session.entropy_file = | session.entropy_file = | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Set to {nocache, | ; Set to {nocache, | ||
; or leave this empty to avoid sending anti-caching headers. | ; or leave this empty to avoid sending anti-caching headers. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cache_limiter = nocache | session.cache_limiter = nocache | ||
; Document expires after n minutes. | ; Document expires after n minutes. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cache_expire = 180 | session.cache_expire = 180 | ||
Line 1518: | Line 1522: | ||
; - User may access your site with the same session ID | ; - User may access your site with the same session ID | ||
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.use_trans_sid = 0 | session.use_trans_sid = 0 | ||
Line 1525: | Line 1529: | ||
; | ; | ||
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.hash_function = 0 | session.hash_function = 0 | ||
Line 1537: | Line 1541: | ||
; Development Value: 5 | ; Development Value: 5 | ||
; Production Value: 5 | ; Production Value: 5 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.hash_bits_per_character = 5 | session.hash_bits_per_character = 5 | ||
Line 1548: | Line 1552: | ||
; Development Value: " | ; Development Value: " | ||
; Production Value: " | ; Production Value: " | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
url_rewriter.tags = " | url_rewriter.tags = " | ||
Line 1605: | Line 1609: | ||
[Assertion] | [Assertion] | ||
; Assert(expr); | ; Assert(expr); | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Issue a PHP warning for each failed assertion. | ; Issue a PHP warning for each failed assertion. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Don't bail out by default. | ; Don't bail out by default. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; User-function to be called if an assertion fails. | ; User-function to be called if an assertion fails. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Eval the expression with current error_reporting(). | ; Eval the expression with current error_reporting(). | ||
; error_reporting(0) around the eval(). | ; error_reporting(0) around the eval(). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[COM] | [COM] | ||
; path to a file containing GUIDs, IIDs or filenames of files with TypeLibs | ; path to a file containing GUIDs, IIDs or filenames of files with TypeLibs | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; allow Distributed-COM calls | ; allow Distributed-COM calls | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; autoregister constants of a components typlib on com_load() | ; autoregister constants of a components typlib on com_load() | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; register constants casesensitive | ; register constants casesensitive | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; show warnings on duplicate constant registrations | ; show warnings on duplicate constant registrations | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[mbstring] | [mbstring] | ||
; language for internal character representation. | ; language for internal character representation. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1654: | Line 1658: | ||
; Some encoding cannot work as internal encoding. | ; Some encoding cannot work as internal encoding. | ||
; (e.g. SJIS, BIG5, ISO-2022-*) | ; (e.g. SJIS, BIG5, ISO-2022-*) | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; http input encoding. | ; http input encoding. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; http output encoding. mb_output_handler must be | ; http output encoding. mb_output_handler must be | ||
; registered as output buffer to function | ; registered as output buffer to function | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1671: | Line 1675: | ||
; Note: Do _not_ use automatic encoding translation for | ; Note: Do _not_ use automatic encoding translation for | ||
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; automatic encoding detection order. | ; automatic encoding detection order. | ||
; auto means | ; auto means | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; substitute_character used when character cannot be converted | ; substitute_character used when character cannot be converted | ||
; one from another | ; one from another | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1692: | Line 1696: | ||
; 2: Overload str*() functions | ; 2: Overload str*() functions | ||
; 4: Overload ereg*() functions | ; 4: Overload ereg*() functions | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1699: | Line 1703: | ||
[gd] | [gd] | ||
- | ; Tell the jpeg decode to libjpeg | + | ; Tell the jpeg decode to ignore |
; a gd image. The warning will then be displayed as notices | ; a gd image. The warning will then be displayed as notices | ||
; disabled by default | ; disabled by default | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1711: | Line 1715: | ||
; is used. For the decode settings you can distinguish between motorola and | ; is used. For the decode settings you can distinguish between motorola and | ||
; intel byte order. A decode setting cannot be empty. | ; intel byte order. A decode setting cannot be empty. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[Tidy] | [Tidy] | ||
; The path to a default tidy configuration file to use when using tidy | ; The path to a default tidy configuration file to use when using tidy | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 1737: | Line 1741: | ||
; WARNING: Do not use this option if you are generating non-html content | ; WARNING: Do not use this option if you are generating non-html content | ||
; such as dynamic images | ; such as dynamic images | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
tidy.clean_output = Off | tidy.clean_output = Off | ||
[soap] | [soap] | ||
; Enables or disables WSDL caching feature. | ; Enables or disables WSDL caching feature. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
soap.wsdl_cache_enabled=1 | soap.wsdl_cache_enabled=1 | ||
; Sets the directory name where SOAP extension will put cache files. | ; Sets the directory name where SOAP extension will put cache files. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
soap.wsdl_cache_dir="/ | soap.wsdl_cache_dir="/ | ||
; (time to live) Sets the number of second while cached file will be used | ; (time to live) Sets the number of second while cached file will be used | ||
; instead of original one. | ; instead of original one. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
soap.wsdl_cache_ttl=86400 | soap.wsdl_cache_ttl=86400 | ||
Line 1764: | Line 1768: | ||
</ | </ | ||
- | |||
===== Development INI ===== | ===== Development INI ===== | ||
Line 1779: | Line 1782: | ||
; PHP attempts to find and load this configuration from a number of locations. | ; PHP attempts to find and load this configuration from a number of locations. | ||
- | ; The following is a summary of it' | + | ; The following is a summary of its search order: |
; 1. SAPI module specific location. | ; 1. SAPI module specific location. | ||
; 2. The PHPRC environment variable. (As of PHP 5.2.0) | ; 2. The PHPRC environment variable. (As of PHP 5.2.0) | ||
Line 1786: | Line 1789: | ||
; 5. The web server' | ; 5. The web server' | ||
; (otherwise in Windows) | ; (otherwise in Windows) | ||
- | ; 6. Windows | + | ; 6. The directory |
- | ; compile time option. | + | ; Windows directory (C:\windows or C:\winnt) |
; See the PHP docs for more specific information. | ; See the PHP docs for more specific information. | ||
; http:// | ; http:// | ||
Line 1794: | Line 1797: | ||
; beginning with a semicolon are silently ignored (as you probably guessed). | ; beginning with a semicolon are silently ignored (as you probably guessed). | ||
; Section headers (e.g. [Foo]) are also silently ignored, even though | ; Section headers (e.g. [Foo]) are also silently ignored, even though | ||
- | ; they might mean something in the future. | + | ; they might mean something in the future. |
+ | ; section headers starting with [HOST= or [PATH= | ||
+ | ; http:// | ||
; Directives are specified using the following syntax: | ; Directives are specified using the following syntax: | ||
Line 1827: | Line 1832: | ||
; About this file ; | ; About this file ; | ||
;;;;;;;;;;;;;;;;;;; | ;;;;;;;;;;;;;;;;;;; | ||
- | ; This file contains the recommended settings for a development deployment of | + | ; PHP comes packaged with two INI files. One that is recommended |
- | ; PHP. It's similar | + | ; in production environments |
- | ; terms of error reporting | + | ; development environments. |
- | ; your applications. | + | |
- | ; PHP is also packaged with an ini file which is tuned for performance, | + | ; php.ini-production contains settings |
- | ; security and best practices. We recommend you use that file for production | + | ; best practices |
- | ; deployments. But please be aware, these settings may break compatibility with | + | ; compatibility with older or less security conscience applications. We |
- | ; older applications | + | ; recommending using the production ini in production and testing environments. |
+ | |||
+ | ; php.ini-development is very similar to its production variant, except it's | ||
+ | ; much more verbose when it comes to errors. We recommending using the | ||
+ | ; development version only in development environments as errors shown to | ||
+ | ; application users can inadvertently leak otherwise secure information. | ||
;;;;;;;;;;;;;;;;;;; | ;;;;;;;;;;;;;;;;;;; | ||
; Quick Reference ; | ; Quick Reference ; | ||
;;;;;;;;;;;;;;;;;;; | ;;;;;;;;;;;;;;;;;;; | ||
- | ; The following | + | ; The following |
- | ; or development versions of the ini versus | + | ; or development versions of the INIs with respect to PHP's default behavior. |
- | ; for the settings below are the ones used in this file. Please see the actual | + | ; Please see the actual settings later in the document for more details |
- | ; settings later in the document for more details. | + | ; we recommend these changes in PHP's behavior. |
- | ; allow_call_time_pass_reference | + | ; allow_call_time_pass_reference |
- | ; display_errors | + | ; |
- | ; display_startup_errors | + | ; |
- | ; error_reporting | + | ; |
- | ; html_errors | + | |
- | ; log_errors | + | ; display_errors |
- | ; magic_quotes_gpc | + | ; |
- | ; max_input_time | + | ; |
- | ; output_buffering | + | ; |
- | ; register_argc_argv | + | |
- | ; register_long_arrays | + | ; display_startup_errors |
- | ; request_order | + | ; |
- | ; session.bug_compat_42 | + | ; |
- | ; session.bug_compat_warn | + | ; |
- | ; session.gc_divisor | + | |
- | ; session.hash_bits_per_character | + | ; error_reporting |
- | ; short_open_tag | + | ; |
- | ; track_errors | + | ; |
- | ; url_rewriter.tags = " | + | ; |
- | ; variables_order | + | |
+ | ; html_errors | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; log_errors | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; magic_quotes_gpc | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; max_input_time | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; output_buffering | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; register_argc_argv | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; register_long_arrays | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; request_order | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; session.bug_compat_42 | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; session.bug_compat_warn | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; session.gc_divisor | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; session.hash_bits_per_character | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; short_open_tag | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; track_errors | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
+ | |||
+ | ; url_rewriter.tags | ||
+ | ; | ||
+ | ; | ||
+ | ; Production Value: "a=href, | ||
+ | |||
+ | ; variables_order | ||
+ | ; | ||
+ | ; | ||
+ | ; | ||
;;;;;;;;;;;;;;;;;;;; | ;;;;;;;;;;;;;;;;;;;; | ||
Line 1916: | Line 2004: | ||
; data to the client. If your application' | ; data to the client. If your application' | ||
; will send that data in chunks of roughly the size you specify. | ; will send that data in chunks of roughly the size you specify. | ||
- | ; Turning on this setting and managing | + | ; Turning on this setting and managing |
; interesting side-effects depending on your application and web server. | ; interesting side-effects depending on your application and web server. | ||
; You may be able to send headers and cookies after you've already sent output | ; You may be able to send headers and cookies after you've already sent output | ||
Line 1928: | Line 2016: | ||
; On = Enabled and buffer is unlimited. (Use with caution) | ; On = Enabled and buffer is unlimited. (Use with caution) | ||
; Off = Disabled | ; Off = Disabled | ||
- | ; | + | ; |
; Default Value: Off | ; Default Value: Off | ||
- | ; Development Value: | + | ; Development Value: |
; Production Value: 4096 | ; Production Value: 4096 | ||
; http:// | ; http:// | ||
Line 1996: | Line 2084: | ||
; reference at function call time is a deprecated feature which will be removed | ; reference at function call time is a deprecated feature which will be removed | ||
; from PHP at some point in the near future. The acceptable method for passing a | ; from PHP at some point in the near future. The acceptable method for passing a | ||
- | ; value by reference to a function is by declaring the reference in the function | + | ; value by reference to a function is by declaring the reference in the functions |
; definition, not at call time. This directive does not disable this feature, it | ; definition, not at call time. This directive does not disable this feature, it | ||
- | ; only determines whether PHP will warn you about it or not. | + | ; only determines whether PHP will warn you about it or not. These warnings |
- | ; Default Value: On (Issue warnings) | + | ; should enabled in development environments only. |
- | ; Development Value: | + | ; Default Value: On (Suppress |
- | ; Production Value: Off (Suppress | + | ; Development Value: |
+ | ; Production Value: Off (Issue warnings) | ||
; http:// | ; http:// | ||
allow_call_time_pass_reference = Off | allow_call_time_pass_reference = Off | ||
Line 2179: | Line 2268: | ||
; Default Value: E_ALL & ~E_NOTICE | ; Default Value: E_ALL & ~E_NOTICE | ||
; Development Value: E_ALL | E_STRICT | ; Development Value: E_ALL | E_STRICT | ||
- | ; Production Value: E_ALL & ~E_NOTICE | + | ; Production Value: E_ALL & ~E_DEPRECATED |
; http:// | ; http:// | ||
- | error_reporting = E_ALL & ~E_NOTICE | + | error_reporting = E_ALL | E_STRICT |
; This directive controls whether or not and where PHP will output errors, | ; This directive controls whether or not and where PHP will output errors, | ||
- | ; notices and warnings | + | ; notices and warnings |
; it could be very dangerous in production environments. Depending on the code | ; it could be very dangerous in production environments. Depending on the code | ||
; which is triggering the error, sensitive information could potentially leak | ; which is triggering the error, sensitive information could potentially leak | ||
; out of your application such as database usernames and passwords or worse. | ; out of your application such as database usernames and passwords or worse. | ||
- | ; It's recommended that errors be logged on productions | + | ; It's recommended that errors be logged on production |
; having the errors sent to STDOUT. | ; having the errors sent to STDOUT. | ||
; Possible Values: | ; Possible Values: | ||
Line 2198: | Line 2287: | ||
; Production Value: Off | ; Production Value: Off | ||
; http:// | ; http:// | ||
- | display_errors = Off | + | display_errors = On |
; The display of errors which occur during PHP's startup sequence are handled | ; The display of errors which occur during PHP's startup sequence are handled | ||
Line 2209: | Line 2298: | ||
; Production Value: Off | ; Production Value: Off | ||
; http:// | ; http:// | ||
- | display_startup_errors = Off | + | display_startup_errors = On |
; Besides displaying errors, PHP can also log errors to locations such as a | ; Besides displaying errors, PHP can also log errors to locations such as a | ||
Line 2247: | Line 2336: | ||
; Store the last error/ | ; Store the last error/ | ||
- | ; to on can assist in debugging and appropriate for development servers. It should | + | ; to On can assist in debugging and is appropriate for development servers. It should |
; however be disabled on production servers. | ; however be disabled on production servers. | ||
; Default Value: Off | ; Default Value: Off | ||
; Development Value: On | ; Development Value: On | ||
; Production Value: Off | ; Production Value: Off | ||
- | http:// | + | ; http:// |
- | track_errors = Off | + | track_errors = On |
; Turn off normal error reporting and emit XML-RPC error XML | ; Turn off normal error reporting and emit XML-RPC error XML | ||
Line 2270: | Line 2359: | ||
; Production value: Off | ; Production value: Off | ||
; http:// | ; http:// | ||
- | html_errors = Off | + | html_errors = On |
; If html_errors is set On PHP produces clickable error messages that direct | ; If html_errors is set On PHP produces clickable error messages that direct | ||
Line 2332: | Line 2421: | ||
; these arrays and because ENV is not as commonly used as the others, ENV is | ; these arrays and because ENV is not as commonly used as the others, ENV is | ||
; is not recommended on productions servers. You can still get access to | ; is not recommended on productions servers. You can still get access to | ||
- | ; the environment variables through getenv() should you need to. ENV data could | + | ; the environment variables through getenv() should you need to. |
- | ; be very helpful in tracking down bugs so it's not a bad idea to enable them | + | |
- | ; on developmental servers. | + | |
; Default Value: " | ; Default Value: " | ||
- | ; Development Value: "EGPCS" | + | ; Development Value: "GPCS" |
- | ; Production Value: " | + | ; Production Value: " |
; http:// | ; http:// | ||
variables_order = " | variables_order = " | ||
Line 2347: | Line 2434: | ||
; Leaving this value empty will cause PHP to use the value set in the | ; Leaving this value empty will cause PHP to use the value set in the | ||
; variables_order directive. It does not mean it will leave the super globals | ; variables_order directive. It does not mean it will leave the super globals | ||
- | ; array REQUEST empty. For performance reasons, mostly to reduce redundant | + | ; array REQUEST empty. |
- | ; registrations, | + | |
- | ; servers. On developmental servers, it might be helpful to set this value to empty | + | |
- | ; for debugging purposes. | + | |
; Default Value: None | ; Default Value: None | ||
- | ; Development Value: | + | ; Development Value: |
; Production Value: " | ; Production Value: " | ||
; http:// | ; http:// | ||
Line 2382: | Line 2466: | ||
; is invoked. $argc contains an integer representing the number of arguments | ; is invoked. $argc contains an integer representing the number of arguments | ||
; that were passed when the script was invoked. These arrays are extremely | ; that were passed when the script was invoked. These arrays are extremely | ||
- | ; useful when running scripts from the command line and can also be useful for | + | ; useful when running scripts from the command line. When this directive is |
- | ; debugging purposes. When this directive is enabled, registering these variables | + | ; enabled, registering these variables consumes CPU cycles and memory each time |
- | ; consumes CPU cycles and memory each time a script is executed. For performance | + | ; a script is executed. For performance reasons, this feature should be disabled |
- | ; reasons, this feature should be disabled on production servers. | + | ; on production servers. |
; Default Value: On | ; Default Value: On | ||
- | ; Development Value: | + | ; Development Value: |
; Production Value: Off | ; Production Value: Off | ||
; http:// | ; http:// | ||
Line 2481: | Line 2565: | ||
; Directory in which the loadable extensions (modules) reside. | ; Directory in which the loadable extensions (modules) reside. | ||
; http:// | ; http:// | ||
- | extension_dir = " | + | ; extension_dir = " |
; Whether or not to enable the dl() function. | ; Whether or not to enable the dl() function. | ||
Line 2487: | Line 2571: | ||
; disabled on them. | ; disabled on them. | ||
; http:// | ; http:// | ||
- | enable_dl = On | + | enable_dl = Off |
; cgi.force_redirect is necessary to provide security running PHP as a CGI under | ; cgi.force_redirect is necessary to provide security running PHP as a CGI under | ||
Line 2510: | Line 2594: | ||
; previous behaviour was to set PATH_TRANSLATED to SCRIPT_FILENAME, | ; previous behaviour was to set PATH_TRANSLATED to SCRIPT_FILENAME, | ||
; what PATH_INFO is. For more information on PATH_INFO, see the cgi specs. | ; what PATH_INFO is. For more information on PATH_INFO, see the cgi specs. | ||
- | ; this to 1 will cause PHP CGI to fix it' | + | ; this to 1 will cause PHP CGI to fix its paths to conform to the spec. A setting |
; of zero causes PHP to behave as before. | ; of zero causes PHP to behave as before. | ||
; to use SCRIPT_FILENAME rather than PATH_TRANSLATED. | ; to use SCRIPT_FILENAME rather than PATH_TRANSLATED. | ||
Line 2603: | Line 2687: | ||
; | ; | ||
; | ; | ||
- | ; Note that it should be the name of the module only; no directory information | + | ; ... or with a path: |
- | ; needs to go here. | + | ; |
- | ; extension_dir directive above. | + | ; extension=/ |
+ | ; | ||
+ | ; If you only provide | ||
+ | ; default extension directory. | ||
; | ; | ||
; Windows Extensions | ; Windows Extensions | ||
Line 2766: | Line 2853: | ||
[SQL] | [SQL] | ||
- | http:// | + | ; http:// |
sql.safe_mode = Off | sql.safe_mode = Off | ||
Line 2861: | Line 2948: | ||
; Maximum number of links. | ; Maximum number of links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.max_links = -1 | mysqli.max_links = -1 | ||
Line 2868: | Line 2955: | ||
; compile-time value defined MYSQL_PORT (in that order). | ; compile-time value defined MYSQL_PORT (in that order). | ||
; at MYSQL_PORT. | ; at MYSQL_PORT. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_port = 3306 | mysqli.default_port = 3306 | ||
; Default socket name for local MySQL connects. | ; Default socket name for local MySQL connects. | ||
; MySQL defaults. | ; MySQL defaults. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_socket = | mysqli.default_socket = | ||
; Default host for mysql_connect() (doesn' | ; Default host for mysql_connect() (doesn' | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_host = | mysqli.default_host = | ||
; Default user for mysql_connect() (doesn' | ; Default user for mysql_connect() (doesn' | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_user = | mysqli.default_user = | ||
Line 2889: | Line 2976: | ||
; and reveal this password! | ; and reveal this password! | ||
; file will be able to reveal the password as well. | ; file will be able to reveal the password as well. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
mysqli.default_pw = | mysqli.default_pw = | ||
Line 2899: | Line 2986: | ||
; Connection: Enables privileged connections using external | ; Connection: Enables privileged connections using external | ||
; credentials (OCI_SYSOPER, | ; credentials (OCI_SYSOPER, | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Connection: The maximum number of persistent OCI8 connections per | ; Connection: The maximum number of persistent OCI8 connections per | ||
; process. Using -1 means no limit. | ; process. Using -1 means no limit. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 2910: | Line 2997: | ||
; maintain an idle persistent connection. Using -1 means idle | ; maintain an idle persistent connection. Using -1 means idle | ||
; persistent connections will be maintained forever. | ; persistent connections will be maintained forever. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 2917: | Line 3004: | ||
; set to 0, each oci_pconnect() will cause a ping. Using -1 disables | ; set to 0, each oci_pconnect() will cause a ping. Using -1 disables | ||
; pings completely. | ; pings completely. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 2928: | Line 3015: | ||
; | ; | ||
- | ; High Availability: | + | ; High Availability: |
; Notification (FAN) events generated when a database node fails. The | ; Notification (FAN) events generated when a database node fails. The | ||
; database must also be configured to post FAN events. | ; database must also be configured to post FAN events. | ||
- | ; | + | ; |
; Tuning: This option enables statement caching, and specifies how | ; Tuning: This option enables statement caching, and specifies how | ||
; many statements to cache. Using 0 disables statement caching. | ; many statements to cache. Using 0 disables statement caching. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Tuning: Enables statement prefetching and sets the default number of | ; Tuning: Enables statement prefetching and sets the default number of | ||
; rows that will be fetched automatically after statement execution. | ; rows that will be fetched automatically after statement execution. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; Compatibility. Using 1 means oci_close() will not close | + | ; Compatibility. Using On means oci_close() will not close |
; oci_connect() and oci_new_connect() connections. | ; oci_connect() and oci_new_connect() connections. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
- | ; | + | ; |
[PostgresSQL] | [PostgresSQL] | ||
; Allow or prevent persistent links. | ; Allow or prevent persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.allow_persistent = On | pgsql.allow_persistent = On | ||
; Detect broken persistent links always with pg_pconnect(). | ; Detect broken persistent links always with pg_pconnect(). | ||
; Auto reset feature requires a little overheads. | ; Auto reset feature requires a little overheads. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.auto_reset_persistent = Off | pgsql.auto_reset_persistent = Off | ||
; Maximum number of persistent links. | ; Maximum number of persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.max_persistent = -1 | pgsql.max_persistent = -1 | ||
; Maximum number of links (persistent+non persistent). | ; Maximum number of links (persistent+non persistent). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.max_links = -1 | pgsql.max_links = -1 | ||
; Ignore PostgreSQL backends Notice message or not. | ; Ignore PostgreSQL backends Notice message or not. | ||
; Notice message logging require a little overheads. | ; Notice message logging require a little overheads. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.ignore_notice = 0 | pgsql.ignore_notice = 0 | ||
; Log PostgreSQL backends Noitce message or not. | ; Log PostgreSQL backends Noitce message or not. | ||
; Unless pgsql.ignore_notice=0, | ; Unless pgsql.ignore_notice=0, | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
pgsql.log_notice = 0 | pgsql.log_notice = 0 | ||
[Sybase-CT] | [Sybase-CT] | ||
; Allow or prevent persistent links. | ; Allow or prevent persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.allow_persistent = On | sybct.allow_persistent = On | ||
; Maximum number of persistent links. | ; Maximum number of persistent links. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.max_persistent = -1 | sybct.max_persistent = -1 | ||
; Maximum number of links (persistent + non-persistent). | ; Maximum number of links (persistent + non-persistent). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.max_links = -1 | sybct.max_links = -1 | ||
; Minimum server message severity to display. | ; Minimum server message severity to display. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.min_server_severity = 10 | sybct.min_server_severity = 10 | ||
; Minimum client message severity to display. | ; Minimum client message severity to display. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
sybct.min_client_severity = 10 | sybct.min_client_severity = 10 | ||
; Set per-context timeout | ; Set per-context timeout | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3005: | Line 3092: | ||
[bcmath] | [bcmath] | ||
; Number of decimal digits for all bcmath functions. | ; Number of decimal digits for all bcmath functions. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
bcmath.scale = 0 | bcmath.scale = 0 | ||
[browscap] | [browscap] | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
;browscap = extra/ | ;browscap = extra/ | ||
[Session] | [Session] | ||
; Handler used to store/ | ; Handler used to store/ | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.save_handler = files | session.save_handler = files | ||
Line 3043: | Line 3130: | ||
; where MODE is the octal representation of the mode. Note that this | ; where MODE is the octal representation of the mode. Note that this | ||
; does not overwrite the process' | ; does not overwrite the process' | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Whether to use cookies. | ; Whether to use cookies. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.use_cookies = 1 | session.use_cookies = 1 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3061: | Line 3148: | ||
; Name of the session (used as cookie name). | ; Name of the session (used as cookie name). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.name = PHPSESSID | session.name = PHPSESSID | ||
; Initialize session on request startup. | ; Initialize session on request startup. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.auto_start = 0 | session.auto_start = 0 | ||
; Lifetime in seconds of cookie or, if 0, until browser is restarted. | ; Lifetime in seconds of cookie or, if 0, until browser is restarted. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_lifetime = 0 | session.cookie_lifetime = 0 | ||
; The path for which the cookie is valid. | ; The path for which the cookie is valid. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_path = / | session.cookie_path = / | ||
; The domain for which the cookie is valid. | ; The domain for which the cookie is valid. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_domain = | session.cookie_domain = | ||
; Whether or not to add the httpOnly flag to the cookie, which makes it inaccessible to browser scripting languages such as JavaScript. | ; Whether or not to add the httpOnly flag to the cookie, which makes it inaccessible to browser scripting languages such as JavaScript. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cookie_httponly = | session.cookie_httponly = | ||
; Handler used to serialize data. php is the standard serializer of PHP. | ; Handler used to serialize data. php is the standard serializer of PHP. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.serialize_handler = php | session.serialize_handler = php | ||
Line 3097: | Line 3184: | ||
; Development Value: 1 | ; Development Value: 1 | ||
; Production Value: 1 | ; Production Value: 1 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.gc_probability = 1 | session.gc_probability = 1 | ||
Line 3109: | Line 3196: | ||
; this is a more efficient approach. | ; this is a more efficient approach. | ||
; Default Value: 100 | ; Default Value: 100 | ||
- | ; Development Value: | + | ; Development Value: |
; Production Value: 1000 | ; Production Value: 1000 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.gc_divisor = 1000 | session.gc_divisor = 1000 | ||
; After this number of seconds, stored data will be seen as ' | ; After this number of seconds, stored data will be seen as ' | ||
; cleaned up by the garbage collection process. | ; cleaned up by the garbage collection process. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.gc_maxlifetime = 1440 | session.gc_maxlifetime = 1440 | ||
Line 3132: | Line 3219: | ||
; You can disable the feature and the warning separately. At this time, | ; You can disable the feature and the warning separately. At this time, | ||
; the warning is only displayed, if bug_compat_42 is enabled. This feature | ; the warning is only displayed, if bug_compat_42 is enabled. This feature | ||
- | ; introduces some serious security problems if not handled correctly. It' | + | ; introduces some serious security problems if not handled correctly. It's |
; recommended that you do not use this feature on production servers. But you | ; recommended that you do not use this feature on production servers. But you | ||
; should enable this on development servers and enable the warning as well. If you | ; should enable this on development servers and enable the warning as well. If you | ||
; do not enable the feature on development servers, you won't be warned when it's | ; do not enable the feature on development servers, you won't be warned when it's | ||
- | ; used and debugging errors caused by this can be difficult. | + | ; used and debugging errors caused by this can be difficult |
; Default Value: On | ; Default Value: On | ||
; Development Value: On | ; Development Value: On | ||
; Production Value: Off | ; Production Value: Off | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
- | session.bug_compat_42 = Off | + | session.bug_compat_42 = On |
- | ; This setting controls whether or not you are warned by PHP when initialize | + | ; This setting controls whether or not you are warned by PHP when initializing |
; session value into the global space. session.bug_compat_42 must be enabled before | ; session value into the global space. session.bug_compat_42 must be enabled before | ||
; these warnings can be issued by PHP. See the directive above for more information. | ; these warnings can be issued by PHP. See the directive above for more information. | ||
Line 3149: | Line 3236: | ||
; Development Value: On | ; Development Value: On | ||
; Production Value: Off | ; Production Value: Off | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
- | session.bug_compat_warn = Off | + | session.bug_compat_warn = On |
; Check HTTP Referer to invalidate externally stored URLs containing ids. | ; Check HTTP Referer to invalidate externally stored URLs containing ids. | ||
; HTTP_REFERER has to contain this substring for the session to be | ; HTTP_REFERER has to contain this substring for the session to be | ||
; considered as valid. | ; considered as valid. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.referer_check = | session.referer_check = | ||
; How many bytes to read from the file. | ; How many bytes to read from the file. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.entropy_length = 0 | session.entropy_length = 0 | ||
; Specified here to create the session id. | ; Specified here to create the session id. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
session.entropy_file = | session.entropy_file = | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Set to {nocache, | ; Set to {nocache, | ||
; or leave this empty to avoid sending anti-caching headers. | ; or leave this empty to avoid sending anti-caching headers. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cache_limiter = nocache | session.cache_limiter = nocache | ||
; Document expires after n minutes. | ; Document expires after n minutes. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.cache_expire = 180 | session.cache_expire = 180 | ||
Line 3188: | Line 3275: | ||
; - User may access your site with the same session ID | ; - User may access your site with the same session ID | ||
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.use_trans_sid = 0 | session.use_trans_sid = 0 | ||
Line 3195: | Line 3282: | ||
; | ; | ||
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.hash_function = 0 | session.hash_function = 0 | ||
Line 3207: | Line 3294: | ||
; Development Value: 5 | ; Development Value: 5 | ||
; Production Value: 5 | ; Production Value: 5 | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
session.hash_bits_per_character = 5 | session.hash_bits_per_character = 5 | ||
Line 3218: | Line 3305: | ||
; Development Value: " | ; Development Value: " | ||
; Production Value: " | ; Production Value: " | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
url_rewriter.tags = " | url_rewriter.tags = " | ||
Line 3275: | Line 3362: | ||
[Assertion] | [Assertion] | ||
; Assert(expr); | ; Assert(expr); | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Issue a PHP warning for each failed assertion. | ; Issue a PHP warning for each failed assertion. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Don't bail out by default. | ; Don't bail out by default. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; User-function to be called if an assertion fails. | ; User-function to be called if an assertion fails. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; Eval the expression with current error_reporting(). | ; Eval the expression with current error_reporting(). | ||
; error_reporting(0) around the eval(). | ; error_reporting(0) around the eval(). | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[COM] | [COM] | ||
; path to a file containing GUIDs, IIDs or filenames of files with TypeLibs | ; path to a file containing GUIDs, IIDs or filenames of files with TypeLibs | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; allow Distributed-COM calls | ; allow Distributed-COM calls | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; autoregister constants of a components typlib on com_load() | ; autoregister constants of a components typlib on com_load() | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; register constants casesensitive | ; register constants casesensitive | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; show warnings on duplicate constant registrations | ; show warnings on duplicate constant registrations | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[mbstring] | [mbstring] | ||
; language for internal character representation. | ; language for internal character representation. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3324: | Line 3411: | ||
; Some encoding cannot work as internal encoding. | ; Some encoding cannot work as internal encoding. | ||
; (e.g. SJIS, BIG5, ISO-2022-*) | ; (e.g. SJIS, BIG5, ISO-2022-*) | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; http input encoding. | ; http input encoding. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; http output encoding. mb_output_handler must be | ; http output encoding. mb_output_handler must be | ||
; registered as output buffer to function | ; registered as output buffer to function | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3341: | Line 3428: | ||
; Note: Do _not_ use automatic encoding translation for | ; Note: Do _not_ use automatic encoding translation for | ||
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; automatic encoding detection order. | ; automatic encoding detection order. | ||
; auto means | ; auto means | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
; substitute_character used when character cannot be converted | ; substitute_character used when character cannot be converted | ||
; one from another | ; one from another | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3362: | Line 3449: | ||
; 2: Overload str*() functions | ; 2: Overload str*() functions | ||
; 4: Overload ereg*() functions | ; 4: Overload ereg*() functions | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3369: | Line 3456: | ||
[gd] | [gd] | ||
- | ; Tell the jpeg decode to libjpeg | + | ; Tell the jpeg decode to ignore |
; a gd image. The warning will then be displayed as notices | ; a gd image. The warning will then be displayed as notices | ||
; disabled by default | ; disabled by default | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3381: | Line 3468: | ||
; is used. For the decode settings you can distinguish between motorola and | ; is used. For the decode settings you can distinguish between motorola and | ||
; intel byte order. A decode setting cannot be empty. | ; intel byte order. A decode setting cannot be empty. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
[Tidy] | [Tidy] | ||
; The path to a default tidy configuration file to use when using tidy | ; The path to a default tidy configuration file to use when using tidy | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
; | ; | ||
Line 3407: | Line 3494: | ||
; WARNING: Do not use this option if you are generating non-html content | ; WARNING: Do not use this option if you are generating non-html content | ||
; such as dynamic images | ; such as dynamic images | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
tidy.clean_output = Off | tidy.clean_output = Off | ||
[soap] | [soap] | ||
; Enables or disables WSDL caching feature. | ; Enables or disables WSDL caching feature. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
soap.wsdl_cache_enabled=1 | soap.wsdl_cache_enabled=1 | ||
; Sets the directory name where SOAP extension will put cache files. | ; Sets the directory name where SOAP extension will put cache files. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
soap.wsdl_cache_dir="/ | soap.wsdl_cache_dir="/ | ||
; (time to live) Sets the number of second while cached file will be used | ; (time to live) Sets the number of second while cached file will be used | ||
; instead of original one. | ; instead of original one. | ||
- | ; http://us2.php.net/ | + | ; http://www.php.net/ |
soap.wsdl_cache_ttl=86400 | soap.wsdl_cache_ttl=86400 | ||
Line 3432: | Line 3519: | ||
; tab-width: 4 | ; tab-width: 4 | ||
; End: | ; End: | ||
+ | |||
</ | </ | ||
Line 3437: | Line 3525: | ||
version 1.0 Initial offering. | version 1.0 Initial offering. | ||
+ | |||
+ | version 1.1 First revision based on comments mainly from the internals list. | ||
+ | |||
+ | version 1.2 A few minor changes based mainly on comments from the internals list. |
rfc/newinis.1234854218.txt.gz · Last modified: 2017/09/22 13:28 (external edit)