PHP version: 4.3.2RC4 PHP Bug Type: *General Issues Bug description: php.ini-dist and php.ini-recommended cleanup patch
There are various typos and differences between the to files mentioned in the subject. I made a cleanup of that and I'd like to send you the patch file, but i couldn't find an email address where to direct ready patches for CVS. (maybe you should write it in the package documentation?) Regards -- Giovanni Giacobbi
--- php-4.3.2RC4/php.ini-dist.orig Thu May 8 03:23:35 2003 +++ php-4.3.2RC4/php.ini-dist Tue May 27 17:08:04 2003 @@ -67,7 +67,7 @@ ; Enable the PHP scripting language engine under Apache. engine = On -; Allow the <? tag. Otherwise, only <?php and <script> tags are recognized. +; Allow the <? tag. Otherwise, only <?php and <script> tags are recognized. ; NOTE: Using short tags should be avoided when developing applications or ; libraries that are meant for redistribution, or deployment on PHP ; servers which are not under your control, because short tags may not @@ -99,18 +99,18 @@ ; Setting any output handler automatically turns on output buffering. ; Note: People who wrote portable scripts should not depend on this ini ; directive. Instead, explicitly set the output handler using ob_start(). -; Using this ini directive may cause problems unless you know what script +; Using this ini directive may cause problems unless you know what script ; is doing. ; Note: You cannot use both "mb_output_handler" with "ob_iconv_handler" -; and you cannot use both "ob_gzhandler" and "zlib.output_compression". +; and you cannot use both "ob_gzhandler" and "zlib.output_compression". ;output_handler = ; Transparent output compression using the zlib library ; Valid values for this option are 'off', 'on', or a specific buffer size ; to be used for compression (default is 4KB) -; Note: Resulting chunk size may vary due to nature of compression. PHP -; outputs chunks that are few hundreds bytes each as a result of -; compression. If you prefer a larger chunk size for better +; Note: Resulting chunk size may vary due to nature of compression. PHP +; outputs chunks that are few hundreds bytes each as a result of +; compression. If you prefer a larger chunk size for better ; performance, enable output_buffering in addition. ; Note: You need to use zlib.output_handler instead of the standard ; output_handler, or otherwise the output will be corrupted. @@ -133,7 +133,7 @@ ; which should be instanciated. ; A warning appears if the specified function is not defined, or if the ; function doesn't include/implement the missing class. -; So only set this entry, if you really want to implement such a +; So only set this entry, if you really want to implement such a ; callback-function. unserialize_callback_func= @@ -153,6 +153,7 @@ ; reference). allow_call_time_pass_reference = On +; ; Safe Mode ; safe_mode = Off @@ -166,7 +167,7 @@ ; including files from this directory and its subdirectories. ; (directory must also be in include_path or full path must ; be used when including) -safe_mode_include_dir = +safe_mode_include_dir = ; When safe_mode is on, only executables located in the safe_mode_exec_dir ; will be allowed to be executed via the exec family of functions. @@ -231,6 +232,7 @@ max_input_time = 60 ; Maximum amount of time each script may spend parsing request data memory_limit = 8M ; Maximum amount of memory a script may consume (8MB) + ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Error handling and logging ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; @@ -294,13 +296,13 @@ ; line until ignore_repeated_source is set true. ignore_repeated_errors = Off -; Ignore source of message when ignoring repeated messages. When this setting +; Ignore source of message when ignoring repeated messages. When this setting ; is On you will not log errors with repeated messages from different files or ; sourcelines. ignore_repeated_source = Off ; If this parameter is set to Off, then memory leaks will not be shown (on -; stdout or in the log). This has only effect in a debug compile, and if +; stdout or in the log). This has only effect in a debug compile, and if ; error reporting includes E_WARNING in the allowed list report_memleaks = On @@ -309,16 +311,16 @@ ; Disable the inclusion of HTML tags in error messages. ;html_errors = Off - -; If html_errors is set On PHP produces clickable error messages that direct + +; If html_errors is set On PHP produces clickable error messages that direct ; to a page describing the error or function causing the error in detail. -; You can download a copy of the PHP manual from http://www.php.net/docs.php +; You can download a copy of the PHP manual from http://www.php.net/docs.php ; and change docref_root to the base URL of your local copy including the -; leading '/'. You must also specify the file extension being used including +; leading '/'. You must also specify the file extension being used including ; the dot. ;docref_root = "/phpmanual/" ;docref_ext = .html - + ; String to output before an error message. ;error_prepend_string = "<font color=ff0000>" @@ -339,11 +341,11 @@ ; Note - track_vars is ALWAYS enabled as of PHP 4.0.3 ; The separator used in PHP generated URLs to separate arguments. -; Default is "&". +; Default is "&". ;arg_separator.output = "&" ; List of separator(s) used by PHP to parse input URLs into variables. -; Default is "&". +; Default is "&". ; NOTE: Every character in this directive is considered as separator! ;arg_separator.input = ";&" @@ -382,7 +384,7 @@ magic_quotes_gpc = On ; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc. -magic_quotes_runtime = Off +magic_quotes_runtime = Off ; Use Sybase-style magic quotes (escape ' with '' instead of \'). magic_quotes_sybase = Off @@ -407,7 +409,7 @@ ; Paths and Directories ; ;;;;;;;;;;;;;;;;;;;;;;;;; -; UNIX: "/path1:/path2" +; UNIX: "/path1:/path2" ;include_path = ".:/php/includes" ; ; Windows: "\path1;\path2" @@ -438,7 +440,7 @@ ; **You CAN safely turn this off for IIS, in fact, you MUST.** ; cgi.force_redirect = 1 -; if cgi.force_redirect is turned on, and you are not running under Apache or Netscape +; if cgi.force_redirect is turned on, and you are not running under Apache or Netscape ; (iPlanet) web servers, you MAY need to set an environment variable name that PHP ; will look for to know it is OK to continue execution. Setting this variable MAY ; cause security issues, KNOW WHAT YOU ARE DOING FIRST. @@ -456,8 +458,8 @@ ; is supported by Apache. When this option is set to 1 PHP will send ; RFC2616 compliant header. ; Set to 1 if running under IIS. Default is zero. -;cgi.rfc2616_headers = 0 - +;cgi.rfc2616_headers = 0 + ;;;;;;;;;;;;;;;; ; File Uploads ; @@ -485,7 +487,7 @@ ;from="[EMAIL PROTECTED]" ; Define the User-Agent string -; user_agent="PHP" +;user_agent="PHP" ; Default timeout for socket based streams (seconds) default_socket_timeout = 60 @@ -515,7 +517,7 @@ ; ; extension=msql.so ; -; Note that it should be the name of the module only; no directory information +; Note that it should be the name of the module only; no directory information ; needs to go here. Specify the location of the extension with the ; extension_dir directive above. @@ -592,7 +594,7 @@ [Java] ;java.class.path = .\php_java.jar ;java.home = c:\jdk -;java.library = c:\jdk\jre\bin\hotspot\jvm.dll +;java.library = c:\jdk\jre\bin\hotspot\jvm.dll ;java.library.path = .\ [SQL] @@ -613,16 +615,16 @@ odbc.max_persistent = -1 ; Maximum number of links (persistent + non-persistent). -1 means no limit. -odbc.max_links = -1 +odbc.max_links = -1 ; Handling of LONG fields. Returns number of bytes to variables. 0 means ; passthru. -odbc.defaultlrl = 4096 +odbc.defaultlrl = 4096 ; Handling of binary data. 0 means passthru, 1 return as is, 2 convert to char. ; See the documentation on odbc_binmode and odbc_longreadlen for an explanation ; of uodbc.defaultlrl and uodbc.defaultbinmode -odbc.defaultbinmode = 1 +odbc.defaultbinmode = 1 [MySQL] ; Allow or prevent persistent links. @@ -678,8 +680,9 @@ ; Allow or prevent persistent links. pgsql.allow_persistent = On -; Detect broken persistent links always with pg_pconnect(). Need a little overhead. -pgsql.auto_reset_persistent = Off +; Detect broken persistent links always with pg_pconnect(). +; Auto reset feature requires a little overheads. +pgsql.auto_reset_persistent = Off ; Maximum number of persistent links. -1 means no limit. pgsql.max_persistent = -1 @@ -688,6 +691,7 @@ pgsql.max_links = -1 ; Ignore PostgreSQL backends Notice message or not. +; Notice message logging require a little overheads. pgsql.ignore_notice = 0 ; Log PostgreSQL backends Noitce message or not. @@ -794,14 +798,14 @@ session.save_handler = files ; Argument passed to save_handler. In the case of files, this is the path -; where data files are stored. Note: Windows users have to change this +; where data files are stored. Note: Windows users have to change this ; variable in order to use PHP's session functions. ; As of PHP 4.0.1, you can define the path as: ; session.save_path = "N;/path" -; where N is an integer. Instead of storing all the session files in -; /path, what this will do is use subdirectories N-levels deep, and -; store the session data in those directories. This is useful if you -; or your OS have problems with lots of files in one directory, and is +; where N is an integer. Instead of storing all the session files in +; /path, what this will do is use subdirectories N-levels deep, and +; store the session data in those directories. This is useful if you +; or your OS have problems with lots of files in one directory, and is ; a more efficient layout for servers that handle lots of sessions. ; NOTE 1: PHP will not create this directory structure automatically. ; You can use the script in the ext/session dir for that purpose. @@ -849,8 +853,8 @@ ; NOTE: If you are using the subdirectory option for storing session files ; (see session.save_path above), then garbage collection does *not* -; happen automatically. You will need to do your own garbage -; collection through a shell script, cron entry, or some other method. +; happen automatically. You will need to do your own garbage +; collection through a shell script, cron entry, or some other method. ; For example, the following script would is the equivalent of ; setting session.gc_maxlifetime to 1440 (1440 seconds = 24 minutes): ; cd /path/to/sessions; find -cmin +24 | xargs rm @@ -887,7 +891,7 @@ session.cache_expire = 180 ; trans sid support is disabled by default. -; Use of trans sid may risk your users security. +; Use of trans sid may risk your users security. ; Use this option with caution. ; - User may send URL contains active session ID ; to other person via. email/irc/etc. @@ -1002,7 +1006,7 @@ [com] ; path to a file containing GUIDs, IIDs or filenames of files with TypeLibs -;com.typelib_file = +;com.typelib_file = ; allow Distributed-COM calls ;com.allow_dcom = true ; autoregister constants of a components typlib on com_load() @@ -1031,7 +1035,7 @@ ; registered as output buffer to function ;mbstring.http_output = SJIS -; enable automatic encoding translation accoding to +; enable automatic encoding translation accoding to ; mbstring.internal_encoding setting. Input chars are ; converted to internal encoding by setting this to On. ; Note: Do _not_ use automatic encoding translation for @@ -1039,7 +1043,7 @@ ;mbstring.encoding_translation = Off ; automatic encoding detection order. -; auto means +; auto means ;mbstring.detect_order = auto ; substitute_character used when character cannot be converted @@ -1059,7 +1063,7 @@ [FrontBase] ;fbsql.allow_persistent = On ;fbsql.autocommit = On -;fbsql.default_database = +;fbsql.default_database = ;fbsql.default_database_password = ;fbsql.default_host = ;fbsql.default_password = @@ -1077,15 +1081,15 @@ ; crack.default_dictionary = "c:\php\lib\cracklib_dict" [exif] -; Exif UNICODE user comments are handled as UCS-2BE/UCS-2LE and JIS as JIS. +; Exif UNICODE user comments are handled as UCS-2BE/UCS-2LE and JIS as JIS. ; With mbstring support this will automatically be converted into the encoding -; given by corresponding encode setting. When empty mbstring.internal_encoding -; is used. For the decode settings you can distinguish between motorola and +; given by corresponding encode setting. When empty mbstring.internal_encoding +; is used. For the decode settings you can distinguish between motorola and ; intel byte order. A decode setting cannot be empty. ;exif.encode_unicode = ISO-8859-15 ;exif.decode_unicode_motorola = UCS-2BE ;exif.decode_unicode_intel = UCS-2LE -;exif.encode_jis = +;exif.encode_jis = ;exif.decode_jis_motorola = JIS ;exif.decode_jis_intel = JIS --- php-4.3.2RC4/php.ini-recommended.orig Thu May 8 03:23:35 2003 +++ php-4.3.2RC4/php.ini-recommended Tue May 27 17:12:16 2003 @@ -80,7 +80,7 @@ ; Enable the PHP scripting language engine under Apache. engine = On -; Allow the <? tag. Otherwise, only <?php and <script> tags are recognized. +; Allow the <? tag. Otherwise, only <?php and <script> tags are recognized. ; NOTE: Using short tags should be avoided when developing applications or ; libraries that are meant for redistribution, or deployment on PHP ; servers which are not under your control, because short tags may not @@ -112,21 +112,21 @@ ; Setting any output handler automatically turns on output buffering. ; Note: People who wrote portable scripts should not depend on this ini ; directive. Instead, explicitly set the output handler using ob_start(). -; Using this ini directive may cause problems unless you know what script +; Using this ini directive may cause problems unless you know what script ; is doing. ; Note: You cannot use both "mb_output_handler" with "ob_iconv_handler" -; and you cannot use both "ob_gzhandler" and "zlib.output_compression". +; and you cannot use both "ob_gzhandler" and "zlib.output_compression". ;output_handler = ; Transparent output compression using the zlib library ; Valid values for this option are 'off', 'on', or a specific buffer size ; to be used for compression (default is 4KB) -; Note: Resulting chunk size may vary due to nature of compression. PHP -; outputs chunks that are few handreds bytes each as a result of compression. -; If you want larger chunk size for better performence, enable output_buffering -; also. -; Note: output_handler must be empty if this is set 'On' !!!! -; Instead you must use zlib.output_handler. +; Note: Resulting chunk size may vary due to nature of compression. PHP +; outputs chunks that are few hundreds bytes each as a result of +; compression. If you prefer a larger chunk size for better +; performance, enable output_buffering in addition. +; Note: You need to use zlib.output_handler instead of the standard +; output_handler, or otherwise the output will be corrupted. zlib.output_compression = Off ; You cannot specify additional output handlers if zlib.output_compression @@ -146,7 +146,7 @@ ; which should be instanciated. ; A warning appears if the specified function is not defined, or if the ; function doesn't include/implement the missing class. -; So only set this entry, if you really want to implement such a +; So only set this entry, if you really want to implement such a ; callback-function. unserialize_callback_func= @@ -180,7 +180,7 @@ ; including files from this directory and its subdirectories. ; (directory must also be in include_path or full path must ; be used when including) -safe_mode_include_dir = +safe_mode_include_dir = ; When safe_mode is on, only executables located in the safe_mode_exec_dir ; will be allowed to be executed via the exec family of functions. @@ -309,13 +309,13 @@ ; line until ignore_repeated_source is set true. ignore_repeated_errors = Off -; Ignore source of message when ignoring repeated messages. When this setting +; Ignore source of message when ignoring repeated messages. When this setting ; is On you will not log errors with repeated messages from different files or ; sourcelines. ignore_repeated_source = Off ; If this parameter is set to Off, then memory leaks will not be shown (on -; stdout or in the log). This has only effect in a debug compile, and if +; stdout or in the log). This has only effect in a debug compile, and if ; error reporting includes E_WARNING in the allowed list report_memleaks = On @@ -325,15 +325,15 @@ ; Disable the inclusion of HTML tags in error messages. ;html_errors = Off -; If html_errors is set On PHP produces clickable error messages that direct +; If html_errors is set On PHP produces clickable error messages that direct ; to a page describing the error or function causing the error in detail. -; You can download a copy of the PHP manual from http://www.php.net/docs.php +; You can download a copy of the PHP manual from http://www.php.net/docs.php ; and change docref_root to the base URL of your local copy including the -; leading '/'. You must also specify the file extension being used including +; leading '/'. You must also specify the file extension being used including ; the dot. ;docref_root = "/phpmanual/" ;docref_ext = .html - + ; String to output before an error message. ;error_prepend_string = "<font color=ff0000>" @@ -354,11 +354,11 @@ ; Note - track_vars is ALWAYS enabled as of PHP 4.0.3 ; The separator used in PHP generated URLs to separate arguments. -; Default is "&". +; Default is "&". ;arg_separator.output = "&" ; List of separator(s) used by PHP to parse input URLs into variables. -; Default is "&". +; Default is "&". ; NOTE: Every character in this directive is considered as separator! ;arg_separator.input = ";&" @@ -397,7 +397,7 @@ magic_quotes_gpc = Off ; Magic quotes for runtime-generated data, e.g. data from SQL, from exec(), etc. -magic_quotes_runtime = Off +magic_quotes_runtime = Off ; Use Sybase-style magic quotes (escape ' with '' instead of \'). magic_quotes_sybase = Off @@ -414,7 +414,7 @@ default_mimetype = "text/html" ;default_charset = "iso-8859-1" -; Always populate the $HTTP_RAW_POST_DATA variable. +; Always populate the $HTTP_RAW_POST_DATA variable. ;always_populate_raw_post_data = On @@ -422,7 +422,7 @@ ; Paths and Directories ; ;;;;;;;;;;;;;;;;;;;;;;;;; -; UNIX: "/path1:/path2" +; UNIX: "/path1:/path2" ;include_path = ".:/php/includes" ; ; Windows: "\path1;\path2" @@ -435,7 +435,7 @@ ; cgi.force_redirect configuration below doc_root = -; The directory under which PHP opens the script using /~usernamem used only +; The directory under which PHP opens the script using /~username used only ; if nonempty. user_dir = @@ -453,7 +453,7 @@ ; **You CAN safely turn this off for IIS, in fact, you MUST.** ; cgi.force_redirect = 1 -; if cgi.force_redirect is turned on, and you are not running under Apache or Netscape +; if cgi.force_redirect is turned on, and you are not running under Apache or Netscape ; (iPlanet) web servers, you MAY need to set an environment variable name that PHP ; will look for to know it is OK to continue execution. Setting this variable MAY ; cause security issues, KNOW WHAT YOU ARE DOING FIRST. @@ -471,7 +471,7 @@ ; is supported by Apache. When this option is set to 1 PHP will send ; RFC2616 compliant header. ; Set to 1 if running under IIS. Default is zero. -;cgi.rfc2616_headers = 0 +;cgi.rfc2616_headers = 0 ;;;;;;;;;;;;;;;; @@ -499,7 +499,7 @@ ; Define the anonymous ftp password (your email address) ;from="[EMAIL PROTECTED]" -; Define the user agent for php to send +; Define the User-Agent string ;user_agent="PHP" ; Default timeout for socket based streams (seconds) @@ -530,7 +530,7 @@ ; ; extension=msql.so ; -; Note that it should be the name of the module only; no directory information +; Note that it should be the name of the module only; no directory information ; needs to go here. Specify the location of the extension with the ; extension_dir directive above. @@ -607,7 +607,7 @@ [Java] ;java.class.path = .\php_java.jar ;java.home = c:\jdk -;java.library = c:\jdk\jre\bin\hotspot\jvm.dll +;java.library = c:\jdk\jre\bin\hotspot\jvm.dll ;java.library.path = .\ [SQL] @@ -628,16 +628,16 @@ odbc.max_persistent = -1 ; Maximum number of links (persistent + non-persistent). -1 means no limit. -odbc.max_links = -1 +odbc.max_links = -1 ; Handling of LONG fields. Returns number of bytes to variables. 0 means ; passthru. -odbc.defaultlrl = 4096 +odbc.defaultlrl = 4096 ; Handling of binary data. 0 means passthru, 1 return as is, 2 convert to char. ; See the documentation on odbc_binmode and odbc_longreadlen for an explanation ; of uodbc.defaultlrl and uodbc.defaultbinmode -odbc.defaultbinmode = 1 +odbc.defaultbinmode = 1 [MySQL] ; Allow or prevent persistent links. @@ -693,7 +693,7 @@ ; Allow or prevent persistent links. pgsql.allow_persistent = On -; Detect broken persistent links always with pg_pconnect(). +; Detect broken persistent links always with pg_pconnect(). ; Auto reset feature requires a little overheads. pgsql.auto_reset_persistent = Off @@ -811,14 +811,25 @@ session.save_handler = files ; Argument passed to save_handler. In the case of files, this is the path -; where data files are stored. Note: Windows users have to change this +; where data files are stored. Note: Windows users have to change this ; variable in order to use PHP's session functions. +; As of PHP 4.0.1, you can define the path as: +; session.save_path = "N;/path" +; where N is an integer. Instead of storing all the session files in +; /path, what this will do is use subdirectories N-levels deep, and +; store the session data in those directories. This is useful if you +; or your OS have problems with lots of files in one directory, and is +; a more efficient layout for servers that handle lots of sessions. +; NOTE 1: PHP will not create this directory structure automatically. +; You can use the script in the ext/session dir for that purpose. +; NOTE 2: See the section on garbage collection below if you choose to +; use subdirectories for session storage session.save_path = /tmp ; Whether to use cookies. session.use_cookies = 1 -; This option enables administrators to make their users invulnerable to +; This option enables administrators to make their users invulnerable to ; attacks which involve passing session ids in URLs; defaults to 0. ; session.use_only_cookies = 1 @@ -853,6 +864,14 @@ ; cleaned up by the garbage collection process. session.gc_maxlifetime = 1440 +; NOTE: If you are using the subdirectory option for storing session files +; (see session.save_path above), then garbage collection does *not* +; happen automatically. You will need to do your own garbage +; collection through a shell script, cron entry, or some other method. +; For example, the following script would is the equivalent of +; setting session.gc_maxlifetime to 1440 (1440 seconds = 24 minutes): +; cd /path/to/sessions; find -cmin +24 | xargs rm + ; PHP 4.2 and less have an undocumented feature/bug that allows you to ; to initialize a session variable in the global scope, albeit register_globals ; is disabled. PHP 4.3 and later will warn you, if this feature is used. @@ -877,7 +896,7 @@ ;session.entropy_file = /dev/urandom -; Set to {nocache,private,public,} to determine HTTP caching aspects. +; Set to {nocache,private,public,} to determine HTTP caching aspects ; or leave this empty to avoid sending anti-caching headers. session.cache_limiter = nocache @@ -890,7 +909,7 @@ ; - User may send URL contains active session ID ; to other person via. email/irc/etc. ; - URL that contains active session ID may be stored -; in publically accessible computer. +; in publically accessible computer. ; - User may access your site with the same session ID ; always using URL stored in browser's history or bookmarks. session.use_trans_sid = 0 @@ -1000,7 +1019,7 @@ [com] ; path to a file containing GUIDs, IIDs or filenames of files with TypeLibs -;com.typelib_file = +;com.typelib_file = ; allow Distributed-COM calls ;com.allow_dcom = true ; autoregister constants of a components typlib on com_load() @@ -1029,7 +1048,7 @@ ; registered as output buffer to function ;mbstring.http_output = SJIS -; enable automatic encoding translation accoding to +; enable automatic encoding translation accoding to ; mbstring.internal_encoding setting. Input chars are ; converted to internal encoding by setting this to On. ; Note: Do _not_ use automatic encoding translation for @@ -1037,7 +1056,7 @@ ;mbstring.encoding_translation = Off ; automatic encoding detection order. -; auto means +; auto means ;mbstring.detect_order = auto ; substitute_character used when character cannot be converted @@ -1057,7 +1076,7 @@ [FrontBase] ;fbsql.allow_persistent = On ;fbsql.autocommit = On -;fbsql.default_database = +;fbsql.default_database = ;fbsql.default_database_password = ;fbsql.default_host = ;fbsql.default_password = @@ -1075,15 +1094,15 @@ ; crack.default_dictionary = "c:\php\lib\cracklib_dict" [exif] -; Exif UNICODE user comments are handled as UCS-2BE/UCS-2LE and JIS as JIS. +; Exif UNICODE user comments are handled as UCS-2BE/UCS-2LE and JIS as JIS. ; With mbstring support this will automatically be converted into the encoding -; given by corresponding encode setting. When empty mbstring.internal_encoding -; is used. For the decode settings you can distinguish between motorola and +; given by corresponding encode setting. When empty mbstring.internal_encoding +; is used. For the decode settings you can distinguish between motorola and ; intel byte order. A decode setting cannot be empty. ;exif.encode_unicode = ISO-8859-15 ;exif.decode_unicode_motorola = UCS-2BE ;exif.decode_unicode_intel = UCS-2LE -;exif.encode_jis = +;exif.encode_jis = ;exif.decode_jis_motorola = JIS ;exif.decode_jis_intel = JIS
-- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
