6 ; This file controls many aspects of PHP's behavior. In order for PHP to
7 ; read it, it must be named 'php.ini'. PHP looks for it in the current
8 ; working directory, in the path designated by the environment variable
9 ; PHPRC, and in the path that was defined in compile time (in that order).
10 ; Under Windows, the compile-time path is the Windows directory. The
11 ; path in which the php.ini file is looked for can be overriden using
12 ; the -c argument in command line mode.
14 ; The syntax of the file is extremely simple. Whitespace and Lines
15 ; beginning with a semicolon are silently ignored (as you probably guessed).
16 ; Section headers (e.g. [Foo]) are also silently ignored, even though
17 ; they might mean something in the future.
19 ; Directives are specified using the following syntax:
21 ; Directive names are *case sensitive* - foo=bar is different from FOO=bar.
23 ; The value can be a string, a number, a PHP constant (e.g. E_ALL or M_PI), one
24 ; of the INI constants (On, Off, True, False, Yes and No) or an expression
25 ; (e.g. E_ALL & ~E_NOTICE), or a quoted string ("foo").
27 ; Expressions in the INI file are limited to bitwise operators and parentheses:
32 ; Boolean flags can be turned on using the values 1, On, True or Yes.
33 ; They can be turned off using the values 0, Off, False or No.
35 ; If you use constants in your value, and these constants belong to a dynamically
36 ; loaded extension (either a PHP extension or a Zend extension), you may only
37 ; use these constants *after* the line that loads the extension.
39 ; All the values in the php.ini-dist file correspond to the builtin
40 ; defaults (that is, if no php.ini is used, or if you delete these lines,
41 ; the builtin defaults will be identical).
48 engine = On ; Enable the PHP scripting language engine under Apache
49 short_open_tag = On ; allow the <? tag. otherwise, only <?php and <script> tags are recognized.
50 asp_tags = Off ; allow ASP-style <% %> tags
51 precision = 14 ; number of significant digits displayed in floating point numbers
52 y2k_compliance = Off ; whether to be year 2000 compliant (will cause problems with non y2k compliant browsers)
53 output_buffering = Off ; Output buffering allows you to send header lines (including cookies)
54 ; even after you send body content, in the price of slowing PHP's
56 ; You can enable output buffering by in runtime by calling the output
57 ; buffering functions, or enable output buffering for all files
58 ; by setting this directive to On.
59 implicit_flush = Off ; Implicit flush tells PHP to tell the output layer to flush itself
60 ; automatically after every output block. This is equivalent to
61 ; calling the PHP function flush() after each and every call to print()
62 ; or echo() and each and every HTML block.
63 ; Turning this option on has serious performance implications, and
64 ; is generally recommended for debugging purposes only.
65 allow_call_time_pass_reference = On ; whether to enable the ability to force arguments to be
66 ; passed by reference at function-call time. This method
67 ; is deprecated, and is likely to be unsupported in future
68 ; versions of PHP/Zend. The encouraged method of specifying
69 ; which arguments should be passed by reference is in the
70 ; function declaration. You're encouraged to try and
71 ; turn this option Off, and make sure your scripts work
72 ; properly with it, to ensure they will work with future
73 ; versions of the language (you will receive a warning
74 ; each time you use this feature, and the argument will
75 ; be passed by value instead of by reference).
80 safe_mode_allowed_env_vars = PHP_ ; Setting certain environment variables
81 ; may be a potential security breach.
82 ; This directive contains a comma-delimited
83 ; list of prefixes. In Safe Mode, the
84 ; user may only alter environment
85 ; variables whose names begin with the
86 ; prefixes supplied here.
87 ; By default, users will only be able
88 ; to set environment variables that begin
89 ; with PHP_ (e.g. PHP_FOO=BAR).
90 ; Note: If this directive is empty, PHP
91 ; will let the user modify ANY environment
93 safe_mode_protected_env_vars = LD_LIBRARY_PATH ; This directive contains a comma-
94 ; delimited list of environment variables,
95 ; that the end user won't be able to
96 ; change using putenv().
97 ; These variables will be protected
98 ; even if safe_mode_allowed_env_vars is
99 ; set to allow to change them.
101 ; Colors for Syntax Highlighting mode. Anything that's acceptable in <font color=???> would work.
102 highlight.string = #DD0000
103 highlight.comment = #FF8000
104 highlight.keyword = #007700
105 highlight.bg = #FFFFFF
106 highlight.default = #0000BB
107 highlight.html = #000000
110 expose_php = On ; Decides whether PHP may expose the fact that it is installed on the
111 ; server (e.g., by adding its signature to the Web server header).
112 ; It is no security threat in any way, but it makes it possible
113 ; to determine whether you use PHP on your server or not.
121 max_execution_time = 30 ; Maximum execution time of each script, in seconds (UNIX only)
122 memory_limit = 8388608 ; Maximum amount of memory a script may consume (8MB)
125 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
126 ; Error handling and logging ;
127 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
128 ; error_reporting is a bit-field. Or each number up to get desired error reporting level
129 ; E_ALL - All errors and warnings
130 ; E_ERROR - fatal run-time errors
131 ; E_WARNING - run-time warnings (non fatal errors)
132 ; E_PARSE - compile-time parse errors
133 ; E_NOTICE - run-time notices (these are warnings which often result from a bug in
134 ; your code, but it's possible that it was intentional (e.g., using an
135 ; uninitialized variable and relying on the fact it's automatically
136 ; initialized to an empty string)
137 ; E_CORE_ERROR - fatal errors that occur during PHP's initial startup
138 ; E_CORE_WARNING - warnings (non fatal errors) that occur during PHP's initial startup
139 ; E_COMPILE_ERROR - fatal compile-time errors
140 ; E_COMPILE_WARNING - compile-time warnings (non fatal errors)
142 ; error_reporting = E_ALL & ~E_NOTICE ; show all errors, except for notices
143 ; error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR ; show only errors
144 error_reporting = E_ALL & ~E_NOTICE ; Show all errors except for notices
145 display_errors = On ; Print out errors (as a part of the HTML script)
146 log_errors = Off ; Log errors into a log file (server-specific log, stderr, or error_log (below))
147 track_errors = Off ; Store the last error/warning message in $php_errormsg (boolean)
148 ;error_prepend_string = "<font color=ff0000>" ; string to output before an error message
149 ;error_append_string = "</font>" ; string to output after an error message
150 ;error_log = filename ; log errors to specified file
151 ;error_log = syslog ; log errors to syslog (Event Log on NT, not valid in Windows 95)
152 warn_plus_overloading = Off ; warn if the + operator is used with strings
158 variables_order = "EGPCS" ; This directive describes the order in which PHP registers
159 ; GET, POST, Cookie, Environment and Built-in variables (G, P,
160 ; C, E & S respectively, often referred to as EGPCS or GPC).
161 ; Registration is done from left to right, newer values override
163 register_globals = On ; Whether or not to register the EGPCS variables as global
164 ; variables. You may want to turn this off if you don't want
165 ; to clutter your scripts' global scope with user data. This makes
166 ; most sense when coupled with track_vars - in which case you can
167 ; access all of the GPC variables through the $HTTP_*_VARS[],
169 register_argv_argc = On ; This directive tells PHP whether to declare the argv&argc
170 ; variables (that would contain the GET information). If you
171 ; don't use these variables, you should turn it off for
172 ; increased performance
173 track_vars = On ; enable the $HTTP_*_VARS[] arrays, where * is one of
174 ; ENV, POST, GET, COOKIE or SERVER.
175 gpc_order = "GPC" ; This directive is deprecated. Use variables_order instead.
178 magic_quotes_gpc = On ; magic quotes for incoming GET/POST/Cookie data
179 magic_quotes_runtime= Off ; magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc.
180 magic_quotes_sybase = Off ; Use Sybase-style magic quotes (escape ' with '' instead of \')
182 ; automatically add files before or after any PHP document
187 ;;;;;;;;;;;;;;;;;;;;;;;;;
188 ; Paths and Directories ;
189 ;;;;;;;;;;;;;;;;;;;;;;;;;
190 ;include_path = ; UNIX: "/path1:/path2" Windows: "\path1;\path2"
191 ;doc_root = ; the root of the php pages, used only if nonempty
192 ;user_dir = ; the directory under which php opens the script using /~username, used only if nonempty
193 ;upload_tmp_dir = ; temporary directory for HTTP uploaded files (will use system default if not specified)
194 upload_max_filesize = 2097152 ; 2 Meg default limit on file uploads
195 ;extension_dir = /usr/lib/apache/php/ ; directory in which the loadable extensions (modules) reside
198 ;;;;;;;;;;;;;;;;;;;;;;
199 ; Dynamic Extensions ;
200 ;;;;;;;;;;;;;;;;;;;;;;
201 ; if you wish to have an extension loaded automaticly, use the
202 ; following syntax: extension=modulename.extension
203 ; for example, on windows,
207 ; Note that it should be the name of the module only, no directory information
208 ; needs to go here. Specify the location of the extension with the extension_dir directive above.
212 ;extension=calendar.so
217 ;extension=filepro.so
220 ;extension=gettext.so
223 ;extension=libphp_java.so
230 ;extension=session.so
232 ;extension=sysvsem.so
233 ;extension=sysvshm.so
238 ;zend_optimizer.optimization_level=7
239 ;zend_extension="/usr/lib/apache/php/ZendOptimizer.so"
246 define_syslog_variables = Off ; Whether or not to define the various syslog variables,
247 ; e.g. $LOG_PID, $LOG_CRON, etc. Turning it off is a
248 ; good idea performance-wise. In runtime, you can define
249 ; these variables by calling define_syslog_variables()
253 SMTP = localhost ;for win32 only
254 sendmail_from = me@localhost.com ;for win32 only
255 sendmail_path = "/usr/sbin/sendmail -t" ;for unix only, may supply arguments as well (default is sendmail -t)
258 debugger.host = localhost
260 debugger.enabled = False
263 ; These configuration directives are used by the example logging mechanism.
264 ; See examples/README.logging for more explanation.
266 ;logging.directory = /path/to/log/directory
272 ;uodbc.default_db = Not yet implemented
273 ;uodbc.default_user = Not yet implemented
274 ;uodbc.default_pw = Not yet implemented
275 uodbc.allow_persistent = On ; allow or prevent persistent links
276 uodbc.check_persistent = On ; check that a connection is still validbefore reuse
277 uodbc.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
278 uodbc.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
279 uodbc.defaultlrl = 4096 ; Handling of LONG fields. Returns number of bytes to variables, 0 means passthru
280 uodbc.defaultbinmode = 1 ; Handling of binary data. 0 means passthru, 1 return as is, 2 convert to char
281 ; See the documentation on odbc_binmode and odbc_longreadlen for an explanation of uodbc.defaultlrl
282 ; and uodbc.defaultbinmode
285 mysql.allow_persistent = On ; allow or prevent persistent link
286 mysql.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
287 mysql.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
288 mysql.default_port = ; default port number for mysql_connect(). If unset,
289 ; mysql_connect() will use the $MYSQL_TCP_PORT, or the mysql-tcp
290 ; entry in /etc/services, or the compile-time defined MYSQL_PORT
291 ; (in that order). Win32 will only look at MYSQL_PORT.
292 mysql.default_host = ; default host for mysql_connect() (doesn't apply in safe mode)
293 mysql.default_user = ; default user for mysql_connect() (doesn't apply in safe mode)
294 mysql.default_password = ; default password for mysql_connect() (doesn't apply in safe mode)
295 ; Note that this is generally a *bad* idea to store passwords
296 ; in this file. *Any* user with PHP access can run
297 ; 'echo cfg_get_var("mysql.default_password")' and reveal that
298 ; password! And of course, any users with read access to this
299 ; file will be able to reveal the password as well.
302 msql.allow_persistent = On ; allow or prevent persistent link
303 msql.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
304 msql.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
307 pgsql.allow_persistent = On ; allow or prevent persistent link
308 pgsql.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
309 pgsql.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
312 sybase.allow_persistent = On ; allow or prevent persistent link
313 sybase.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
314 sybase.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
315 ;sybase.interface_file = "/usr/sybase/interfaces"
316 sybase.min_error_severity = 10 ; minimum error severity to display
317 sybase.min_message_severity = 10 ; minimum message severity to display
318 sybase.compatability_mode = Off ; compatability mode with old versions of PHP 3.0.
319 ; If on, this will cause PHP to automatically assign types to results
320 ; according to their Sybase type, instead of treating them all as
321 ; strings. This compatability mode will probably not stay around
322 ; forever, so try applying whatever necessary changes to your code,
326 sybct.allow_persistent = On ; allow or prevent persistent link
327 sybct.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
328 sybct.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
329 sybct.min_server_severity = 10 ; minimum server message severity to display
330 sybct.min_client_severity = 10 ; minimum client message severity to display
333 bcmath.scale = 0 ; number of decimal digits for all bcmath functions
336 ;browscap = extra/browscap.ini
339 ifx.default_host = ; default host for ifx_connect() (doesn't apply in safe mode)
340 ifx.default_user = ; default user for ifx_connect() (doesn't apply in safe mode)
341 ifx.default_password = ; default password for ifx_connect() (doesn't apply in safe mode)
342 ifx.allow_persistent = On ; allow or prevent persistent link
343 ifx.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
344 ifx.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
345 ifx.textasvarchar = 0 ; if set on, select statements return the contents of a text blob instead of it's id
346 ifx.byteasvarchar = 0 ; if set on, select statements return the contents of a byte blob instead of it's id
347 ifx.charasvarchar = 0 ; trailing blanks are stripped from fixed-length char columns. May help the life
348 ; of Informix SE users.
349 ifx.blobinfile = 0 ; if set on, the contents of text&byte blobs are dumped to a file instead of
350 ; keeping them in memory
351 ifx.nullformat = 0 ; NULL's are returned as empty strings, unless this is set to 1. In that case,
352 ; NULL's are returned as string 'NULL'.
355 session.save_handler = files ; handler used to store/retrieve data
356 session.save_path = /tmp ; argument passed to save_handler
357 ; in the case of files, this is the
358 ; path where data files are stored
359 session.use_cookies = 1 ; whether to use cookies
360 session.name = PHPSESSID
361 ; name of the session
362 ; is used as cookie name
363 session.auto_start = 0 ; initialize session on request startup
364 session.cookie_lifetime = 0 ; lifetime in seconds of cookie
365 ; or if 0, until browser is restarted
366 session.cookie_path = / ; the path the cookie is valid for
367 session.cookie_domain = ; the domain the cookie is valid for
368 session.serialize_handler = php ; handler used to serialize data
369 ; php is the standard serializer of PHP
370 session.gc_probability = 1 ; procentual probability that the
371 ; 'garbage collection' process is started
372 ; on every session initialization
373 session.gc_maxlifetime = 1440 ; after this number of seconds, stored
374 ; data will be seen as 'garbage' and
375 ; cleaned up by the gc process
376 session.referer_check = ; check HTTP Referer to invalidate
377 ; externally stored URLs containing ids
378 session.entropy_length = 0 ; how many bytes to read from the file
379 session.entropy_file = ; specified here to create the session id
380 ; session.entropy_length = 16
381 ; session.entropy_file = /dev/urandom
382 session.cache_limiter = nocache ; set to {nocache,private,public} to
383 ; determine HTTP caching aspects
384 session.cache_expire = 180 ; document expires after n minutes
387 ;extension=php_mssql.dll
388 mssql.allow_persistent = On ; allow or prevent persistent link
389 mssql.max_persistent = -1 ; maximum number of persistent links. -1 means no limit
390 mssql.max_links = -1 ; maximum number of links (persistent+non persistent). -1 means no limit
391 mssql.min_error_severity = 10 ; minimum error severity to display
392 mssql.min_message_severity = 10 ; minimum message severity to display
393 mssql.compatability_mode = Off ; compatability mode with old versions of PHP 3.0.
396 ;assert.active = Off ; assert(expr); does nothing by default
397 ;assert.warning = On ; issue a PHP warning for each failed assertion.
398 ;assert.bail = Off ; don't bail out by default.
399 ;assert.callback = 0 ; user-function to be called if an assertion fails.
400 ;assert.quiet_eval = 0 ; eval the expression with current error_reporting(). set to true if you want error_reporting(0) around the eval().