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=mysql.so
 212 ;extension=pgsql.so
 213 ;extension=imap.so
 214 ;extension=ldap.so
 215 ;extension=xml.so
 216 ;extension=gd.so
 217 ;extension=libphp_java.so
 218
 219 ;zend_optimizer.optimization_level=1
 220 ;zend_extension="/usr/lib/apache/php/ZendOptimizer.so"
 221
 222 ;;;;;;;;;;;;;;;;;;;
 223 ; Module Settings ;
 224 ;;;;;;;;;;;;;;;;;;;
 225
 226 [Syslog]
 227 define_syslog_variables = Off   ; Whether or not to define the various syslog variables,
 228                                                                 ; e.g. $LOG_PID, $LOG_CRON, etc.  Turning it off is a
 229                                                                 ; good idea performance-wise.  In runtime, you can define
 230                                                                 ; these variables by calling define_syslog_variables()
 231
 232
 233 [mail function]
 234 SMTP                    =       localhost                       ;for win32 only
 235 sendmail_from   =       me@localhost.com        ;for win32 only
 236 sendmail_path   =                                               ;for unix only, may supply arguments as well (default is sendmail -t)
 237
 238 [Debugger]
 239 debugger.host   =       localhost
 240 debugger.port   =       7869
 241 debugger.enabled        =       False
 242
 243 [Logging]
 244 ; These configuration directives are used by the example logging mechanism.
 245 ; See examples/README.logging for more explanation.
 246 ;logging.method    = db
 247 ;logging.directory = /path/to/log/directory
 248
 249 [SQL]
 250 sql.safe_mode   =       Off
 251
 252 [ODBC]
 253 ;uodbc.default_db               =       Not yet implemented
 254 ;uodbc.default_user             =       Not yet implemented
 255 ;uodbc.default_pw               =       Not yet implemented
 256 uodbc.allow_persistent  =       On      ; allow or prevent persistent links
 257 uodbc.check_persistent  =       On      ; check that a connection is still validbefore reuse
 258 uodbc.max_persistent    =       -1      ; maximum number of persistent links. -1 means no limit
 259 uodbc.max_links                 =       -1      ; maximum number of links (persistent+non persistent). -1 means no limit
 260 uodbc.defaultlrl        =       4096    ; Handling of LONG fields. Returns number of bytes to variables, 0 means passthru
 261 uodbc.defaultbinmode    =       1       ; Handling of binary data. 0 means passthru, 1 return as is, 2 convert to char
 262 ; See the documentation on odbc_binmode and odbc_longreadlen for an explanation of uodbc.defaultlrl
 263 ; and uodbc.defaultbinmode
 264
 265 [MySQL]
 266 mysql.allow_persistent  =       On      ; allow or prevent persistent link
 267 mysql.max_persistent    =       -1      ; maximum number of persistent links. -1 means no limit
 268 mysql.max_links                 =       -1      ; maximum number of links (persistent+non persistent).  -1 means no limit
 269 mysql.default_port              =               ; default port number for mysql_connect().  If unset,
 270                                                                 ; mysql_connect() will use the $MYSQL_TCP_PORT, or the mysql-tcp
 271                                                                 ; entry in /etc/services, or the compile-time defined MYSQL_PORT
 272                                                                 ; (in that order).  Win32 will only look at MYSQL_PORT.
 273 mysql.default_host              =               ; default host for mysql_connect() (doesn't apply in safe mode)
 274 mysql.default_user              =               ; default user for mysql_connect() (doesn't apply in safe mode)
 275 mysql.default_password  =               ; default password for mysql_connect() (doesn't apply in safe mode)
 276                                                                 ; Note that this is generally a *bad* idea to store passwords
 277                                                                 ; in this file.  *Any* user with PHP access can run
 278                                                                 ; 'echo cfg_get_var("mysql.default_password")' and reveal that
 279                                                                 ; password!  And of course, any users with read access to this
 280                                                                 ; file will be able to reveal the password as well.
 281
 282 [mSQL]
 283 msql.allow_persistent   =       On      ; allow or prevent persistent link
 284 msql.max_persistent             =       -1      ; maximum number of persistent links. -1 means no limit
 285 msql.max_links                  =       -1      ; maximum number of links (persistent+non persistent).  -1 means no limit
 286
 287 [PostgresSQL]
 288 pgsql.allow_persistent  =       On      ; allow or prevent persistent link
 289 pgsql.max_persistent    =       -1      ; maximum number of persistent links. -1 means no limit
 290 pgsql.max_links                 =       -1      ; maximum number of links (persistent+non persistent).  -1 means no limit
 291
 292 [Sybase]
 293 sybase.allow_persistent =       On      ; allow or prevent persistent link
 294 sybase.max_persistent   =       -1      ; maximum number of persistent links. -1 means no limit
 295 sybase.max_links                =       -1      ; maximum number of links (persistent+non persistent).  -1 means no limit
 296 ;sybase.interface_file  =       "/usr/sybase/interfaces"
 297 sybase.min_error_severity       =       10      ; minimum error severity to display
 298 sybase.min_message_severity     =       10      ; minimum message severity to display
 299 sybase.compatability_mode       = Off   ; compatability mode with old versions of PHP 3.0.
 300                                                                         ; If on, this will cause PHP to automatically assign types to results
 301                                                                         ; according to their Sybase type, instead of treating them all as
 302                                                                         ; strings.  This compatability mode will probably not stay around
 303                                                                         ; forever, so try applying whatever necessary changes to your code,
 304                                                                         ; and turn it off.
 305
 306 [Sybase-CT]
 307 sybct.allow_persistent  =       On              ; allow or prevent persistent link
 308 sybct.max_persistent    =       -1              ; maximum number of persistent links. -1 means no limit
 309 sybct.max_links                 =       -1              ; maximum number of links (persistent+non persistent).  -1 means no limit
 310 sybct.min_server_severity       =       10      ; minimum server message severity to display
 311 sybct.min_client_severity       =       10      ; minimum client message severity to display
 312
 313 [bcmath]
 314 bcmath.scale    =       0       ; number of decimal digits for all bcmath functions
 315
 316 [browscap]
 317 ;browscap       =       extra/browscap.ini
 318
 319 [Informix]
 320 ifx.default_host                =               ; default host for ifx_connect() (doesn't apply in safe mode)
 321 ifx.default_user                =               ; default user for ifx_connect() (doesn't apply in safe mode)
 322 ifx.default_password            =               ; default password for ifx_connect() (doesn't apply in safe mode)
 323 ifx.allow_persistent            =       On      ; allow or prevent persistent link
 324 ifx.max_persistent              =       -1      ; maximum number of persistent links. -1 means no limit
 325 ifx.max_links                   =       -1      ; maximum number of links (persistent+non persistent).  -1 means no limit
 326 ifx.textasvarchar               =       0       ; if set on, select statements return the contents of a text blob instead of it's id
 327 ifx.byteasvarchar               =       0       ; if set on, select statements return the contents of a byte blob instead of it's id
 328 ifx.charasvarchar               =       0       ; trailing blanks are stripped from fixed-length char columns. May help the life
 329                                                 ; of Informix SE users.
 330 ifx.blobinfile                  =       0       ; if set on, the contents of text&byte blobs are dumped to a file instead of
 331                                                 ; keeping them in memory
 332 ifx.nullformat                  =       0       ; NULL's are returned as empty strings, unless this is set to 1. In that case,
 333                                                 ; NULL's are returned as string 'NULL'.
 334
 335 [Session]
 336 session.save_handler      = files   ; handler used to store/retrieve data
 337 session.save_path         = /tmp    ; argument passed to save_handler
 338                                     ; in the case of files, this is the
 339                                     ; path where data files are stored
 340 session.use_cookies       = 1       ; whether to use cookies
 341 session.name              = PHPSESSID
 342                                     ; name of the session
 343                                     ; is used as cookie name
 344 session.auto_start        = 0       ; initialize session on request startup
 345 session.cookie_lifetime   = 0       ; lifetime in seconds of cookie
 346                                     ; or if 0, until browser is restarted
 347 session.cookie_path       = /       ; the path the cookie is valid for
 348 session.cookie_domain     =         ; the domain the cookie is valid for
 349 session.serialize_handler = php     ; handler used to serialize data
 350                                     ; php is the standard serializer of PHP
 351 session.gc_probability    = 1       ; procentual probability that the
 352                                     ; 'garbage collection' process is started
 353                                     ; on every session initialization
 354 session.gc_maxlifetime    = 1440    ; after this number of seconds, stored
 355                                     ; data will be seen as 'garbage' and
 356                                     ; cleaned up by the gc process
 357 session.referer_check     =         ; check HTTP Referer to invalidate
 358                                     ; externally stored URLs containing ids
 359 session.entropy_length    = 0       ; how many bytes to read from the file
 360 session.entropy_file      =         ; specified here to create the session id
 361 ; session.entropy_length    = 16
 362 ; session.entropy_file      = /dev/urandom
 363 session.cache_limiter     = nocache ; set to {nocache,private,public} to
 364                                     ; determine HTTP caching aspects
 365 session.cache_expire      = 180     ; document expires after n minutes
 366
 367 [MSSQL]
 368 ;extension=php_mssql.dll
 369 mssql.allow_persistent          =       On      ; allow or prevent persistent link
 370 mssql.max_persistent            =       -1      ; maximum number of persistent links. -1 means no limit
 371 mssql.max_links                         =       -1      ; maximum number of links (persistent+non persistent).  -1 means no limit
 372 mssql.min_error_severity        =       10      ; minimum error severity to display
 373 mssql.min_message_severity      =       10      ; minimum message severity to display
 374 mssql.compatability_mode        = Off   ; compatability mode with old versions of PHP 3.0.
 375
 376 [Assertion]
 377 ;assert.active                          =       Off     ; assert(expr); does nothing by default
 378 ;assert.warning                         =       On      ; issue a PHP warning for each failed assertion.
 379 ;assert.bail                            =       Off     ; don't bail out by default.
 380 ;assert.callback                        =       0       ; user-function to be called if an assertion fails.
 381 ;assert.quiet_eval                      =       0       ; eval the expression with current error_reporting(). set to true if you want error_reporting(0) around the eval().
 382
 383
 384