xref: /PHP-7.4/php.ini-production (revision ed949a19)
1c3fcaf1dSJohannes Schlüter[PHP]
2c3fcaf1dSJohannes Schlüter
3c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
4c3fcaf1dSJohannes Schlüter; About php.ini   ;
5c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
6c3fcaf1dSJohannes Schlüter; PHP's initialization file, generally called php.ini, is responsible for
7c3fcaf1dSJohannes Schlüter; configuring many of the aspects of PHP's behavior.
8c3fcaf1dSJohannes Schlüter
9c3fcaf1dSJohannes Schlüter; PHP attempts to find and load this configuration from a number of locations.
10c3fcaf1dSJohannes Schlüter; The following is a summary of its search order:
11c3fcaf1dSJohannes Schlüter; 1. SAPI module specific location.
12c3fcaf1dSJohannes Schlüter; 2. The PHPRC environment variable. (As of PHP 5.2.0)
13c3fcaf1dSJohannes Schlüter; 3. A number of predefined registry keys on Windows (As of PHP 5.2.0)
14c3fcaf1dSJohannes Schlüter; 4. Current working directory (except CLI)
15c3fcaf1dSJohannes Schlüter; 5. The web server's directory (for SAPI modules), or directory of PHP
16c3fcaf1dSJohannes Schlüter; (otherwise in Windows)
17c3fcaf1dSJohannes Schlüter; 6. The directory from the --with-config-file-path compile time option, or the
1844c5dea9SKalle Sommer Nielsen; Windows directory (usually C:\windows)
19c3fcaf1dSJohannes Schlüter; See the PHP docs for more specific information.
20c1ccccc6SPhilip Olson; http://php.net/configuration.file
21c3fcaf1dSJohannes Schlüter
22710021d1SJohannes Schlüter; The syntax of the file is extremely simple.  Whitespace and lines
23c3fcaf1dSJohannes Schlüter; beginning with a semicolon are silently ignored (as you probably guessed).
24c3fcaf1dSJohannes Schlüter; Section headers (e.g. [Foo]) are also silently ignored, even though
2584dcca9fSLukas Smith; they might mean something in the future.
26e0669bf1SEric Stewart
27e0669bf1SEric Stewart; Directives following the section heading [PATH=/www/mysite] only
28e0669bf1SEric Stewart; apply to PHP files in the /www/mysite directory.  Directives
29e0669bf1SEric Stewart; following the section heading [HOST=www.example.com] only apply to
30e0669bf1SEric Stewart; PHP files served from www.example.com.  Directives set in these
31e0669bf1SEric Stewart; special sections cannot be overridden by user-defined INI files or
32e0669bf1SEric Stewart; at runtime. Currently, [PATH=] and [HOST=] sections only work under
33e0669bf1SEric Stewart; CGI/FastCGI.
34c1ccccc6SPhilip Olson; http://php.net/ini.sections
35c3fcaf1dSJohannes Schlüter
36c3fcaf1dSJohannes Schlüter; Directives are specified using the following syntax:
37c3fcaf1dSJohannes Schlüter; directive = value
38c3fcaf1dSJohannes Schlüter; Directive names are *case sensitive* - foo=bar is different from FOO=bar.
39e0669bf1SEric Stewart; Directives are variables used to configure PHP or PHP extensions.
40e0669bf1SEric Stewart; There is no name validation.  If PHP can't find an expected
41e0669bf1SEric Stewart; directive because it is not set or is mistyped, a default value will be used.
42c3fcaf1dSJohannes Schlüter
43c3fcaf1dSJohannes Schlüter; The value can be a string, a number, a PHP constant (e.g. E_ALL or M_PI), one
44c3fcaf1dSJohannes Schlüter; of the INI constants (On, Off, True, False, Yes, No and None) or an expression
45e0669bf1SEric Stewart; (e.g. E_ALL & ~E_NOTICE), a quoted string ("bar"), or a reference to a
46e0669bf1SEric Stewart; previously set variable or directive (e.g. ${foo})
47c3fcaf1dSJohannes Schlüter
48c3fcaf1dSJohannes Schlüter; Expressions in the INI file are limited to bitwise operators and parentheses:
49c3fcaf1dSJohannes Schlüter; |  bitwise OR
50e0669bf1SEric Stewart; ^  bitwise XOR
51c3fcaf1dSJohannes Schlüter; &  bitwise AND
52c3fcaf1dSJohannes Schlüter; ~  bitwise NOT
53c3fcaf1dSJohannes Schlüter; !  boolean NOT
54c3fcaf1dSJohannes Schlüter
55c3fcaf1dSJohannes Schlüter; Boolean flags can be turned on using the values 1, On, True or Yes.
56c3fcaf1dSJohannes Schlüter; They can be turned off using the values 0, Off, False or No.
57c3fcaf1dSJohannes Schlüter
58c3fcaf1dSJohannes Schlüter; An empty string can be denoted by simply not writing anything after the equal
59c3fcaf1dSJohannes Schlüter; sign, or by using the None keyword:
60c3fcaf1dSJohannes Schlüter
61ca21ba3fSsundarchi; foo =         ; sets foo to an empty string
62ca21ba3fSsundarchi; foo = None    ; sets foo to an empty string
63ca21ba3fSsundarchi; foo = "None"  ; sets foo to the string 'None'
64c3fcaf1dSJohannes Schlüter
65c3fcaf1dSJohannes Schlüter; If you use constants in your value, and these constants belong to a
66c3fcaf1dSJohannes Schlüter; dynamically loaded extension (either a PHP extension or a Zend extension),
67c3fcaf1dSJohannes Schlüter; you may only use these constants *after* the line that loads the extension.
68c3fcaf1dSJohannes Schlüter
69c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
70c3fcaf1dSJohannes Schlüter; About this file ;
71c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
72c3fcaf1dSJohannes Schlüter; PHP comes packaged with two INI files. One that is recommended to be used
73c3fcaf1dSJohannes Schlüter; in production environments and one that is recommended to be used in
74c3fcaf1dSJohannes Schlüter; development environments.
75c3fcaf1dSJohannes Schlüter
76c3fcaf1dSJohannes Schlüter; php.ini-production contains settings which hold security, performance and
77c3fcaf1dSJohannes Schlüter; best practices at its core. But please be aware, these settings may break
78c3fcaf1dSJohannes Schlüter; compatibility with older or less security conscience applications. We
79c3fcaf1dSJohannes Schlüter; recommending using the production ini in production and testing environments.
80c3fcaf1dSJohannes Schlüter
81d0727b58SBryan Hanks, PMP; php.ini-development is very similar to its production variant, except it is
82d0727b58SBryan Hanks, PMP; much more verbose when it comes to errors. We recommend using the
83d0727b58SBryan Hanks, PMP; development version only in development environments, as errors shown to
84c3fcaf1dSJohannes Schlüter; application users can inadvertently leak otherwise secure information.
85c3fcaf1dSJohannes Schlüter
8658c778baSMichael Smith; This is the php.ini-production INI file.
87d0727b58SBryan Hanks, PMP
88c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
89c3fcaf1dSJohannes Schlüter; Quick Reference ;
90c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
91c3fcaf1dSJohannes Schlüter; The following are all the settings which are different in either the production
92c3fcaf1dSJohannes Schlüter; or development versions of the INIs with respect to PHP's default behavior.
93c3fcaf1dSJohannes Schlüter; Please see the actual settings later in the document for more details as to why
94c3fcaf1dSJohannes Schlüter; we recommend these changes in PHP's behavior.
95c3fcaf1dSJohannes Schlüter
96c3fcaf1dSJohannes Schlüter; display_errors
97c3fcaf1dSJohannes Schlüter;   Default Value: On
98c3fcaf1dSJohannes Schlüter;   Development Value: On
99c3fcaf1dSJohannes Schlüter;   Production Value: Off
100c3fcaf1dSJohannes Schlüter
101c3fcaf1dSJohannes Schlüter; display_startup_errors
102c3fcaf1dSJohannes Schlüter;   Default Value: Off
103c3fcaf1dSJohannes Schlüter;   Development Value: On
104c3fcaf1dSJohannes Schlüter;   Production Value: Off
105c3fcaf1dSJohannes Schlüter
106c3fcaf1dSJohannes Schlüter; error_reporting
1077bb8f9eeSStanislav Malyshev;   Default Value: E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
1087bb8f9eeSStanislav Malyshev;   Development Value: E_ALL
1093f43c3efSStanislav Malyshev;   Production Value: E_ALL & ~E_DEPRECATED & ~E_STRICT
110c3fcaf1dSJohannes Schlüter
111c3fcaf1dSJohannes Schlüter; log_errors
112c3fcaf1dSJohannes Schlüter;   Default Value: Off
113c3fcaf1dSJohannes Schlüter;   Development Value: On
114c3fcaf1dSJohannes Schlüter;   Production Value: On
115c3fcaf1dSJohannes Schlüter
116c3fcaf1dSJohannes Schlüter; max_input_time
117c3fcaf1dSJohannes Schlüter;   Default Value: -1 (Unlimited)
118c3fcaf1dSJohannes Schlüter;   Development Value: 60 (60 seconds)
119c3fcaf1dSJohannes Schlüter;   Production Value: 60 (60 seconds)
120c3fcaf1dSJohannes Schlüter
121c3fcaf1dSJohannes Schlüter; output_buffering
122c3fcaf1dSJohannes Schlüter;   Default Value: Off
123c3fcaf1dSJohannes Schlüter;   Development Value: 4096
124c3fcaf1dSJohannes Schlüter;   Production Value: 4096
125c3fcaf1dSJohannes Schlüter
126c3fcaf1dSJohannes Schlüter; register_argc_argv
127c3fcaf1dSJohannes Schlüter;   Default Value: On
128c3fcaf1dSJohannes Schlüter;   Development Value: Off
129c3fcaf1dSJohannes Schlüter;   Production Value: Off
130c3fcaf1dSJohannes Schlüter
131c3fcaf1dSJohannes Schlüter; request_order
132c3fcaf1dSJohannes Schlüter;   Default Value: None
133c3fcaf1dSJohannes Schlüter;   Development Value: "GP"
134c3fcaf1dSJohannes Schlüter;   Production Value: "GP"
135c3fcaf1dSJohannes Schlüter
136c3fcaf1dSJohannes Schlüter; session.gc_divisor
137c3fcaf1dSJohannes Schlüter;   Default Value: 100
138c3fcaf1dSJohannes Schlüter;   Development Value: 1000
139c3fcaf1dSJohannes Schlüter;   Production Value: 1000
140c3fcaf1dSJohannes Schlüter
1413467526aSYasuo Ohgaki; session.sid_bits_per_character
142c3fcaf1dSJohannes Schlüter;   Default Value: 4
143c3fcaf1dSJohannes Schlüter;   Development Value: 5
144c3fcaf1dSJohannes Schlüter;   Production Value: 5
145c3fcaf1dSJohannes Schlüter
146c3fcaf1dSJohannes Schlüter; short_open_tag
147c3fcaf1dSJohannes Schlüter;   Default Value: On
148c3fcaf1dSJohannes Schlüter;   Development Value: Off
149c3fcaf1dSJohannes Schlüter;   Production Value: Off
150c3fcaf1dSJohannes Schlüter
151c3fcaf1dSJohannes Schlüter; variables_order
152c3fcaf1dSJohannes Schlüter;   Default Value: "EGPCS"
153c3fcaf1dSJohannes Schlüter;   Development Value: "GPCS"
154c3fcaf1dSJohannes Schlüter;   Production Value: "GPCS"
155c3fcaf1dSJohannes Schlüter
156c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;
157c3fcaf1dSJohannes Schlüter; php.ini Options  ;
158c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;
159c3fcaf1dSJohannes Schlüter; Name for user-defined php.ini (.htaccess) files. Default is ".user.ini"
160c3fcaf1dSJohannes Schlüter;user_ini.filename = ".user.ini"
161c3fcaf1dSJohannes Schlüter
16258c778baSMichael Smith; To disable this feature set this option to an empty value
163c3fcaf1dSJohannes Schlüter;user_ini.filename =
164c3fcaf1dSJohannes Schlüter
165c3fcaf1dSJohannes Schlüter; TTL for user-defined php.ini files (time-to-live) in seconds. Default is 300 seconds (5 minutes)
166c3fcaf1dSJohannes Schlüter;user_ini.cache_ttl = 300
167c3fcaf1dSJohannes Schlüter
168c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;
169c3fcaf1dSJohannes Schlüter; Language Options ;
170c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;
171c3fcaf1dSJohannes Schlüter
172c3fcaf1dSJohannes Schlüter; Enable the PHP scripting language engine under Apache.
173c1ccccc6SPhilip Olson; http://php.net/engine
174c3fcaf1dSJohannes Schlüterengine = On
175c3fcaf1dSJohannes Schlüter
176c3fcaf1dSJohannes Schlüter; This directive determines whether or not PHP will recognize code between
177160cd8d0SAdam Harvey; <? and ?> tags as PHP source which should be processed as such. It is
178160cd8d0SAdam Harvey; generally recommended that <?php and ?> should be used and that this feature
179160cd8d0SAdam Harvey; should be disabled, as enabling it may result in issues when generating XML
180160cd8d0SAdam Harvey; documents, however this remains supported for backward compatibility reasons.
181160cd8d0SAdam Harvey; Note that this directive does not control the <?= shorthand tag, which can be
182160cd8d0SAdam Harvey; used regardless of this directive.
183c3fcaf1dSJohannes Schlüter; Default Value: On
184c3fcaf1dSJohannes Schlüter; Development Value: Off
185c3fcaf1dSJohannes Schlüter; Production Value: Off
186c1ccccc6SPhilip Olson; http://php.net/short-open-tag
187c3fcaf1dSJohannes Schlütershort_open_tag = Off
188c3fcaf1dSJohannes Schlüter
189c3fcaf1dSJohannes Schlüter; The number of significant digits displayed in floating point numbers.
190c1ccccc6SPhilip Olson; http://php.net/precision
191c3fcaf1dSJohannes Schlüterprecision = 14
192c3fcaf1dSJohannes Schlüter
193c3fcaf1dSJohannes Schlüter; Output buffering is a mechanism for controlling how much output data
194c3fcaf1dSJohannes Schlüter; (excluding headers and cookies) PHP should keep internally before pushing that
195c3fcaf1dSJohannes Schlüter; data to the client. If your application's output exceeds this setting, PHP
196c3fcaf1dSJohannes Schlüter; will send that data in chunks of roughly the size you specify.
197c3fcaf1dSJohannes Schlüter; Turning on this setting and managing its maximum buffer size can yield some
198c3fcaf1dSJohannes Schlüter; interesting side-effects depending on your application and web server.
199c3fcaf1dSJohannes Schlüter; You may be able to send headers and cookies after you've already sent output
200c3fcaf1dSJohannes Schlüter; through print or echo. You also may see performance benefits if your server is
201c3fcaf1dSJohannes Schlüter; emitting less packets due to buffered output versus PHP streaming the output
202c3fcaf1dSJohannes Schlüter; as it gets it. On production servers, 4096 bytes is a good setting for performance
203c3fcaf1dSJohannes Schlüter; reasons.
204c3fcaf1dSJohannes Schlüter; Note: Output buffering can also be controlled via Output Buffering Control
205c3fcaf1dSJohannes Schlüter;   functions.
206c3fcaf1dSJohannes Schlüter; Possible Values:
207c3fcaf1dSJohannes Schlüter;   On = Enabled and buffer is unlimited. (Use with caution)
208c3fcaf1dSJohannes Schlüter;   Off = Disabled
209c3fcaf1dSJohannes Schlüter;   Integer = Enables the buffer and sets its maximum size in bytes.
210d038c5f0SHannes Magnusson; Note: This directive is hardcoded to Off for the CLI SAPI
211c3fcaf1dSJohannes Schlüter; Default Value: Off
212c3fcaf1dSJohannes Schlüter; Development Value: 4096
213c3fcaf1dSJohannes Schlüter; Production Value: 4096
214c1ccccc6SPhilip Olson; http://php.net/output-buffering
215c3fcaf1dSJohannes Schlüteroutput_buffering = 4096
216c3fcaf1dSJohannes Schlüter
217c3fcaf1dSJohannes Schlüter; You can redirect all of the output of your scripts to a function.  For
218c3fcaf1dSJohannes Schlüter; example, if you set output_handler to "mb_output_handler", character
219c3fcaf1dSJohannes Schlüter; encoding will be transparently converted to the specified encoding.
220c3fcaf1dSJohannes Schlüter; Setting any output handler automatically turns on output buffering.
221c3fcaf1dSJohannes Schlüter; Note: People who wrote portable scripts should not depend on this ini
222c3fcaf1dSJohannes Schlüter;   directive. Instead, explicitly set the output handler using ob_start().
223c3fcaf1dSJohannes Schlüter;   Using this ini directive may cause problems unless you know what script
224c3fcaf1dSJohannes Schlüter;   is doing.
225c3fcaf1dSJohannes Schlüter; Note: You cannot use both "mb_output_handler" with "ob_iconv_handler"
226c3fcaf1dSJohannes Schlüter;   and you cannot use both "ob_gzhandler" and "zlib.output_compression".
227c3fcaf1dSJohannes Schlüter; Note: output_handler must be empty if this is set 'On' !!!!
228c3fcaf1dSJohannes Schlüter;   Instead you must use zlib.output_handler.
229c1ccccc6SPhilip Olson; http://php.net/output-handler
230c3fcaf1dSJohannes Schlüter;output_handler =
231c3fcaf1dSJohannes Schlüter
232a53a6b3fSYasuo Ohgaki; URL rewriter function rewrites URL on the fly by using
233a53a6b3fSYasuo Ohgaki; output buffer. You can set target tags by this configuration.
234a53a6b3fSYasuo Ohgaki; "form" tag is special tag. It will add hidden input tag to pass values.
235a53a6b3fSYasuo Ohgaki; Refer to session.trans_sid_tags for usage.
236a53a6b3fSYasuo Ohgaki; Default Value: "form="
237a53a6b3fSYasuo Ohgaki; Development Value: "form="
238a53a6b3fSYasuo Ohgaki; Production Value: "form="
239a53a6b3fSYasuo Ohgaki;url_rewriter.tags
240a53a6b3fSYasuo Ohgaki
24158c778baSMichael Smith; URL rewriter will not rewrite absolute URL nor form by default. To enable
242a53a6b3fSYasuo Ohgaki; absolute URL rewrite, allowed hosts must be defined at RUNTIME.
243a53a6b3fSYasuo Ohgaki; Refer to session.trans_sid_hosts for more details.
244a53a6b3fSYasuo Ohgaki; Default Value: ""
245a53a6b3fSYasuo Ohgaki; Development Value: ""
246a53a6b3fSYasuo Ohgaki; Production Value: ""
247a53a6b3fSYasuo Ohgaki;url_rewriter.hosts
248a53a6b3fSYasuo Ohgaki
249c3fcaf1dSJohannes Schlüter; Transparent output compression using the zlib library
250c3fcaf1dSJohannes Schlüter; Valid values for this option are 'off', 'on', or a specific buffer size
251c3fcaf1dSJohannes Schlüter; to be used for compression (default is 4KB)
252c3fcaf1dSJohannes Schlüter; Note: Resulting chunk size may vary due to nature of compression. PHP
253c3fcaf1dSJohannes Schlüter;   outputs chunks that are few hundreds bytes each as a result of
254c3fcaf1dSJohannes Schlüter;   compression. If you prefer a larger chunk size for better
255c3fcaf1dSJohannes Schlüter;   performance, enable output_buffering in addition.
256c3fcaf1dSJohannes Schlüter; Note: You need to use zlib.output_handler instead of the standard
257c3fcaf1dSJohannes Schlüter;   output_handler, or otherwise the output will be corrupted.
258c1ccccc6SPhilip Olson; http://php.net/zlib.output-compression
259c3fcaf1dSJohannes Schlüterzlib.output_compression = Off
260c3fcaf1dSJohannes Schlüter
261c1ccccc6SPhilip Olson; http://php.net/zlib.output-compression-level
262c3fcaf1dSJohannes Schlüter;zlib.output_compression_level = -1
263c3fcaf1dSJohannes Schlüter
264c3fcaf1dSJohannes Schlüter; You cannot specify additional output handlers if zlib.output_compression
265c3fcaf1dSJohannes Schlüter; is activated here. This setting does the same as output_handler but in
266c3fcaf1dSJohannes Schlüter; a different order.
267c1ccccc6SPhilip Olson; http://php.net/zlib.output-handler
268c3fcaf1dSJohannes Schlüter;zlib.output_handler =
269c3fcaf1dSJohannes Schlüter
270c3fcaf1dSJohannes Schlüter; Implicit flush tells PHP to tell the output layer to flush itself
271c3fcaf1dSJohannes Schlüter; automatically after every output block.  This is equivalent to calling the
272c3fcaf1dSJohannes Schlüter; PHP function flush() after each and every call to print() or echo() and each
273c3fcaf1dSJohannes Schlüter; and every HTML block.  Turning this option on has serious performance
274c3fcaf1dSJohannes Schlüter; implications and is generally recommended for debugging purposes only.
275c1ccccc6SPhilip Olson; http://php.net/implicit-flush
276d038c5f0SHannes Magnusson; Note: This directive is hardcoded to On for the CLI SAPI
277c3fcaf1dSJohannes Schlüterimplicit_flush = Off
278c3fcaf1dSJohannes Schlüter
279c3fcaf1dSJohannes Schlüter; The unserialize callback function will be called (with the undefined class'
280c3fcaf1dSJohannes Schlüter; name as parameter), if the unserializer finds an undefined class
281c3fcaf1dSJohannes Schlüter; which should be instantiated. A warning appears if the specified function is
282c3fcaf1dSJohannes Schlüter; not defined, or if the function doesn't include/implement the missing class.
283c3fcaf1dSJohannes Schlüter; So only set this entry, if you really want to implement such a
284c3fcaf1dSJohannes Schlüter; callback-function.
285c3fcaf1dSJohannes Schlüterunserialize_callback_func =
286c3fcaf1dSJohannes Schlüter
2871806ce9cSNikita Popov; The unserialize_max_depth specifies the default depth limit for unserialized
2881806ce9cSNikita Popov; structures. Setting the depth limit too high may result in stack overflows
2891806ce9cSNikita Popov; during unserialization. The unserialize_max_depth ini setting can be
2901806ce9cSNikita Popov; overridden by the max_depth option on individual unserialize() calls.
2911806ce9cSNikita Popov; A value of 0 disables the depth limit.
2921806ce9cSNikita Popov;unserialize_max_depth = 4096
2931806ce9cSNikita Popov
294edfa87ebSadrian; When floats & doubles are serialized, store serialize_precision significant
295c3fcaf1dSJohannes Schlüter; digits after the floating point. The default value ensures that when floats
296c3fcaf1dSJohannes Schlüter; are decoded with unserialize, the data will remain the same.
297158b537cSJakub Zelenka; The value is also used for json_encode when encoding double values.
298158b537cSJakub Zelenka; If -1 is used, then dtoa mode 0 is used which automatically select the best
299158b537cSJakub Zelenka; precision.
300158b537cSJakub Zelenkaserialize_precision = -1
301c3fcaf1dSJohannes Schlüter
302c3fcaf1dSJohannes Schlüter; open_basedir, if set, limits all file operations to the defined directory
303c3fcaf1dSJohannes Schlüter; and below.  This directive makes most sense if used in a per-directory
3046d148f7eSSobak; or per-virtualhost web server configuration file.
3055ac9990dSwbob; Note: disables the realpath cache
306c1ccccc6SPhilip Olson; http://php.net/open-basedir
307c3fcaf1dSJohannes Schlüter;open_basedir =
308c3fcaf1dSJohannes Schlüter
309038ca4bbSjsmmo; This directive allows you to disable certain functions.
3106d148f7eSSobak; It receives a comma-delimited list of function names.
311c1ccccc6SPhilip Olson; http://php.net/disable-functions
312c3fcaf1dSJohannes Schlüterdisable_functions =
313c3fcaf1dSJohannes Schlüter
314038ca4bbSjsmmo; This directive allows you to disable certain classes.
3156d148f7eSSobak; It receives a comma-delimited list of class names.
316c1ccccc6SPhilip Olson; http://php.net/disable-classes
317c3fcaf1dSJohannes Schlüterdisable_classes =
318c3fcaf1dSJohannes Schlüter
319c3fcaf1dSJohannes Schlüter; Colors for Syntax Highlighting mode.  Anything that's acceptable in
320c3fcaf1dSJohannes Schlüter; <span style="color: ???????"> would work.
321c1ccccc6SPhilip Olson; http://php.net/syntax-highlighting
322c3fcaf1dSJohannes Schlüter;highlight.string  = #DD0000
323c3fcaf1dSJohannes Schlüter;highlight.comment = #FF9900
324c3fcaf1dSJohannes Schlüter;highlight.keyword = #007700
325c3fcaf1dSJohannes Schlüter;highlight.default = #0000BB
326c3fcaf1dSJohannes Schlüter;highlight.html    = #000000
327c3fcaf1dSJohannes Schlüter
328c3fcaf1dSJohannes Schlüter; If enabled, the request will be allowed to complete even if the user aborts
329c3fcaf1dSJohannes Schlüter; the request. Consider enabling it if executing long requests, which may end up
330c3fcaf1dSJohannes Schlüter; being interrupted by the user or a browser timing out. PHP's default behavior
331c3fcaf1dSJohannes Schlüter; is to disable this feature.
332c1ccccc6SPhilip Olson; http://php.net/ignore-user-abort
333c3fcaf1dSJohannes Schlüter;ignore_user_abort = On
334c3fcaf1dSJohannes Schlüter
335c3fcaf1dSJohannes Schlüter; Determines the size of the realpath cache to be used by PHP. This value should
336c3fcaf1dSJohannes Schlüter; be increased on systems where PHP opens many files to reflect the quantity of
337c3fcaf1dSJohannes Schlüter; the file operations performed.
3385ac9990dSwbob; Note: if open_basedir is set, the cache is disabled
339c1ccccc6SPhilip Olson; http://php.net/realpath-cache-size
34081fb61f9SMarkus Staab;realpath_cache_size = 4096k
341c3fcaf1dSJohannes Schlüter
342c3fcaf1dSJohannes Schlüter; Duration of time, in seconds for which to cache realpath information for a given
343c3fcaf1dSJohannes Schlüter; file or directory. For systems with rarely changing files, consider increasing this
344c3fcaf1dSJohannes Schlüter; value.
345c1ccccc6SPhilip Olson; http://php.net/realpath-cache-ttl
346c3fcaf1dSJohannes Schlüter;realpath_cache_ttl = 120
347c3fcaf1dSJohannes Schlüter
3486b7d4bd3SHannes Magnusson; Enables or disables the circular reference collector.
3496b7d4bd3SHannes Magnusson; http://php.net/zend.enable-gc
3506b7d4bd3SHannes Magnussonzend.enable_gc = On
3516b7d4bd3SHannes Magnusson
352b0f8ac52SMoriyoshi Koizumi; If enabled, scripts may be written in encodings that are incompatible with
353b0f8ac52SMoriyoshi Koizumi; the scanner.  CP936, Big5, CP949 and Shift_JIS are the examples of such
354b0f8ac52SMoriyoshi Koizumi; encodings.  To use this feature, mbstring extension must be enabled.
355b0f8ac52SMoriyoshi Koizumi; Default: Off
356b0f8ac52SMoriyoshi Koizumi;zend.multibyte = Off
357b0f8ac52SMoriyoshi Koizumi
358b0f8ac52SMoriyoshi Koizumi; Allows to set the default encoding for the scripts.  This value will be used
359b0f8ac52SMoriyoshi Koizumi; unless "declare(encoding=...)" directive appears at the top of the script.
360b0f8ac52SMoriyoshi Koizumi; Only affects if zend.multibyte is set.
361b0f8ac52SMoriyoshi Koizumi; Default: ""
362b0f8ac52SMoriyoshi Koizumi;zend.script_encoding =
363b0f8ac52SMoriyoshi Koizumi
364205556c1SGiovanni Giacobbi; Allows to include or exclude arguments from stack traces generated for exceptions.
3650819e6dcSJoe Watkins; In production, it is recommended to turn this setting on to prohibit the output
3660819e6dcSJoe Watkins; of sensitive information in stack traces
367205556c1SGiovanni Giacobbi; Default: Off
3680819e6dcSJoe Watkinszend.exception_ignore_args = On
3690819e6dcSJoe Watkins
370c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;
371c3fcaf1dSJohannes Schlüter; Miscellaneous ;
372c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;
373c3fcaf1dSJohannes Schlüter
374c3fcaf1dSJohannes Schlüter; Decides whether PHP may expose the fact that it is installed on the server
375c3fcaf1dSJohannes Schlüter; (e.g. by adding its signature to the Web server header).  It is no security
376c3fcaf1dSJohannes Schlüter; threat in any way, but it makes it possible to determine whether you use PHP
377c3fcaf1dSJohannes Schlüter; on your server or not.
378c1ccccc6SPhilip Olson; http://php.net/expose-php
379c3fcaf1dSJohannes Schlüterexpose_php = On
380c3fcaf1dSJohannes Schlüter
381c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
382c3fcaf1dSJohannes Schlüter; Resource Limits ;
383c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
384c3fcaf1dSJohannes Schlüter
385c3fcaf1dSJohannes Schlüter; Maximum execution time of each script, in seconds
386c1ccccc6SPhilip Olson; http://php.net/max-execution-time
387d038c5f0SHannes Magnusson; Note: This directive is hardcoded to 0 for the CLI SAPI
38884dcca9fSLukas Smithmax_execution_time = 30
389c3fcaf1dSJohannes Schlüter
390c3fcaf1dSJohannes Schlüter; Maximum amount of time each script may spend parsing request data. It's a good
391c3fcaf1dSJohannes Schlüter; idea to limit this time on productions servers in order to eliminate unexpectedly
39284dcca9fSLukas Smith; long running scripts.
393d038c5f0SHannes Magnusson; Note: This directive is hardcoded to -1 for the CLI SAPI
394c3fcaf1dSJohannes Schlüter; Default Value: -1 (Unlimited)
395c3fcaf1dSJohannes Schlüter; Development Value: 60 (60 seconds)
396c3fcaf1dSJohannes Schlüter; Production Value: 60 (60 seconds)
397c1ccccc6SPhilip Olson; http://php.net/max-input-time
398c3fcaf1dSJohannes Schlütermax_input_time = 60
399c3fcaf1dSJohannes Schlüter
400c3fcaf1dSJohannes Schlüter; Maximum input variable nesting level
401c1ccccc6SPhilip Olson; http://php.net/max-input-nesting-level
402c3fcaf1dSJohannes Schlüter;max_input_nesting_level = 64
403c3fcaf1dSJohannes Schlüter
404a099e0d2SDmitry Stogov; How many GET/POST/COOKIE input variables may be accepted
405ca21ba3fSsundarchi;max_input_vars = 1000
406a099e0d2SDmitry Stogov
40761e76927SMichael Voříšek; Maximum amount of memory a script may consume
408c1ccccc6SPhilip Olson; http://php.net/memory-limit
409c3fcaf1dSJohannes Schlütermemory_limit = 128M
410c3fcaf1dSJohannes Schlüter
411c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
412c3fcaf1dSJohannes Schlüter; Error handling and logging ;
413c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
414c3fcaf1dSJohannes Schlüter
415c3fcaf1dSJohannes Schlüter; This directive informs PHP of which errors, warnings and notices you would like
416c3fcaf1dSJohannes Schlüter; it to take action for. The recommended way of setting values for this
417c3fcaf1dSJohannes Schlüter; directive is through the use of the error level constants and bitwise
418c3fcaf1dSJohannes Schlüter; operators. The error level constants are below here for convenience as well as
419c3fcaf1dSJohannes Schlüter; some common settings and their meanings.
420c3fcaf1dSJohannes Schlüter; By default, PHP is set to take action on all errors, notices and warnings EXCEPT
421c3fcaf1dSJohannes Schlüter; those related to E_NOTICE and E_STRICT, which together cover best practices and
422c3fcaf1dSJohannes Schlüter; recommended coding standards in PHP. For performance reasons, this is the
423c3fcaf1dSJohannes Schlüter; recommend error reporting setting. Your production server shouldn't be wasting
424c3fcaf1dSJohannes Schlüter; resources complaining about best practices and coding standards. That's what
425c3fcaf1dSJohannes Schlüter; development servers and development settings are for.
4267bb8f9eeSStanislav Malyshev; Note: The php.ini-development file has this setting as E_ALL. This
427c3fcaf1dSJohannes Schlüter; means it pretty much reports everything which is exactly what you want during
428c3fcaf1dSJohannes Schlüter; development and early testing.
429c3fcaf1dSJohannes Schlüter;
430c3fcaf1dSJohannes Schlüter; Error Level Constants:
43132c6c165SChristopher Jones; E_ALL             - All errors and warnings (includes E_STRICT as of PHP 5.4.0)
432c3fcaf1dSJohannes Schlüter; E_ERROR           - fatal run-time errors
433c3fcaf1dSJohannes Schlüter; E_RECOVERABLE_ERROR  - almost fatal run-time errors
434c3fcaf1dSJohannes Schlüter; E_WARNING         - run-time warnings (non-fatal errors)
435c3fcaf1dSJohannes Schlüter; E_PARSE           - compile-time parse errors
436c3fcaf1dSJohannes Schlüter; E_NOTICE          - run-time notices (these are warnings which often result
437c3fcaf1dSJohannes Schlüter;                     from a bug in your code, but it's possible that it was
438c3fcaf1dSJohannes Schlüter;                     intentional (e.g., using an uninitialized variable and
439d0727b58SBryan Hanks, PMP;                     relying on the fact it is automatically initialized to an
440c3fcaf1dSJohannes Schlüter;                     empty string)
441c3fcaf1dSJohannes Schlüter; E_STRICT          - run-time notices, enable to have PHP suggest changes
442c3fcaf1dSJohannes Schlüter;                     to your code which will ensure the best interoperability
443c3fcaf1dSJohannes Schlüter;                     and forward compatibility of your code
444c3fcaf1dSJohannes Schlüter; E_CORE_ERROR      - fatal errors that occur during PHP's initial startup
445c3fcaf1dSJohannes Schlüter; E_CORE_WARNING    - warnings (non-fatal errors) that occur during PHP's
446c3fcaf1dSJohannes Schlüter;                     initial startup
447c3fcaf1dSJohannes Schlüter; E_COMPILE_ERROR   - fatal compile-time errors
448c3fcaf1dSJohannes Schlüter; E_COMPILE_WARNING - compile-time warnings (non-fatal errors)
449c3fcaf1dSJohannes Schlüter; E_USER_ERROR      - user-generated error message
450c3fcaf1dSJohannes Schlüter; E_USER_WARNING    - user-generated warning message
451c3fcaf1dSJohannes Schlüter; E_USER_NOTICE     - user-generated notice message
452c3fcaf1dSJohannes Schlüter; E_DEPRECATED      - warn about code that will not work in future versions
453c3fcaf1dSJohannes Schlüter;                     of PHP
454c3fcaf1dSJohannes Schlüter; E_USER_DEPRECATED - user-generated deprecation warnings
455c3fcaf1dSJohannes Schlüter;
456c3fcaf1dSJohannes Schlüter; Common Values:
4577bb8f9eeSStanislav Malyshev;   E_ALL (Show all errors, warnings and notices including coding standards.)
4587bb8f9eeSStanislav Malyshev;   E_ALL & ~E_NOTICE  (Show all errors, except for notices)
4597bb8f9eeSStanislav Malyshev;   E_ALL & ~E_NOTICE & ~E_STRICT  (Show all errors, except for notices and coding standards warnings.)
460c3fcaf1dSJohannes Schlüter;   E_COMPILE_ERROR|E_RECOVERABLE_ERROR|E_ERROR|E_CORE_ERROR  (Show only errors)
4617bb8f9eeSStanislav Malyshev; Default Value: E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
4627bb8f9eeSStanislav Malyshev; Development Value: E_ALL
4633f43c3efSStanislav Malyshev; Production Value: E_ALL & ~E_DEPRECATED & ~E_STRICT
464c1ccccc6SPhilip Olson; http://php.net/error-reporting
4653f43c3efSStanislav Malysheverror_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
466c3fcaf1dSJohannes Schlüter
467c3fcaf1dSJohannes Schlüter; This directive controls whether or not and where PHP will output errors,
468c3fcaf1dSJohannes Schlüter; notices and warnings too. Error output is very useful during development, but
469c3fcaf1dSJohannes Schlüter; it could be very dangerous in production environments. Depending on the code
470c3fcaf1dSJohannes Schlüter; which is triggering the error, sensitive information could potentially leak
471c3fcaf1dSJohannes Schlüter; out of your application such as database usernames and passwords or worse.
472d0727b58SBryan Hanks, PMP; For production environments, we recommend logging errors rather than
473d0727b58SBryan Hanks, PMP; sending them to STDOUT.
474c3fcaf1dSJohannes Schlüter; Possible Values:
47584dcca9fSLukas Smith;   Off = Do not display any errors
47684dcca9fSLukas Smith;   stderr = Display errors to STDERR (affects only CGI/CLI binaries!)
477c3fcaf1dSJohannes Schlüter;   On or stdout = Display errors to STDOUT
478c3fcaf1dSJohannes Schlüter; Default Value: On
479c3fcaf1dSJohannes Schlüter; Development Value: On
480c3fcaf1dSJohannes Schlüter; Production Value: Off
481c1ccccc6SPhilip Olson; http://php.net/display-errors
482c3fcaf1dSJohannes Schlüterdisplay_errors = Off
483c3fcaf1dSJohannes Schlüter
484c3fcaf1dSJohannes Schlüter; The display of errors which occur during PHP's startup sequence are handled
485c3fcaf1dSJohannes Schlüter; separately from display_errors. PHP's default behavior is to suppress those
486c3fcaf1dSJohannes Schlüter; errors from clients. Turning the display of startup errors on can be useful in
487d0727b58SBryan Hanks, PMP; debugging configuration problems. We strongly recommend you
488d0727b58SBryan Hanks, PMP; set this to 'off' for production servers.
489c3fcaf1dSJohannes Schlüter; Default Value: Off
490c3fcaf1dSJohannes Schlüter; Development Value: On
491c3fcaf1dSJohannes Schlüter; Production Value: Off
492c1ccccc6SPhilip Olson; http://php.net/display-startup-errors
493c3fcaf1dSJohannes Schlüterdisplay_startup_errors = Off
494c3fcaf1dSJohannes Schlüter
495c3fcaf1dSJohannes Schlüter; Besides displaying errors, PHP can also log errors to locations such as a
496c3fcaf1dSJohannes Schlüter; server-specific log, STDERR, or a location specified by the error_log
497c3fcaf1dSJohannes Schlüter; directive found below. While errors should not be displayed on productions
498c3fcaf1dSJohannes Schlüter; servers they should still be monitored and logging is a great way to do that.
499c3fcaf1dSJohannes Schlüter; Default Value: Off
500c3fcaf1dSJohannes Schlüter; Development Value: On
501c3fcaf1dSJohannes Schlüter; Production Value: On
502c1ccccc6SPhilip Olson; http://php.net/log-errors
503c3fcaf1dSJohannes Schlüterlog_errors = On
504c3fcaf1dSJohannes Schlüter
505c3fcaf1dSJohannes Schlüter; Set maximum length of log_errors. In error_log information about the source is
506c3fcaf1dSJohannes Schlüter; added. The default is 1024 and 0 allows to not apply any maximum length at all.
507c1ccccc6SPhilip Olson; http://php.net/log-errors-max-len
508c3fcaf1dSJohannes Schlüterlog_errors_max_len = 1024
509c3fcaf1dSJohannes Schlüter
510c3fcaf1dSJohannes Schlüter; Do not log repeated messages. Repeated errors must occur in same file on same
511c3fcaf1dSJohannes Schlüter; line unless ignore_repeated_source is set true.
512c1ccccc6SPhilip Olson; http://php.net/ignore-repeated-errors
513c3fcaf1dSJohannes Schlüterignore_repeated_errors = Off
514c3fcaf1dSJohannes Schlüter
515c3fcaf1dSJohannes Schlüter; Ignore source of message when ignoring repeated messages. When this setting
516c3fcaf1dSJohannes Schlüter; is On you will not log errors with repeated messages from different files or
517c3fcaf1dSJohannes Schlüter; source lines.
518c1ccccc6SPhilip Olson; http://php.net/ignore-repeated-source
519c3fcaf1dSJohannes Schlüterignore_repeated_source = Off
520c3fcaf1dSJohannes Schlüter
521c3fcaf1dSJohannes Schlüter; If this parameter is set to Off, then memory leaks will not be shown (on
522318b34daSTiffany; stdout or in the log). This is only effective in a debug compile, and if
523c3fcaf1dSJohannes Schlüter; error reporting includes E_WARNING in the allowed list
524c1ccccc6SPhilip Olson; http://php.net/report-memleaks
525c3fcaf1dSJohannes Schlüterreport_memleaks = On
526c3fcaf1dSJohannes Schlüter
527c3fcaf1dSJohannes Schlüter; This setting is on by default.
528c3fcaf1dSJohannes Schlüter;report_zend_debug = 0
529c3fcaf1dSJohannes Schlüter
530c3fcaf1dSJohannes Schlüter; Store the last error/warning message in $php_errormsg (boolean). Setting this value
531c3fcaf1dSJohannes Schlüter; to On can assist in debugging and is appropriate for development servers. It should
532c3fcaf1dSJohannes Schlüter; however be disabled on production servers.
53347a1ab36Sekinhbayar; This directive is DEPRECATED.
534c3fcaf1dSJohannes Schlüter; Default Value: Off
53547a1ab36Sekinhbayar; Development Value: Off
536c3fcaf1dSJohannes Schlüter; Production Value: Off
537c1ccccc6SPhilip Olson; http://php.net/track-errors
53847a1ab36Sekinhbayar;track_errors = Off
539c3fcaf1dSJohannes Schlüter
540c3fcaf1dSJohannes Schlüter; Turn off normal error reporting and emit XML-RPC error XML
541c1ccccc6SPhilip Olson; http://php.net/xmlrpc-errors
542c3fcaf1dSJohannes Schlüter;xmlrpc_errors = 0
543c3fcaf1dSJohannes Schlüter
544c3fcaf1dSJohannes Schlüter; An XML-RPC faultCode
545c3fcaf1dSJohannes Schlüter;xmlrpc_error_number = 0
546c3fcaf1dSJohannes Schlüter
547840ef1e3SDerick Rethans; When PHP displays or logs an error, it has the capability of formatting the
548840ef1e3SDerick Rethans; error message as HTML for easier reading. This directive controls whether
549840ef1e3SDerick Rethans; the error message is formatted as HTML or not.
550d038c5f0SHannes Magnusson; Note: This directive is hardcoded to Off for the CLI SAPI
551c1ccccc6SPhilip Olson; http://php.net/html-errors
5528b8d5a4bSGeorge Peter Banyard;html_errors = On
553c3fcaf1dSJohannes Schlüter
554840ef1e3SDerick Rethans; If html_errors is set to On *and* docref_root is not empty, then PHP
555840ef1e3SDerick Rethans; produces clickable error messages that direct to a page describing the error
556840ef1e3SDerick Rethans; or function causing the error in detail.
557c1ccccc6SPhilip Olson; You can download a copy of the PHP manual from http://php.net/docs
558c3fcaf1dSJohannes Schlüter; and change docref_root to the base URL of your local copy including the
559c3fcaf1dSJohannes Schlüter; leading '/'. You must also specify the file extension being used including
560840ef1e3SDerick Rethans; the dot. PHP's default behavior is to leave these settings empty, in which
561840ef1e3SDerick Rethans; case no links to documentation are generated.
562c3fcaf1dSJohannes Schlüter; Note: Never use this feature for production boxes.
563c1ccccc6SPhilip Olson; http://php.net/docref-root
564c3fcaf1dSJohannes Schlüter; Examples
565c3fcaf1dSJohannes Schlüter;docref_root = "/phpmanual/"
566c3fcaf1dSJohannes Schlüter
567c1ccccc6SPhilip Olson; http://php.net/docref-ext
568c3fcaf1dSJohannes Schlüter;docref_ext = .html
569c3fcaf1dSJohannes Schlüter
570c3fcaf1dSJohannes Schlüter; String to output before an error message. PHP's default behavior is to leave
571c3fcaf1dSJohannes Schlüter; this setting blank.
572c1ccccc6SPhilip Olson; http://php.net/error-prepend-string
573c3fcaf1dSJohannes Schlüter; Example:
574abf0ea01SAdam Harvey;error_prepend_string = "<span style='color: #ff0000'>"
575c3fcaf1dSJohannes Schlüter
576c3fcaf1dSJohannes Schlüter; String to output after an error message. PHP's default behavior is to leave
577c3fcaf1dSJohannes Schlüter; this setting blank.
578c1ccccc6SPhilip Olson; http://php.net/error-append-string
579c3fcaf1dSJohannes Schlüter; Example:
580abf0ea01SAdam Harvey;error_append_string = "</span>"
581c3fcaf1dSJohannes Schlüter
582c3fcaf1dSJohannes Schlüter; Log errors to specified file. PHP's default behavior is to leave this value
583c3fcaf1dSJohannes Schlüter; empty.
584c1ccccc6SPhilip Olson; http://php.net/error-log
585c3fcaf1dSJohannes Schlüter; Example:
586c3fcaf1dSJohannes Schlüter;error_log = php_errors.log
58795c57bb6SAnatol Belski; Log errors to syslog (Event Log on Windows).
588c3fcaf1dSJohannes Schlüter;error_log = syslog
589ce0721beSJakub Zelenka
590ce0721beSJakub Zelenka; The syslog ident is a string which is prepended to every message logged
591ce0721beSJakub Zelenka; to syslog. Only used when error_log is set to syslog.
5922475337bSPhilip Prindeville;syslog.ident = php
593ce0721beSJakub Zelenka
59437c329d7SPeter Kokot; The syslog facility is used to specify what type of program is logging
595ce0721beSJakub Zelenka; the message. Only used when error_log is set to syslog.
5962475337bSPhilip Prindeville;syslog.facility = user
597c3fcaf1dSJohannes Schlüter
598c8550438SJakub Zelenka; Set this to disable filtering control characters (the default).
599c8550438SJakub Zelenka; Some loggers only accept NVT-ASCII, others accept anything that's not
600c8550438SJakub Zelenka; control characters. If your logger accepts everything, then no filtering
601c8550438SJakub Zelenka; is needed at all.
602c8550438SJakub Zelenka; Allowed values are:
603ad2d2e41SChristoph M. Becker;   ascii (all printable ASCII characters and NL)
604ad2d2e41SChristoph M. Becker;   no-ctrl (all characters except control characters)
605c8550438SJakub Zelenka;   all (all characters)
6069f0515c4SErik Lundin;   raw (like "all", but messages are not split at newlines)
607ad2d2e41SChristoph M. Becker; http://php.net/syslog.filter
608c8550438SJakub Zelenka;syslog.filter = ascii
609c8550438SJakub Zelenka
610d9e955c6SChristopher Jones;windows.show_crt_warning
611d9e955c6SChristopher Jones; Default value: 0
612d9e955c6SChristopher Jones; Development value: 0
613d9e955c6SChristopher Jones; Production value: 0
614d9e955c6SChristopher Jones
615c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;
616c3fcaf1dSJohannes Schlüter; Data Handling ;
617c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;
618c3fcaf1dSJohannes Schlüter
619c3fcaf1dSJohannes Schlüter; The separator used in PHP generated URLs to separate arguments.
620c3fcaf1dSJohannes Schlüter; PHP's default setting is "&".
621c1ccccc6SPhilip Olson; http://php.net/arg-separator.output
622c3fcaf1dSJohannes Schlüter; Example:
623c3fcaf1dSJohannes Schlüter;arg_separator.output = "&amp;"
624c3fcaf1dSJohannes Schlüter
625c3fcaf1dSJohannes Schlüter; List of separator(s) used by PHP to parse input URLs into variables.
626c3fcaf1dSJohannes Schlüter; PHP's default setting is "&".
627c3fcaf1dSJohannes Schlüter; NOTE: Every character in this directive is considered as separator!
628c1ccccc6SPhilip Olson; http://php.net/arg-separator.input
629c3fcaf1dSJohannes Schlüter; Example:
630c3fcaf1dSJohannes Schlüter;arg_separator.input = ";&"
631c3fcaf1dSJohannes Schlüter
632c3fcaf1dSJohannes Schlüter; This directive determines which super global arrays are registered when PHP
6339ef050caSPatrick Allaert; starts up. G,P,C,E & S are abbreviations for the following respective super
6349ef050caSPatrick Allaert; globals: GET, POST, COOKIE, ENV and SERVER. There is a performance penalty
6358f545a74SPeter Cowburn; paid for the registration of these arrays and because ENV is not as commonly
63613683644SPierrick Charron; used as the others, ENV is not recommended on productions servers. You
6379ef050caSPatrick Allaert; can still get access to the environment variables through getenv() should you
638febee112SKalle Sommer Nielsen; need to.
639c3fcaf1dSJohannes Schlüter; Default Value: "EGPCS"
640c3fcaf1dSJohannes Schlüter; Development Value: "GPCS"
641c3fcaf1dSJohannes Schlüter; Production Value: "GPCS";
642c1ccccc6SPhilip Olson; http://php.net/variables-order
643c3fcaf1dSJohannes Schlütervariables_order = "GPCS"
644c3fcaf1dSJohannes Schlüter
6457386b74bSReeze Xia; This directive determines which super global data (G,P & C) should be
6467386b74bSReeze Xia; registered into the super global array REQUEST. If so, it also determines
6477386b74bSReeze Xia; the order in which that data is registered. The values for this directive
6487386b74bSReeze Xia; are specified in the same manner as the variables_order directive,
6497386b74bSReeze Xia; EXCEPT one. Leaving this value empty will cause PHP to use the value set
6507386b74bSReeze Xia; in the variables_order directive. It does not mean it will leave the super
6517386b74bSReeze Xia; globals array REQUEST empty.
652c3fcaf1dSJohannes Schlüter; Default Value: None
653c3fcaf1dSJohannes Schlüter; Development Value: "GP"
654c3fcaf1dSJohannes Schlüter; Production Value: "GP"
655c1ccccc6SPhilip Olson; http://php.net/request-order
656c3fcaf1dSJohannes Schlüterrequest_order = "GP"
657c3fcaf1dSJohannes Schlüter
658c3fcaf1dSJohannes Schlüter; This directive determines whether PHP registers $argv & $argc each time it
659c3fcaf1dSJohannes Schlüter; runs. $argv contains an array of all the arguments passed to PHP when a script
660c3fcaf1dSJohannes Schlüter; is invoked. $argc contains an integer representing the number of arguments
661c3fcaf1dSJohannes Schlüter; that were passed when the script was invoked. These arrays are extremely
662c3fcaf1dSJohannes Schlüter; useful when running scripts from the command line. When this directive is
663c3fcaf1dSJohannes Schlüter; enabled, registering these variables consumes CPU cycles and memory each time
664c3fcaf1dSJohannes Schlüter; a script is executed. For performance reasons, this feature should be disabled
665c3fcaf1dSJohannes Schlüter; on production servers.
666d038c5f0SHannes Magnusson; Note: This directive is hardcoded to On for the CLI SAPI
667c3fcaf1dSJohannes Schlüter; Default Value: On
668c3fcaf1dSJohannes Schlüter; Development Value: Off
669c3fcaf1dSJohannes Schlüter; Production Value: Off
670c1ccccc6SPhilip Olson; http://php.net/register-argc-argv
671c3fcaf1dSJohannes Schlüterregister_argc_argv = Off
672c3fcaf1dSJohannes Schlüter
673ab80d4e4SJani Taskinen; When enabled, the ENV, REQUEST and SERVER variables are created when they're
674ab80d4e4SJani Taskinen; first used (Just In Time) instead of when the script starts. If these
675ab80d4e4SJani Taskinen; variables are not used within a script, having this directive on will result
676ab80d4e4SJani Taskinen; in a performance gain. The PHP directive register_argc_argv must be disabled
677318b34daSTiffany; for this directive to have any effect.
678c1ccccc6SPhilip Olson; http://php.net/auto-globals-jit
679c3fcaf1dSJohannes Schlüterauto_globals_jit = On
680c3fcaf1dSJohannes Schlüter
681c8622a07SGustavo André dos Santos Lopes; Whether PHP will read the POST data.
682c8622a07SGustavo André dos Santos Lopes; This option is enabled by default.
683c8622a07SGustavo André dos Santos Lopes; Most likely, you won't want to disable this option globally. It causes $_POST
684c8622a07SGustavo André dos Santos Lopes; and $_FILES to always be empty; the only way you will be able to read the
685c8622a07SGustavo André dos Santos Lopes; POST data will be through the php://input stream wrapper. This can be useful
686c8622a07SGustavo André dos Santos Lopes; to proxy requests or to process the POST data in a memory efficient fashion.
687c8622a07SGustavo André dos Santos Lopes; http://php.net/enable-post-data-reading
688c8622a07SGustavo André dos Santos Lopes;enable_post_data_reading = Off
689c8622a07SGustavo André dos Santos Lopes
690c3fcaf1dSJohannes Schlüter; Maximum size of POST data that PHP will accept.
691c8622a07SGustavo André dos Santos Lopes; Its value may be 0 to disable the limit. It is ignored if POST data reading
692c8622a07SGustavo André dos Santos Lopes; is disabled through enable_post_data_reading.
693c1ccccc6SPhilip Olson; http://php.net/post-max-size
694c3fcaf1dSJohannes Schlüterpost_max_size = 8M
695c3fcaf1dSJohannes Schlüter
696c3fcaf1dSJohannes Schlüter; Automatically add files before PHP document.
697c1ccccc6SPhilip Olson; http://php.net/auto-prepend-file
698c3fcaf1dSJohannes Schlüterauto_prepend_file =
699c3fcaf1dSJohannes Schlüter
700c3fcaf1dSJohannes Schlüter; Automatically add files after PHP document.
701c1ccccc6SPhilip Olson; http://php.net/auto-append-file
702c3fcaf1dSJohannes Schlüterauto_append_file =
703c3fcaf1dSJohannes Schlüter
7049306c1d2SThomas Punt; By default, PHP will output a media type using the Content-Type header. To
7059306c1d2SThomas Punt; disable this, simply set it to be empty.
706c3fcaf1dSJohannes Schlüter;
7079306c1d2SThomas Punt; PHP's built-in default media type is set to text/html.
708c1ccccc6SPhilip Olson; http://php.net/default-mimetype
709c3fcaf1dSJohannes Schlüterdefault_mimetype = "text/html"
710c3fcaf1dSJohannes Schlüter
7111e92b24aSChris McCafferty; PHP's default character set is set to UTF-8.
712c1ccccc6SPhilip Olson; http://php.net/default-charset
713cbd108abSYasuo Ohgakidefault_charset = "UTF-8"
714cbd108abSYasuo Ohgaki
715cbd108abSYasuo Ohgaki; PHP internal character encoding is set to empty.
716cbd108abSYasuo Ohgaki; If empty, default_charset is used.
717cbd108abSYasuo Ohgaki; http://php.net/internal-encoding
718cbd108abSYasuo Ohgaki;internal_encoding =
719cbd108abSYasuo Ohgaki
720cbd108abSYasuo Ohgaki; PHP input character encoding is set to empty.
7211e92b24aSChris McCafferty; If empty, default_charset is used.
722cbd108abSYasuo Ohgaki; http://php.net/input-encoding
723cbd108abSYasuo Ohgaki;input_encoding =
724cbd108abSYasuo Ohgaki
725cbd108abSYasuo Ohgaki; PHP output character encoding is set to empty.
7261e92b24aSChris McCafferty; If empty, default_charset is used.
727cbd108abSYasuo Ohgaki; See also output_buffer.
728cbd108abSYasuo Ohgaki; http://php.net/output-encoding
729cbd108abSYasuo Ohgaki;output_encoding =
730c3fcaf1dSJohannes Schlüter
731c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;;;;;;
732c3fcaf1dSJohannes Schlüter; Paths and Directories ;
733c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;;;;;;
734c3fcaf1dSJohannes Schlüter
735c3fcaf1dSJohannes Schlüter; UNIX: "/path1:/path2"
736c3fcaf1dSJohannes Schlüter;include_path = ".:/php/includes"
737c3fcaf1dSJohannes Schlüter;
738c3fcaf1dSJohannes Schlüter; Windows: "\path1;\path2"
739c3fcaf1dSJohannes Schlüter;include_path = ".;c:\php\includes"
740c3fcaf1dSJohannes Schlüter;
741c3fcaf1dSJohannes Schlüter; PHP's default setting for include_path is ".;/path/to/php/pear"
742c1ccccc6SPhilip Olson; http://php.net/include-path
743c3fcaf1dSJohannes Schlüter
744c3fcaf1dSJohannes Schlüter; The root of the PHP pages, used only if nonempty.
745c3fcaf1dSJohannes Schlüter; if PHP was not compiled with FORCE_REDIRECT, you SHOULD set doc_root
746c3fcaf1dSJohannes Schlüter; if you are running php as a CGI under any web server (other than IIS)
747c3fcaf1dSJohannes Schlüter; see documentation for security issues.  The alternate is to use the
748c3fcaf1dSJohannes Schlüter; cgi.force_redirect configuration below
749c1ccccc6SPhilip Olson; http://php.net/doc-root
750c3fcaf1dSJohannes Schlüterdoc_root =
751c3fcaf1dSJohannes Schlüter
752c3fcaf1dSJohannes Schlüter; The directory under which PHP opens the script using /~username used only
753c3fcaf1dSJohannes Schlüter; if nonempty.
754c1ccccc6SPhilip Olson; http://php.net/user-dir
755c3fcaf1dSJohannes Schlüteruser_dir =
756c3fcaf1dSJohannes Schlüter
757c3fcaf1dSJohannes Schlüter; Directory in which the loadable extensions (modules) reside.
758c1ccccc6SPhilip Olson; http://php.net/extension-dir
759ca21ba3fSsundarchi;extension_dir = "./"
7608991998dSPierre Joye; On windows:
761ca21ba3fSsundarchi;extension_dir = "ext"
762c3fcaf1dSJohannes Schlüter
763475a644bSALeX Kazik; Directory where the temporary files should be placed.
764475a644bSALeX Kazik; Defaults to the system default (see sys_get_temp_dir)
765ca21ba3fSsundarchi;sys_temp_dir = "/tmp"
766475a644bSALeX Kazik
767c3fcaf1dSJohannes Schlüter; Whether or not to enable the dl() function.  The dl() function does NOT work
768c3fcaf1dSJohannes Schlüter; properly in multithreaded servers, such as IIS or Zeus, and is automatically
769c3fcaf1dSJohannes Schlüter; disabled on them.
770c1ccccc6SPhilip Olson; http://php.net/enable-dl
771c3fcaf1dSJohannes Schlüterenable_dl = Off
772c3fcaf1dSJohannes Schlüter
773c3fcaf1dSJohannes Schlüter; cgi.force_redirect is necessary to provide security running PHP as a CGI under
774c3fcaf1dSJohannes Schlüter; most web servers.  Left undefined, PHP turns this on by default.  You can
775c3fcaf1dSJohannes Schlüter; turn it off here AT YOUR OWN RISK
776c3fcaf1dSJohannes Schlüter; **You CAN safely turn this off for IIS, in fact, you MUST.**
777c1ccccc6SPhilip Olson; http://php.net/cgi.force-redirect
778c3fcaf1dSJohannes Schlüter;cgi.force_redirect = 1
779c3fcaf1dSJohannes Schlüter
780c3fcaf1dSJohannes Schlüter; if cgi.nph is enabled it will force cgi to always sent Status: 200 with
781c3fcaf1dSJohannes Schlüter; every request. PHP's default behavior is to disable this feature.
782c3fcaf1dSJohannes Schlüter;cgi.nph = 1
783c3fcaf1dSJohannes Schlüter
784c3fcaf1dSJohannes Schlüter; if cgi.force_redirect is turned on, and you are not running under Apache or Netscape
785c3fcaf1dSJohannes Schlüter; (iPlanet) web servers, you MAY need to set an environment variable name that PHP
786c3fcaf1dSJohannes Schlüter; will look for to know it is OK to continue execution.  Setting this variable MAY
787c3fcaf1dSJohannes Schlüter; cause security issues, KNOW WHAT YOU ARE DOING FIRST.
788c1ccccc6SPhilip Olson; http://php.net/cgi.redirect-status-env
789c3547f19SXinchen Hui;cgi.redirect_status_env =
790c3fcaf1dSJohannes Schlüter
791c3fcaf1dSJohannes Schlüter; cgi.fix_pathinfo provides *real* PATH_INFO/PATH_TRANSLATED support for CGI.  PHP's
792c3fcaf1dSJohannes Schlüter; previous behaviour was to set PATH_TRANSLATED to SCRIPT_FILENAME, and to not grok
793c3fcaf1dSJohannes Schlüter; what PATH_INFO is.  For more information on PATH_INFO, see the cgi specs.  Setting
794c3fcaf1dSJohannes Schlüter; this to 1 will cause PHP CGI to fix its paths to conform to the spec.  A setting
795c3fcaf1dSJohannes Schlüter; of zero causes PHP to behave as before.  Default is 1.  You should fix your scripts
796c3fcaf1dSJohannes Schlüter; to use SCRIPT_FILENAME rather than PATH_TRANSLATED.
797c1ccccc6SPhilip Olson; http://php.net/cgi.fix-pathinfo
798c3fcaf1dSJohannes Schlüter;cgi.fix_pathinfo=1
799c3fcaf1dSJohannes Schlüter
8004f0960a8SChristoph M. Becker; if cgi.discard_path is enabled, the PHP CGI binary can safely be placed outside
8014f0960a8SChristoph M. Becker; of the web tree and people will not be able to circumvent .htaccess security.
8024f0960a8SChristoph M. Becker;cgi.discard_path=1
8034f0960a8SChristoph M. Becker
80444c5dea9SKalle Sommer Nielsen; FastCGI under IIS supports the ability to impersonate
805c3fcaf1dSJohannes Schlüter; security tokens of the calling client.  This allows IIS to define the
806c3fcaf1dSJohannes Schlüter; security context that the request runs under.  mod_fastcgi under Apache
807c3fcaf1dSJohannes Schlüter; does not currently support this feature (03/17/2002)
808c3fcaf1dSJohannes Schlüter; Set to 1 if running under IIS.  Default is zero.
809c1ccccc6SPhilip Olson; http://php.net/fastcgi.impersonate
810c3547f19SXinchen Hui;fastcgi.impersonate = 1
811c3fcaf1dSJohannes Schlüter
812c3fcaf1dSJohannes Schlüter; Disable logging through FastCGI connection. PHP's default behavior is to enable
813c3fcaf1dSJohannes Schlüter; this feature.
814c3fcaf1dSJohannes Schlüter;fastcgi.logging = 0
815c3fcaf1dSJohannes Schlüter
816c3fcaf1dSJohannes Schlüter; cgi.rfc2616_headers configuration option tells PHP what type of headers to
817d0727b58SBryan Hanks, PMP; use when sending HTTP response code. If set to 0, PHP sends Status: header that
818d0727b58SBryan Hanks, PMP; is supported by Apache. When this option is set to 1, PHP will send
819c3fcaf1dSJohannes Schlüter; RFC2616 compliant header.
820c3fcaf1dSJohannes Schlüter; Default is zero.
821c1ccccc6SPhilip Olson; http://php.net/cgi.rfc2616-headers
822c3fcaf1dSJohannes Schlüter;cgi.rfc2616_headers = 0
823c3fcaf1dSJohannes Schlüter
8244f0960a8SChristoph M. Becker; cgi.check_shebang_line controls whether CGI PHP checks for line starting with #!
8254f0960a8SChristoph M. Becker; (shebang) at the top of the running script. This line might be needed if the
8264f0960a8SChristoph M. Becker; script support running both as stand-alone script and via PHP CGI<. PHP in CGI
8274f0960a8SChristoph M. Becker; mode skips this line and ignores its content if this directive is turned on.
8284f0960a8SChristoph M. Becker; http://php.net/cgi.check-shebang-line
8294f0960a8SChristoph M. Becker;cgi.check_shebang_line=1
8304f0960a8SChristoph M. Becker
831c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;
832c3fcaf1dSJohannes Schlüter; File Uploads ;
833c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;
834c3fcaf1dSJohannes Schlüter
835c3fcaf1dSJohannes Schlüter; Whether to allow HTTP file uploads.
836c1ccccc6SPhilip Olson; http://php.net/file-uploads
837c3fcaf1dSJohannes Schlüterfile_uploads = On
838c3fcaf1dSJohannes Schlüter
839c3fcaf1dSJohannes Schlüter; Temporary directory for HTTP uploaded files (will use system default if not
840c3fcaf1dSJohannes Schlüter; specified).
841c1ccccc6SPhilip Olson; http://php.net/upload-tmp-dir
842c3fcaf1dSJohannes Schlüter;upload_tmp_dir =
843c3fcaf1dSJohannes Schlüter
844c3fcaf1dSJohannes Schlüter; Maximum allowed size for uploaded files.
845c1ccccc6SPhilip Olson; http://php.net/upload-max-filesize
846c3fcaf1dSJohannes Schlüterupload_max_filesize = 2M
847c3fcaf1dSJohannes Schlüter
848e2211ceeSIlia Alshanetsky; Maximum number of files that can be uploaded via a single request
8499d095a60SIlia Alshanetskymax_file_uploads = 20
850e2211ceeSIlia Alshanetsky
851c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;
852c3fcaf1dSJohannes Schlüter; Fopen wrappers ;
853c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;
854c3fcaf1dSJohannes Schlüter
855c3fcaf1dSJohannes Schlüter; Whether to allow the treatment of URLs (like http:// or ftp://) as files.
856c1ccccc6SPhilip Olson; http://php.net/allow-url-fopen
857c3fcaf1dSJohannes Schlüterallow_url_fopen = On
858c3fcaf1dSJohannes Schlüter
859c3fcaf1dSJohannes Schlüter; Whether to allow include/require to open URLs (like http:// or ftp://) as files.
860c1ccccc6SPhilip Olson; http://php.net/allow-url-include
861c3fcaf1dSJohannes Schlüterallow_url_include = Off
862c3fcaf1dSJohannes Schlüter
863c3fcaf1dSJohannes Schlüter; Define the anonymous ftp password (your email address). PHP's default setting
864c3fcaf1dSJohannes Schlüter; for this is empty.
865c1ccccc6SPhilip Olson; http://php.net/from
866c3fcaf1dSJohannes Schlüter;from="john@doe.com"
867c3fcaf1dSJohannes Schlüter
868c3fcaf1dSJohannes Schlüter; Define the User-Agent string. PHP's default setting for this is empty.
869c1ccccc6SPhilip Olson; http://php.net/user-agent
870c3fcaf1dSJohannes Schlüter;user_agent="PHP"
871c3fcaf1dSJohannes Schlüter
872c3fcaf1dSJohannes Schlüter; Default timeout for socket based streams (seconds)
873c1ccccc6SPhilip Olson; http://php.net/default-socket-timeout
874c3fcaf1dSJohannes Schlüterdefault_socket_timeout = 60
875c3fcaf1dSJohannes Schlüter
876c3fcaf1dSJohannes Schlüter; If your scripts have to deal with files from Macintosh systems,
877c3fcaf1dSJohannes Schlüter; or you are running on a Mac and need to deal with files from
878c3fcaf1dSJohannes Schlüter; unix or win32 systems, setting this flag will cause PHP to
879c3fcaf1dSJohannes Schlüter; automatically detect the EOL character in those files so that
880c3fcaf1dSJohannes Schlüter; fgets() and file() will work regardless of the source of the file.
881c1ccccc6SPhilip Olson; http://php.net/auto-detect-line-endings
882c3fcaf1dSJohannes Schlüter;auto_detect_line_endings = Off
883c3fcaf1dSJohannes Schlüter
884c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;;;
885c3fcaf1dSJohannes Schlüter; Dynamic Extensions ;
886c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;;;;
887c3fcaf1dSJohannes Schlüter
888c3fcaf1dSJohannes Schlüter; If you wish to have an extension loaded automatically, use the following
889c3fcaf1dSJohannes Schlüter; syntax:
890c3fcaf1dSJohannes Schlüter;
891fe5c8f2bSFrancois Laupretre;   extension=modulename
892c3fcaf1dSJohannes Schlüter;
893fe5c8f2bSFrancois Laupretre; For example:
894c3fcaf1dSJohannes Schlüter;
895fe5c8f2bSFrancois Laupretre;   extension=mysqli
89637c329d7SPeter Kokot;
897fe5c8f2bSFrancois Laupretre; When the extension library to load is not located in the default extension
898fe5c8f2bSFrancois Laupretre; directory, You may specify an absolute path to the library file:
899c3fcaf1dSJohannes Schlüter;
9009fc0a5e0SKalle Sommer Nielsen;   extension=/path/to/extension/mysqli.so
901c3fcaf1dSJohannes Schlüter;
902fe5c8f2bSFrancois Laupretre; Note : The syntax used in previous PHP versions ('extension=<ext>.so' and
903fe5c8f2bSFrancois Laupretre; 'extension='php_<ext>.dll') is supported for legacy reasons and may be
904fe5c8f2bSFrancois Laupretre; deprecated in a future PHP major version. So, when it is possible, please
905fe5c8f2bSFrancois Laupretre; move to the new ('extension=<ext>) syntax.
906fe5c8f2bSFrancois Laupretre;
907fe5c8f2bSFrancois Laupretre; Notes for Windows environments :
908c3fcaf1dSJohannes Schlüter;
909fe5c8f2bSFrancois Laupretre; - Many DLL files are located in the extensions/ (PHP 4) or ext/ (PHP 5+)
910fe5c8f2bSFrancois Laupretre;   extension folders as well as the separate PECL DLL download (PHP 5+).
911fe5c8f2bSFrancois Laupretre;   Be sure to appropriately set the extension_dir directive.
91284dcca9fSLukas Smith;
913fe5c8f2bSFrancois Laupretre;extension=bz2
914fe5c8f2bSFrancois Laupretre;extension=curl
915f08095faSPavel Dyakonov;extension=ffi
917fe5c8f2bSFrancois Laupretre;extension=fileinfo
918fe5c8f2bSFrancois Laupretre;extension=gd2
919fe5c8f2bSFrancois Laupretre;extension=gettext
920fe5c8f2bSFrancois Laupretre;extension=gmp
921fe5c8f2bSFrancois Laupretre;extension=intl
922fe5c8f2bSFrancois Laupretre;extension=imap
923fe5c8f2bSFrancois Laupretre;extension=ldap
924fe5c8f2bSFrancois Laupretre;extension=mbstring
925fe5c8f2bSFrancois Laupretre;extension=exif      ; Must be after mbstring as it depends on it
926fe5c8f2bSFrancois Laupretre;extension=mysqli
927fe5c8f2bSFrancois Laupretre;extension=oci8_12c  ; Use with Oracle Database 12c Instant Client
928b2622ed8SChristoph M. Becker;extension=odbc
929fe5c8f2bSFrancois Laupretre;extension=openssl
930fe5c8f2bSFrancois Laupretre;extension=pdo_firebird
931fe5c8f2bSFrancois Laupretre;extension=pdo_mysql
932fe5c8f2bSFrancois Laupretre;extension=pdo_oci
933fe5c8f2bSFrancois Laupretre;extension=pdo_odbc
934fe5c8f2bSFrancois Laupretre;extension=pdo_pgsql
935fe5c8f2bSFrancois Laupretre;extension=pdo_sqlite
936fe5c8f2bSFrancois Laupretre;extension=pgsql
937fe5c8f2bSFrancois Laupretre;extension=shmop
938269a6b09SPierre Joye
93976a0cbc0Ssoftwarespot; The MIBS data available in the PHP distribution must be installed.
94076a0cbc0Ssoftwarespot; See http://www.php.net/manual/en/snmp.installation.php
941fe5c8f2bSFrancois Laupretre;extension=snmp
942fe5c8f2bSFrancois Laupretre
943fe5c8f2bSFrancois Laupretre;extension=soap
944fe5c8f2bSFrancois Laupretre;extension=sockets
9458bc2163cSChristoph M. Becker;extension=sodium
946fe5c8f2bSFrancois Laupretre;extension=sqlite3
947fe5c8f2bSFrancois Laupretre;extension=tidy
948fe5c8f2bSFrancois Laupretre;extension=xmlrpc
949fe5c8f2bSFrancois Laupretre;extension=xsl
950c3fcaf1dSJohannes Schlüter
951c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
952c3fcaf1dSJohannes Schlüter; Module Settings ;
953c3fcaf1dSJohannes Schlüter;;;;;;;;;;;;;;;;;;;
954c3fcaf1dSJohannes Schlüter
95588e36378SArpad Ray[CLI Server]
95688e36378SArpad Ray; Whether the CLI web server uses ANSI color coding in its terminal output.
95788e36378SArpad Raycli_server.color = On
95888e36378SArpad Ray
959c3fcaf1dSJohannes Schlüter[Date]
960c3fcaf1dSJohannes Schlüter; Defines the default timezone used by the date functions
961c1ccccc6SPhilip Olson; http://php.net/date.timezone
962c3fcaf1dSJohannes Schlüter;date.timezone =
963c3fcaf1dSJohannes Schlüter
964c1ccccc6SPhilip Olson; http://php.net/date.default-latitude
965c3fcaf1dSJohannes Schlüter;date.default_latitude = 31.7667
966c3fcaf1dSJohannes Schlüter
967c1ccccc6SPhilip Olson; http://php.net/date.default-longitude
968c3fcaf1dSJohannes Schlüter;date.default_longitude = 35.2333
969c3fcaf1dSJohannes Schlüter
970c1ccccc6SPhilip Olson; http://php.net/date.sunrise-zenith
971c3fcaf1dSJohannes Schlüter;date.sunrise_zenith = 90.583333
972c3fcaf1dSJohannes Schlüter
973c1ccccc6SPhilip Olson; http://php.net/date.sunset-zenith
974c3fcaf1dSJohannes Schlüter;date.sunset_zenith = 90.583333
975c3fcaf1dSJohannes Schlüter
976c3fcaf1dSJohannes Schlüter[filter]
977c1ccccc6SPhilip Olson; http://php.net/filter.default
978c3fcaf1dSJohannes Schlüter;filter.default = unsafe_raw
979c3fcaf1dSJohannes Schlüter
980c1ccccc6SPhilip Olson; http://php.net/filter.default-flags
981c3fcaf1dSJohannes Schlüter;filter.default_flags =
982c3fcaf1dSJohannes Schlüter
983c3fcaf1dSJohannes Schlüter[iconv]
9846e16cc35SLior Kaplan; Use of this INI entry is deprecated, use global input_encoding instead.
985a28389b2SYasuo Ohgaki; If empty, default_charset or input_encoding or iconv.input_encoding is used.
98658c778baSMichael Smith; The precedence is: default_charset < input_encoding < iconv.input_encoding
987cbd108abSYasuo Ohgaki;iconv.input_encoding =
988cbd108abSYasuo Ohgaki
9896e16cc35SLior Kaplan; Use of this INI entry is deprecated, use global internal_encoding instead.
990a28389b2SYasuo Ohgaki; If empty, default_charset or internal_encoding or iconv.internal_encoding is used.
991a28389b2SYasuo Ohgaki; The precedence is: default_charset < internal_encoding < iconv.internal_encoding
992cbd108abSYasuo Ohgaki;iconv.internal_encoding =
993cbd108abSYasuo Ohgaki
9946e16cc35SLior Kaplan; Use of this INI entry is deprecated, use global output_encoding instead.
995a28389b2SYasuo Ohgaki; If empty, default_charset or output_encoding or iconv.output_encoding is used.
996a28389b2SYasuo Ohgaki; The precedence is: default_charset < output_encoding < iconv.output_encoding
997a28389b2SYasuo Ohgaki; To use an output encoding conversion, iconv's output handler must be set
998a28389b2SYasuo Ohgaki; otherwise output encoding conversion cannot be performed.
999cbd108abSYasuo Ohgaki;iconv.output_encoding =
1000c3fcaf1dSJohannes Schlüter
100142886746SRemi Collet[imap]
100242886746SRemi Collet; rsh/ssh logins are disabled by default. Use this INI entry if you want to
100342886746SRemi Collet; enable them. Note that the IMAP library does not filter mailbox names before
100442886746SRemi Collet; passing them to rsh/ssh command, thus passing untrusted data to this function
100542886746SRemi Collet; with rsh/ssh enabled is insecure.
100642886746SRemi Collet;imap.enable_insecure_rsh=0
100742886746SRemi Collet
1008c3fcaf1dSJohannes Schlüter[intl]
100984dcca9fSLukas Smith;intl.default_locale =
1010c7eb83deSStanislav Malyshev; This directive allows you to produce PHP errors when some error
1011c7eb83deSStanislav Malyshev; happens within intl functions. The value is the level of the error produced.
1012c7eb83deSStanislav Malyshev; Default is 0, which does not produce any errors.
1013c7eb83deSStanislav Malyshev;intl.error_level = E_WARNING
101441b159fdSAnatol Belski;intl.use_exceptions = 0
1015c3fcaf1dSJohannes Schlüter
1016c3fcaf1dSJohannes Schlüter[sqlite3]
1017e93259bbSbohwaz; Directory pointing to SQLite3 extensions
1018e93259bbSbohwaz; http://php.net/sqlite3.extension-dir
1019c3fcaf1dSJohannes Schlüter;sqlite3.extension_dir =
1020c3fcaf1dSJohannes Schlüter
1021e93259bbSbohwaz; SQLite defensive mode flag (only available from SQLite 3.26+)
1022e93259bbSbohwaz; When the defensive flag is enabled, language features that allow ordinary
1023e93259bbSbohwaz; SQL to deliberately corrupt the database file are disabled. This forbids
1024e93259bbSbohwaz; writing directly to the schema, shadow tables (eg. FTS data tables), or
1025e93259bbSbohwaz; the sqlite_dbpage virtual table.
1026e93259bbSbohwaz; https://www.sqlite.org/c3ref/c_dbconfig_defensive.html
1027e93259bbSbohwaz; (for older SQLite versions, this flag has no use)
102878c9a53dSRemi Collet;sqlite3.defensive = 1
1030c3fcaf1dSJohannes Schlüter[Pcre]
1031ca21ba3fSsundarchi; PCRE library backtracking limit.
1032c1ccccc6SPhilip Olson; http://php.net/pcre.backtrack-limit
1033c3fcaf1dSJohannes Schlüter;pcre.backtrack_limit=100000
1034c3fcaf1dSJohannes Schlüter
1035ca21ba3fSsundarchi; PCRE library recursion limit.
1036ca21ba3fSsundarchi; Please note that if you set this value to a high number you may consume all
1037ca21ba3fSsundarchi; the available process stack and eventually crash PHP (due to reaching the
1038ca21ba3fSsundarchi; stack size limit imposed by the Operating System).
1039c1ccccc6SPhilip Olson; http://php.net/pcre.recursion-limit
1040c3fcaf1dSJohannes Schlüter;pcre.recursion_limit=100000
1041c3fcaf1dSJohannes Schlüter
1042ca21ba3fSsundarchi; Enables or disables JIT compilation of patterns. This requires the PCRE
1043ca21ba3fSsundarchi; library to be compiled with JIT support.
10444bf70f4dSAnatol Belski;pcre.jit=1
10454bf70f4dSAnatol Belski
1046c3fcaf1dSJohannes Schlüter[Pdo]
1047c3fcaf1dSJohannes Schlüter; Whether to pool ODBC connections. Can be one of "strict", "relaxed" or "off"
1048c1ccccc6SPhilip Olson; http://php.net/pdo-odbc.connection-pooling
1049c3fcaf1dSJohannes Schlüter;pdo_odbc.connection_pooling=strict
1050c3fcaf1dSJohannes Schlüter
1051ccb33c06SJohannes Schlüter;pdo_odbc.db2_instance_name
1052ccb33c06SJohannes Schlüter
1053c9fa8953SJohannes Schlüter[Pdo_mysql]
1054c9fa8953SJohannes Schlüter; Default socket name for local MySQL connects.  If empty, uses the built-in
1055c9fa8953SJohannes Schlüter; MySQL defaults.
1056c9fa8953SJohannes Schlüterpdo_mysql.default_socket=
1057c9fa8953SJohannes Schlüter
1058c3fcaf1dSJohannes Schlüter[Phar]
1059c1ccccc6SPhilip Olson; http://php.net/phar.readonly
1060c3fcaf1dSJohannes Schlüter;phar.readonly = On
1061c3fcaf1dSJohannes Schlüter
1062c1ccccc6SPhilip Olson; http://php.net/phar.require-hash
1063c3fcaf1dSJohannes Schlüter;phar.require_hash = On
1064c3fcaf1dSJohannes Schlüter
1065c3fcaf1dSJohannes Schlüter;phar.cache_list =
1066c3fcaf1dSJohannes Schlüter
1067c3fcaf1dSJohannes Schlüter[mail function]
1068c3fcaf1dSJohannes Schlüter; For Win32 only.
1069c1ccccc6SPhilip Olson; http://php.net/smtp
1070c3fcaf1dSJohannes SchlüterSMTP = localhost
1071c1ccccc6SPhilip Olson; http://php.net/smtp-port
1072c3fcaf1dSJohannes Schlütersmtp_port = 25
1073c3fcaf1dSJohannes Schlüter
1074c3fcaf1dSJohannes Schlüter; For Win32 only.
1075c1ccccc6SPhilip Olson; http://php.net/sendmail-from
1076c3fcaf1dSJohannes Schlüter;sendmail_from = me@example.com
1077c3fcaf1dSJohannes Schlüter
1078c3fcaf1dSJohannes Schlüter; For Unix only.  You may supply arguments as well (default: "sendmail -t -i").
1079c1ccccc6SPhilip Olson; http://php.net/sendmail-path
1080c3fcaf1dSJohannes Schlüter;sendmail_path =
1081c3fcaf1dSJohannes Schlüter
1082c3fcaf1dSJohannes Schlüter; Force the addition of the specified parameters to be passed as extra parameters
1083c3fcaf1dSJohannes Schlüter; to the sendmail binary. These parameters will always replace the value of
10846d148f7eSSobak; the 5th parameter to mail().
1085c3fcaf1dSJohannes Schlüter;mail.force_extra_parameters =
1086c3fcaf1dSJohannes Schlüter
10879d2c39acSPhilip Olson; Add X-PHP-Originating-Script: that will include uid of the script followed by the filename
108825f324faSChristoph M. Beckermail.add_x_header = Off
1089c3fcaf1dSJohannes Schlüter
109007ea326cSAdam Harvey; The path to a log file that will log all mail() calls. Log entries include
109107ea326cSAdam Harvey; the full path of the script, line number, To address and headers.
1092c3fcaf1dSJohannes Schlüter;mail.log =
109395c57bb6SAnatol Belski; Log mail to syslog (Event Log on Windows).
1094ddc8d162SFlorian Anderiasch;mail.log = syslog
1095c3fcaf1dSJohannes Schlüter
1096c3fcaf1dSJohannes Schlüter[ODBC]
1097c1ccccc6SPhilip Olson; http://php.net/odbc.default-db
1098c3fcaf1dSJohannes Schlüter;odbc.default_db    =  Not yet implemented
1099c3fcaf1dSJohannes Schlüter
1100c1ccccc6SPhilip Olson; http://php.net/odbc.default-user
1101c3fcaf1dSJohannes Schlüter;odbc.default_user  =  Not yet implemented
1102c3fcaf1dSJohannes Schlüter
1103c1ccccc6SPhilip Olson; http://php.net/odbc.default-pw
1104c3fcaf1dSJohannes Schlüter;odbc.default_pw    =  Not yet implemented
1105c3fcaf1dSJohannes Schlüter
110684dcca9fSLukas Smith; Controls the ODBC cursor model.
1107ccb33c06SJohannes Schlüter; Default: SQL_CURSOR_STATIC (default).
1108ccb33c06SJohannes Schlüter;odbc.default_cursortype
1109ccb33c06SJohannes Schlüter
1110c3fcaf1dSJohannes Schlüter; Allow or prevent persistent links.
1111c1ccccc6SPhilip Olson; http://php.net/odbc.allow-persistent
1112c3fcaf1dSJohannes Schlüterodbc.allow_persistent = On
1113c3fcaf1dSJohannes Schlüter
1114c3fcaf1dSJohannes Schlüter; Check that a connection is still valid before reuse.
1115c1ccccc6SPhilip Olson; http://php.net/odbc.check-persistent
1116c3fcaf1dSJohannes Schlüterodbc.check_persistent = On
1117c3fcaf1dSJohannes Schlüter
1118c3fcaf1dSJohannes Schlüter; Maximum number of persistent links.  -1 means no limit.
1119c1ccccc6SPhilip Olson; http://php.net/odbc.max-persistent
1120c3fcaf1dSJohannes Schlüterodbc.max_persistent = -1
1121c3fcaf1dSJohannes Schlüter
1122c3fcaf1dSJohannes Schlüter; Maximum number of links (persistent + non-persistent).  -1 means no limit.
1123c1ccccc6SPhilip Olson; http://php.net/odbc.max-links
1124c3fcaf1dSJohannes Schlüterodbc.max_links = -1
1125c3fcaf1dSJohannes Schlüter
1126c3fcaf1dSJohannes Schlüter; Handling of LONG fields.  Returns number of bytes to variables.  0 means
1127c3fcaf1dSJohannes Schlüter; passthru.
1128c1ccccc6SPhilip Olson; http://php.net/odbc.defaultlrl
1129c3fcaf1dSJohannes Schlüterodbc.defaultlrl = 4096
1130c3fcaf1dSJohannes Schlüter
1131c3fcaf1dSJohannes Schlüter; Handling of binary data.  0 means passthru, 1 return as is, 2 convert to char.
1132c3fcaf1dSJohannes Schlüter; See the documentation on odbc_binmode and odbc_longreadlen for an explanation
1133c1ccccc6SPhilip Olson; of odbc.defaultlrl and odbc.defaultbinmode
1134c1ccccc6SPhilip Olson; http://php.net/odbc.defaultbinmode
1135c3fcaf1dSJohannes Schlüterodbc.defaultbinmode = 1
1136c3fcaf1dSJohannes Schlüter
1137c3fcaf1dSJohannes Schlüter[MySQLi]
1138c3fcaf1dSJohannes Schlüter
1139c9fa8953SJohannes Schlüter; Maximum number of persistent links.  -1 means no limit.
1140c9fa8953SJohannes Schlüter; http://php.net/mysqli.max-persistent