php.ini

   1 [PHP]
   2
   3 ;;;;;;;;;;;;;;;;;;;
   4 ; About this file ;
   5 ;;;;;;;;;;;;;;;;;;;
   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.
  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
  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
  31 ;
  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 ;
  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,
  41 ; the builtin defaults will be identical).
  42
  43
  44 ;;;;;;;;;;;;;;;;;;;;
  45 ; Language Options ;
  46 ;;;;;;;;;;;;;;;;;;;;
  47
  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
  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
  77 ; Safe Mode
  78 safe_mode               =       Off
  79 safe_mode_exec_dir      =
  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
 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
 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
 116
 117 ;;;;;;;;;;;;;;;;;;;
 118 ; Resource Limits ;
 119 ;;;;;;;;;;;;;;;;;;;
 120
 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)
 123
 124
 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)
 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
 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
 153
 154
 155 ;;;;;;;;;;;;;;;;;
 156 ; Data Handling ;
 157 ;;;;;;;;;;;;;;;;;
 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
 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 \')
 181
 182 ; automatically add files before or after any PHP document
 183 auto_prepend_file       =
 184 auto_append_file        =
 185
 186
 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
 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
 211 ;extension=bcmath.so
 212 ;extension=calendar.so
 213 ;extension=cpdf.so
 214 ;extension=dba.so
 215 ;extension=dbase.so
 216 ;extension=exif.so
 217 ;extension=filepro.so
 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
 225 ;extension=pcre.so
 226 ;extension=pdf.so
 227 ;extension=pgsql.so
 228 ;extension=posix.so
 229 ;extension=recode.so
 230 ;extension=session.so
 231 ;extension=snmp.so
 232 ;extension=sysvsem.so
 233 ;extension=sysvshm.so
 234 ;extension=xml.so
 235 ;extension=yp.so
 236 ;extension=zlib.so
 237
 238 ;zend_optimizer.optimization_level=7
 239 ;zend_extension="/usr/lib/apache/php/ZendOptimizer.so"
 240
 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
 255 sendmail_path   =       "/usr/sbin/sendmail -t"                                 ;for unix only, may supply arguments as well (default is sendmail -t)
 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
 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
 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
 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,
 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
 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'.
 353
 354 [Session]
 355 session.save_handler      = files   ; handler used to store/retrieve data
 356 session.save_path         = /var/run/php    ; 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
 402
 403