]>
Commit | Line | Data |
---|---|---|
acf5be5c | 1 | [PHP] |
dfc70604 AF |
2 | |
3 | ;;;;;;;;;;;;;;;;;;; | |
4 | ; About this file ; | |
5 | ;;;;;;;;;;;;;;;;;;; | |
6 | ; This file controls many aspects of PHP's behavior. In order for PHP to | |
acf5be5c | 7 | ; read it, it must be named 'php.ini'. PHP looks for it in the current |
dfc70604 AF |
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 | |
acf5be5c | 11 | ; path in which the php.ini file is looked for can be overriden using |
dfc70604 AF |
12 | ; the -c argument in command line mode. |
13 | ; | |
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 | |
acf5be5c | 17 | ; they might mean something in the future. |
18 | ; | |
19 | ; Directives are specified using the following syntax: | |
20 | ; directive = value | |
21 | ; Directive names are *case sensitive* - foo=bar is different from FOO=bar. | |
22 | ; | |
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"). | |
26 | ; | |
27 | ; Expressions in the INI file are limited to bitwise operators and parentheses: | |
28 | ; | bitwise OR | |
29 | ; & bitwise AND | |
30 | ; ~ bitwise NOT | |
dfc70604 | 31 | ; |
dfc70604 AF |
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. | |
34 | ; | |
acf5be5c | 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. | |
38 | ; | |
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, | |
dfc70604 AF |
41 | ; the builtin defaults will be identical). |
42 | ||
43 | ||
44 | ;;;;;;;;;;;;;;;;;;;; | |
45 | ; Language Options ; | |
46 | ;;;;;;;;;;;;;;;;;;;; | |
47 | ||
acf5be5c | 48 | engine = On ; Enable the PHP scripting language engine under Apache |
dfc70604 AF |
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) | |
acf5be5c | 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 | |
55 | ; output layer a bit. | |
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). | |
76 | ||
dfc70604 AF |
77 | ; Safe Mode |
78 | safe_mode = Off | |
79 | safe_mode_exec_dir = | |
acf5be5c | 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 | |
92 | ; variable! | |
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. | |
100 | ||
dfc70604 AF |
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 | |
108 | ||
acf5be5c | 109 | ; Misc |
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. | |
114 | ||
115 | ||
dfc70604 AF |
116 | |
117 | ;;;;;;;;;;;;;;;;;;; | |
118 | ; Resource Limits ; | |
119 | ;;;;;;;;;;;;;;;;;;; | |
120 | ||
acf5be5c | 121 | max_execution_time = 30 ; Maximum execution time of each script, in seconds (UNIX only) |
dfc70604 AF |
122 | memory_limit = 8388608 ; Maximum amount of memory a script may consume (8MB) |
123 | ||
124 | ||
125 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
126 | ; Error handling and logging ; | |
127 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
acf5be5c | 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) | |
141 | ; Examples: | |
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 | |
dfc70604 AF |
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 | |
acf5be5c | 150 | ;error_log = filename ; log errors to specified file |
dfc70604 AF |
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 | |
153 | ||
154 | ||
155 | ;;;;;;;;;;;;;;;;; | |
156 | ; Data Handling ; | |
157 | ;;;;;;;;;;;;;;;;; | |
acf5be5c | 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 | |
162 | ; older values. | |
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[], | |
168 | ; variables. | |
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. | |
176 | ||
177 | ; Magic quotes | |
dfc70604 AF |
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 \') | |
acf5be5c | 181 | |
182 | ; automatically add files before or after any PHP document | |
dfc70604 AF |
183 | auto_prepend_file = |
184 | auto_append_file = | |
185 | ||
186 | ||
187 | ;;;;;;;;;;;;;;;;;;;;;;;;; | |
188 | ; Paths and Directories ; | |
189 | ;;;;;;;;;;;;;;;;;;;;;;;;; | |
20dc3ef2 AF |
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 | |
dfc70604 AF |
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 | |
20dc3ef2 | 195 | ;extension_dir = /usr/lib/apache/php/ ; directory in which the loadable extensions (modules) reside |
dfc70604 AF |
196 | |
197 | ||
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, | |
204 | ; extension=msql.dll | |
205 | ; or under UNIX, | |
206 | ; extension=msql.so | |
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. | |
209 | ||
210 | ;UNIX Extensions | |
c63307f5 AF |
211 | ;extension=bcmath.so |
212 | ;extension=calendar.so | |
213 | ;extension=cpdf.so | |
5316c927 AF |
214 | ;extension=dba.so |
215 | ;extension=dbase.so | |
c63307f5 | 216 | ;extension=exif.so |
5316c927 | 217 | ;extension=filepro.so |
c63307f5 AF |
218 | ;extension=ftp.so |
219 | ;extension=gd.so | |
220 | ;extension=gettext.so | |
221 | ;extension=imap.so | |
222 | ;extension=ldap.so | |
223 | ;extension=libphp_java.so | |
224 | ;extension=mysql.so | |
5316c927 | 225 | ;extension=pcre.so |
c63307f5 AF |
226 | ;extension=pdf.so |
227 | ;extension=pgsql.so | |
228 | ;extension=posix.so | |
229 | ;extension=recode.so | |
230 | ;extension=session.so | |
231 | ;extension=snmp.so | |
5316c927 AF |
232 | ;extension=sysvsem.so |
233 | ;extension=sysvshm.so | |
c63307f5 | 234 | ;extension=xml.so |
5316c927 | 235 | ;extension=yp.so |
5316c927 | 236 | ;extension=zlib.so |
dfc70604 | 237 | |
ccb2a804 | 238 | ;zend_optimizer.optimization_level=7 |
0deb0d1d | 239 | ;zend_extension="/usr/lib/apache/php/ZendOptimizer.so" |
240 | ||
dfc70604 AF |
241 | ;;;;;;;;;;;;;;;;;;; |
242 | ; Module Settings ; | |
243 | ;;;;;;;;;;;;;;;;;;; | |
244 | ||
245 | [Syslog] | |
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() | |
250 | ||
251 | ||
252 | [mail function] | |
253 | SMTP = localhost ;for win32 only | |
254 | sendmail_from = me@localhost.com ;for win32 only | |
ccb2a804 | 255 | sendmail_path = "/usr/sbin/sendmail -t" ;for unix only, may supply arguments as well (default is sendmail -t) |
dfc70604 AF |
256 | |
257 | [Debugger] | |
258 | debugger.host = localhost | |
259 | debugger.port = 7869 | |
260 | debugger.enabled = False | |
261 | ||
262 | [Logging] | |
263 | ; These configuration directives are used by the example logging mechanism. | |
264 | ; See examples/README.logging for more explanation. | |
265 | ;logging.method = db | |
266 | ;logging.directory = /path/to/log/directory | |
267 | ||
268 | [SQL] | |
269 | sql.safe_mode = Off | |
270 | ||
271 | [ODBC] | |
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 | |
acf5be5c | 276 | uodbc.check_persistent = On ; check that a connection is still validbefore reuse |
dfc70604 AF |
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 | |
283 | ||
284 | [MySQL] | |
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. | |
300 | ||
301 | [mSQL] | |
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 | |
305 | ||
306 | [PostgresSQL] | |
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 | |
310 | ||
311 | [Sybase] | |
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 | |
acf5be5c | 318 | sybase.compatability_mode = Off ; compatability mode with old versions of PHP 3.0. |
dfc70604 AF |
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, | |
323 | ; and turn it off. | |
324 | ||
325 | [Sybase-CT] | |
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 | |
331 | ||
332 | [bcmath] | |
333 | bcmath.scale = 0 ; number of decimal digits for all bcmath functions | |
334 | ||
335 | [browscap] | |
336 | ;browscap = extra/browscap.ini | |
337 | ||
dfc70604 AF |
338 | [Informix] |
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'. | |
acf5be5c | 353 | |
354 | [Session] | |
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 | |
385 | ||
386 | [MSSQL] | |
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. | |
394 | ||
395 | [Assertion] | |
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(). | |
401 | ||
0deb0d1d | 402 | |
403 |