cvs: phpdoc /en/chapters config.xml /en/features file-upload.xml safe-mode.xml
| From: | Jeroen van Wolffelaar | Date: | Tue, 10 Jul 2001 21:12:59 +0000 |
| Subject: | cvs: phpdoc /en/chapters config.xml /en/features file-upload.xml safe-mode.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336110@lists.php.net to get a copy of this message | ||
jeroen Tue Jul 10 17:12:59 2001 EDT
Modified files:
/phpdoc/en/chapters config.xml
/phpdoc/en/features file-upload.xml safe-mode.xml
Log:
A bit xml-reworking, removed some tabs to satisfy Derick, added
upload_max_filesize ini directive.
Someone should check the last one, I didn't mention the default,
and apparently 2M is also supported... but I needed to get rid
of the jade-error.
Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.16 phpdoc/en/chapters/config.xml:1.17 --- phpdoc/en/chapters/config.xml:1.16 Sat Jul 7 14:42:14 2001 +++ phpdoc/en/chapters/config.xml Tue Jul 10 17:12:59 2001 @@ -89,199 +89,199 @@ <variablelist> <varlistentry id="ini.allow-url-fopen"> <term> - <parameter>allow_url_fopen</parameter> - <type>boolean</type> + <parameter>allow_url_fopen</parameter> + <type>boolean</type> </term> <listitem> - <para> - This option enables the URL-aware fopen wrappers that enable accessing URL object - like files. Default wrappers are provided for the access of - <link linkend="features.remote-files">remote files</link> - using the ftp or http protocol, some extensions like zlib may register additional wrappers. - </para> - - <note> - <para> - This option was introduced immediately after the release of version 4.0.3. - For versions up to and including 4.0.3 you can only disable this feature at - compile time by using the configuration switch - <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. - </para> - </note> + <para> + This option enables the URL-aware fopen wrappers that enable accessing URL object + like files. Default wrappers are provided for the access of + <link linkend="features.remote-files">remote files</link> + using the ftp or http protocol, some extensions like zlib may register additional wrappers. + </para> + + <note> + <para> + This option was introduced immediately after the release of version 4.0.3. + For versions up to and including 4.0.3 you can only disable this feature at + compile time by using the configuration switch + <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. + </para> + </note> </listitem> </varlistentry> <varlistentry id="ini.asp-tags"> <term> - <parameter>asp_tags</parameter> - <type>boolean</type> + <parameter>asp_tags</parameter> + <type>boolean</type> </term> <listitem> - <simpara> - Enables the use of ASP-like <% %> tags in addition to - the usual <?php ?> tags. This includes the - variable-value printing shorthand of <%= $value %>. For - more information, see <link linkend="language.basic-syntax.phpmode">Escaping from HTML</link>. - </simpara> - - <note> - <para>Support for ASP-style tags was added in 3.0.4.</para> - </note> + <simpara> + Enables the use of ASP-like <% %> tags in addition to + the usual <?php ?> tags. This includes the + variable-value printing shorthand of <%= $value %>. For + more information, see <link linkend="language.basic-syntax.phpmode">Escaping from HTML</link>. + </simpara> + + <note> + <para>Support for ASP-style tags was added in 3.0.4.</para> + </note> </listitem> </varlistentry> <varlistentry id="ini.auto-append-file"> <term> - <parameter>auto_append_file</parameter> - <type>string</type> + <parameter>auto_append_file</parameter> + <type>string</type> </term> <listitem> - <para> - Specifies the name of a file that is automatically parsed - after the main file. The file is included as if it was - called with the <function>include</function> function, so - <link linkend="ini.include-path">include_path</link> is used.</para> - <para> - The special value <systemitem class="constant">none</systemitem> disables auto-appending. - <note> - <simpara> - If the script is terminated with <function>exit</function>, - auto-append will <emphasis>not</emphasis> occur.</simpara> - </note></para> + <para> + Specifies the name of a file that is automatically parsed + after the main file. The file is included as if it was + called with the <function>include</function> function, so + <link linkend="ini.include-path">include_path</link> is used.</para> + <para> + The special value <systemitem class="constant">none</systemitem> disables auto-appending. + <note> + <simpara> + If the script is terminated with <function>exit</function>, + auto-append will <emphasis>not</emphasis> occur.</simpara> + </note></para> </listitem> </varlistentry> <varlistentry id="ini.auto-prepend-file"> <term> - <parameter>auto_prepend_file</parameter> - <type>string</type> + <parameter>auto_prepend_file</parameter> + <type>string</type> </term> <listitem> - <para> - Specifies the name of a file that is automatically parsed - before the main file. The file is included as if it was - called with the <function>include</function> function, so - <link linkend="ini.include-path">include_path</link> is used.</para> - <para> - The special value <systemitem class="constant">none</systemitem> disables auto-prepending.</para> + <para> + Specifies the name of a file that is automatically parsed + before the main file. The file is included as if it was + called with the <function>include</function> function, so + <link linkend="ini.include-path">include_path</link> is used.</para> + <para> + The special value <systemitem class="constant">none</systemitem> disables auto-prepending.</para> </listitem> </varlistentry> <varlistentry id="ini.cgi-ext"> <term> - <parameter>cgi_ext</parameter> - <type>string</type> + <parameter>cgi_ext</parameter> + <type>string</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> <varlistentry id="ini.display-errors"> <term> - <parameter>display_errors</parameter> - <type>boolean</type> + <parameter>display_errors</parameter> + <type>boolean</type> </term> <listitem> - <para> - This determines whether errors should be printed to the screen - as part of the HTML output or not. - </para> + <para> + This determines whether errors should be printed to the screen + as part of the HTML output or not. + </para> </listitem> </varlistentry> <varlistentry id="ini.doc-root"> <term> - <parameter>doc_root</parameter> - <type>string</type> + <parameter>doc_root</parameter> + <type>string</type> </term> <listitem> - <para> - PHP's "root directory" on the server. Only used if - non-empty. If PHP is configured with <link linkend="ini.safe-mode">safe mode</link>, no files outside - this directory are served. - </para> + <para> + PHP's "root directory" on the server. Only used if + non-empty. If PHP is configured with <link linkend="ini.safe-mode">safe mode</link>, no files outside + this directory are served. + </para> </listitem> </varlistentry> <varlistentry id="ini.engine"> <term> - <parameter>engine</parameter> - <type>boolean</type> + <parameter>engine</parameter> + <type>boolean</type> </term> <listitem> - <para> - This directive is really only useful in the Apache module - version of PHP. It is used by sites that would like to turn - PHP parsing on and off on a per-directory or per-virtual - server basis. By putting <userinput>engine - off</userinput> in the appropriate places in the - <filename>httpd.conf</filename> file, PHP can be enabled or - disabled. - </para> + <para> + This directive is really only useful in the Apache module + version of PHP. It is used by sites that would like to turn + PHP parsing on and off on a per-directory or per-virtual + server basis. By putting <userinput>engine + off</userinput> in the appropriate places in the + <filename>httpd.conf</filename> file, PHP can be enabled or + disabled. + </para> </listitem> </varlistentry> <varlistentry id="ini.error-log"> <term> - <parameter>error_log</parameter> - <type>string</type> + <parameter>error_log</parameter> + <type>string</type> </term> <listitem> - <para> - Name of file where script errors should be logged. If the - special value <literal>syslog</literal> is used, the errors - are sent to the system logger instead. On UNIX, this means - syslog(3) and on Windows NT it means the event log. The - system logger is not supported on Windows 95.</para> + <para> + Name of file where script errors should be logged. If the + special value <literal>syslog</literal> is used, the errors + are sent to the system logger instead. On UNIX, this means + syslog(3) and on Windows NT it means the event log. The + system logger is not supported on Windows 95.</para> </listitem> </varlistentry> <varlistentry id="ini.error-reporting"> <term> - <parameter>error_reporting</parameter> - <type>integer</type> + <parameter>error_reporting</parameter> + <type>integer</type> </term> <listitem> - <para> - Set the error reporting level. The parameter is an integer - representing a bit field. Add the values of the error - reporting levels you want. - <table> - <title>Error Reporting Levels</title> - <tgroup cols="2"> - <thead> - <row> - <entry>bit value</entry> - <entry>enabled reporting</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry>normal errors</entry> - </row> - <row> - <entry>2</entry> - <entry>normal warnings</entry> - </row> - <row> - <entry>4</entry> - <entry>parser errors</entry> - </row> - <row> - <entry>8</entry> - <entry>non-critical style-related warnings</entry> - </row> - </tbody> - </tgroup> - </table> - The default value for this directive is 7 (normal errors, - normal warnings and parser errors are shown). - </para> + <para> + Set the error reporting level. The parameter is an integer + representing a bit field. Add the values of the error + reporting levels you want. + <table> + <title>Error Reporting Levels</title> + <tgroup cols="2"> + <thead> + <row> + <entry>bit value</entry> + <entry>enabled reporting</entry> + </row> + </thead> + <tbody> + <row> + <entry>1</entry> + <entry>normal errors</entry> + </row> + <row> + <entry>2</entry> + <entry>normal warnings</entry> + </row> + <row> + <entry>4</entry> + <entry>parser errors</entry> + </row> + <row> + <entry>8</entry> + <entry>non-critical style-related warnings</entry> + </row> + </tbody> + </tgroup> + </table> + The default value for this directive is 7 (normal errors, + normal warnings and parser errors are shown). + </para> </listitem> </varlistentry> @@ -293,178 +293,178 @@ <listitem> <para> Turn off HTML tags in error messages. - </para> + </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> - <parameter>open_basedir</parameter> - <type>string</type> + <parameter>open_basedir</parameter> + <type>string</type> </term> <listitem> - <para> - Limit the files that can be opened by PHP to the specified - directory-tree. - </para> - <para> - When a script tries to open a file with, - for example, fopen or gzopen, the location of the file is - checked. When the file is outside the specified directory-tree, - PHP will refuse to open it. All symbolic links are resolved, - so it's not possible to avoid this restriction with a symlink. - </para> - <para> - The special value <systemitem class="constant">.</systemitem> - indicates that the directory in which the script is stored will - be used as base-directory. - </para> - <para> - Under Windows, separate the directories with a semicolon. On all - other systems, separate the directories with a colon. As an Apache - module, open_basedir paths from parent directories are now - automatically inherited. - </para> + <para> + Limit the files that can be opened by PHP to the specified + directory-tree. + </para> + <para> + When a script tries to open a file with, + for example, fopen or gzopen, the location of the file is + checked. When the file is outside the specified directory-tree, + PHP will refuse to open it. All symbolic links are resolved, + so it's not possible to avoid this restriction with a symlink. + </para> + <para> + The special value <systemitem class="constant">.</systemitem> + indicates that the directory in which the script is stored will + be used as base-directory. + </para> + <para> + Under Windows, separate the directories with a semicolon. On all + other systems, separate the directories with a colon. As an Apache + module, open_basedir paths from parent directories are now + automatically inherited. + </para> <note> <para>Support for multiple directories was added in 3.0.7.</para> </note> - <para> - The default is to allow all files to be opened. - </para> + <para> + The default is to allow all files to be opened. + </para> </listitem> </varlistentry> <varlistentry id="ini.gpc-order"> <term> - <parameter>gpc_order</parameter> - <type>string</type> + <parameter>gpc_order</parameter> + <type>string</type> </term> <listitem> - <para> - Set the order of GET/POST/COOKIE variable parsing. The - default setting of this directive is "GPC". Setting this to - "GP", for example, will cause PHP to completely ignore cookies - and to overwrite any GET method variables with POST-method - variables of the same name. - </para> + <para> + Set the order of GET/POST/COOKIE variable parsing. The + default setting of this directive is "GPC". Setting this to + "GP", for example, will cause PHP to completely ignore cookies + and to overwrite any GET method variables with POST-method + variables of the same name. + </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-user-abort"> <term> - <parameter>ignore_user_abort</parameter> - <type>string</type> + <parameter>ignore_user_abort</parameter> + <type>string</type> </term> <listitem> - <para> - On by default. If changed to Off scripts will be terminated as + <para> + On by default. If changed to Off scripts will be terminated as soon as they try to output something after a client has aborted their connection. - <function>ignore_user_abort</function>. - </para> + <function>ignore_user_abort</function>. + </para> </listitem> </varlistentry> <varlistentry id="ini.include-path"> <term> - <parameter>include_path</parameter> - <type>string</type> + <parameter>include_path</parameter> + <type>string</type> </term> <listitem> - <para> - Specifies a list of directories where the - <function>require</function>, <function>include</function> - and <function>fopen_with_path</function> functions look for - files. The format is like the system's <envar>PATH</envar> - environment variable: a list of directories separated with a - colon in UNIX or semicolon in Windows. - <example> - <title>UNIX include_path</title> - <programlisting role="php3.ini"> + <para> + Specifies a list of directories where the + <function>require</function>, <function>include</function> + and <function>fopen_with_path</function> functions look for + files. The format is like the system's <envar>PATH</envar> + environment variable: a list of directories separated with a + colon in UNIX or semicolon in Windows. + <example> + <title>UNIX include_path</title> + <programlisting role="php3.ini"> include_path=.:/home/httpd/php-lib </programlisting> - </example> - <example> - <title>Windows include_path</title> - <programlisting role="php3.ini"> + </example> + <example> + <title>Windows include_path</title> + <programlisting role="php3.ini"> include_path=".;c:\www\phplib" </programlisting> - </example> - The default value for this directive is <literal>.</literal> - (only the current directory).</para> + </example> + The default value for this directive is <literal>.</literal> + (only the current directory).</para> </listitem> </varlistentry> <varlistentry id="ini.isapi-ext"> <term> - <parameter>isapi_ext</parameter> - <type>string</type> + <parameter>isapi_ext</parameter> + <type>string</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> <varlistentry id="ini.log-errors"> <term> - <parameter>log_errors</parameter> - <type>boolean</type> + <parameter>log_errors</parameter> + <type>boolean</type> </term> <listitem> - <para> - Tells whether script error messages should be logged to the - server's error log. This option is thus server-specific.</para> + <para> + Tells whether script error messages should be logged to the + server's error log. This option is thus server-specific.</para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-gpc"> <term> - <parameter>magic_quotes_gpc</parameter> - <type>boolean</type> + <parameter>magic_quotes_gpc</parameter> + <type>boolean</type> </term> <listitem> - <para> - Sets the magic_quotes state for GPC (Get/Post/Cookie) - operations. When magic_quotes are on, all ' (single-quote), - " (double quote), \ (backslash) and NUL's are escaped - with a backslash automatically. If magic_quotes_sybase is - also on, a single-quote is escaped with a single-quote - instead of a backslash. - </para> + <para> + Sets the magic_quotes state for GPC (Get/Post/Cookie) + operations. When magic_quotes are on, all ' (single-quote), + " (double quote), \ (backslash) and NUL's are escaped + with a backslash automatically. If magic_quotes_sybase is + also on, a single-quote is escaped with a single-quote + instead of a backslash. + </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-runtime"> <term> - <parameter>magic_quotes_runtime</parameter> - <type>boolean</type> + <parameter>magic_quotes_runtime</parameter> + <type>boolean</type> </term> <listitem> - <para> - If <parameter>magic_quotes_runtime</parameter> is enabled, - most functions that return data from any sort of external - source including databases and text files will have quotes - escaped with a backslash. If - <parameter>magic_quotes_sybase</parameter> is also on, a - single-quote is escaped with a single-quote instead of a - backslash. - </para> + <para> + If <parameter>magic_quotes_runtime</parameter> is enabled, + most functions that return data from any sort of external + source including databases and text files will have quotes + escaped with a backslash. If + <parameter>magic_quotes_sybase</parameter> is also on, a + single-quote is escaped with a single-quote instead of a + backslash. + </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-sybase"> <term> - <parameter>magic_quotes_sybase</parameter> - <type>boolean</type> + <parameter>magic_quotes_sybase</parameter> + <type>boolean</type> </term> <listitem> - <para> + <para> If <parameter>magic_quotes_sybase</parameter> is also on, a single-quote is escaped with a single-quote instead of a backslash if <parameter>magic_quotes_gpc</parameter> or <parameter>magic_quotes_runtime</parameter> is enabled. - </para> + </para> </listitem> </varlistentry> @@ -479,47 +479,47 @@ run before it is terminated by the parser. This helps prevent poorly written scripts from tying up the server. The default setting is <literal>30</literal>. - </para> - <para> - The maximum execution time is not affected by system calls, - the <function>sleep</function> function, etc. Please see the - <function>set_time_limit</function> function for more - details. + </para> + <para> + The maximum execution time is not affected by system calls, + the <function>sleep</function> function, etc. Please see the + <function>set_time_limit</function> function for more + details. </para> </listitem> </varlistentry> <varlistentry id="ini.memory-limit"> <term> - <parameter>memory_limit</parameter> - <type>integer</type> + <parameter>memory_limit</parameter> + <type>integer</type> </term> <listitem> - <para> - This sets the maximum amount of memory in bytes that a script - is allowed to allocate. This helps prevent poorly written - scripts for eating up all available memory on a server. - </para> + <para> + This sets the maximum amount of memory in bytes that a script + is allowed to allocate. This helps prevent poorly written + scripts for eating up all available memory on a server. + </para> </listitem> </varlistentry> <varlistentry id="ini.nsapi-ext"> <term> - <parameter>nsapi_ext</parameter> - <type>string</type> + <parameter>nsapi_ext</parameter> + <type>string</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> - + <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> <type>boolean</type> </term> - <listitem> + <listitem> <para> Tells whether or not to register the EGPCS (Environment, GET, POST, Cookie, Server) variables as global variables. You may @@ -535,44 +535,44 @@ <varname>$HTTP_SERVER_VARS</varname> arrays in the global scope. </para> - </listitem> + </listitem> </varlistentry> - + <varlistentry id="ini.short-open-tag"> <term> - <parameter>short_open_tag</parameter> - <type>boolean</type> + <parameter>short_open_tag</parameter> + <type>boolean</type> </term> <listitem> - <para> - Tells whether the short form (<userinput><? ?></userinput>) - of PHP's open tag should be allowed. If you want to use PHP in - combination with XML, you have to disable this option. If - disabled, you must use the long form of the open tag - (<userinput><?php ?></userinput>).</para> + <para> + Tells whether the short form (<userinput><? ?></userinput>) + of PHP's open tag should be allowed. If you want to use PHP in + combination with XML, you have to disable this option. If + disabled, you must use the long form of the open tag + (<userinput><?php ?></userinput>).</para> </listitem> </varlistentry> <varlistentry id="ini.sql.safe-mode"> <term> - <parameter>sql.safe_mode</parameter> - <type>boolean</type> + <parameter>sql.safe_mode</parameter> + <type>boolean</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> <varlistentry id="ini.track-errors"> <term> - <parameter>track_errors</parameter> - <type>boolean</type> + <parameter>track_errors</parameter> + <type>boolean</type> </term> <listitem> - <para> - If enabled, the last error message will always be present in the - global variable <symbol>$php_errormsg</symbol>.</para> + <para> + If enabled, the last error message will always be present in the + global variable <symbol>$php_errormsg</symbol>.</para> </listitem> </varlistentry> @@ -600,42 +600,56 @@ <varlistentry id="ini.upload-tmp-dir"> <term> - <parameter>upload_tmp_dir</parameter> - <type>string</type> + <parameter>upload_tmp_dir</parameter> + <type>string</type> </term> <listitem> - <para> - The temporary directory used for storing files when doing - file upload. Must be writable by whatever user PHP is - running as.</para> + <para> + The temporary directory used for storing files when doing + file upload. Must be writable by whatever user PHP is + running as. + </para> + </listitem> + </varlistentry> + + <varlistentry id="ini.upload-max-filesize"> + <term> + <parameter>upload_max_filesize</parameter> + <type>integer</type> + </term> + <listitem> + <para> + The maximum size of an uploaded file. The value is + in bytes. + </para> </listitem> </varlistentry> <varlistentry id="ini.user-dir"> <term> - <parameter>user_dir</parameter> - <type>string</type> + <parameter>user_dir</parameter> + <type>string</type> </term> <listitem> - <para> - The base name of the directory used on a user's home - directory for PHP files, for example - <literal>public_html</literal>.</para> + <para> + The base name of the directory used on a user's home + directory for PHP files, for example + <literal>public_html</literal>.</para> </listitem> </varlistentry> <varlistentry id="ini.warn-plus-overloading"> <term> - <parameter>warn_plus_overloading</parameter> - <type>boolean</type> + <parameter>warn_plus_overloading</parameter> + <type>boolean</type> </term> <listitem> - <para> - If enabled, this option makes PHP output a warning when the - plus (<literal>+</literal>) operator is used on strings. - This is to make it easier to find scripts that need to be - rewritten to using the string concatenator instead - (<literal>.</literal>).</para> + <para> + If enabled, this option makes PHP output a warning when the + plus (<literal>+</literal>) operator is used on strings. + This is to make it easier to find scripts that need to be + rewritten to using the string concatenator instead + (<literal>.</literal>).</para> </listitem> </varlistentry> @@ -654,9 +668,9 @@ </term> <listitem> <para> - DNS name or IP address of the SMTP server PHP under Windows - should use for mail sent with the <function>mail</function> - function.</para> + DNS name or IP address of the SMTP server PHP under Windows + should use for mail sent with the <function>mail</function> + function.</para> </listitem> </varlistentry> @@ -667,8 +681,8 @@ </term> <listitem> <para> - Which "From:" mail address should be used in mail sent from - PHP under Windows.</para> + Which "From:" mail address should be used in mail sent from + PHP under Windows.</para> </listitem> </varlistentry> @@ -679,18 +693,18 @@ </term> <listitem> <para> - Where the <command>sendmail</command> program can be found, - usually <filename>/usr/sbin/sendmail</filename> or - <filename>/usr/lib/sendmail</filename> - <command>configure</command> does an honest attempt of - locating this one for you and set a default, but if it fails, - you can set it here.</para> - <para> - Systems not using sendmail should set this directive to the - sendmail wrapper/replacement their mail system offers, if any. - For example, <ulink url="&url.qmail;">Qmail</ulink> - users can normally set it to - <filename>/var/qmail/bin/sendmail</filename>.</para> + Where the <command>sendmail</command> program can be found, + usually <filename>/usr/sbin/sendmail</filename> or + <filename>/usr/lib/sendmail</filename> + <command>configure</command> does an honest attempt of + locating this one for you and set a default, but if it fails, + you can set it here.</para> + <para> + Systems not using sendmail should set this directive to the + sendmail wrapper/replacement their mail system offers, if any. + For example, <ulink url="&url.qmail;">Qmail</ulink> + users can normally set it to + <filename>/var/qmail/bin/sendmail</filename>.</para> </listitem> </varlistentry> @@ -708,8 +722,8 @@ </term> <listitem> <para> - Whether to enable PHP's safe mode. Read the <link linkend="security">Security chapter</link> for more - more information.</para> + Whether to enable PHP's safe mode. Read the <link linkend="security">Security chapter</link> for more + more information.</para> </listitem> </varlistentry> @@ -720,9 +734,9 @@ </term> <listitem> <para> - If PHP is used in safe mode, <function>system</function> and - the other functions executing system programs refuse to start - programs that are not in this directory.</para> + If PHP is used in safe mode, <function>system</function> and + the other functions executing system programs refuse to start + programs that are not in this directory.</para> </listitem> </varlistentry> @@ -740,7 +754,7 @@ </term> <listitem> <para> - DNS name or IP address of host used by the debugger.</para> + DNS name or IP address of host used by the debugger.</para> </listitem> </varlistentry> @@ -751,7 +765,7 @@ </term> <listitem> <para> - Port number used by the debugger.</para> + Port number used by the debugger.</para> </listitem> </varlistentry> @@ -762,7 +776,7 @@ </term> <listitem> <para> - Whether the debugger is enabled.</para> + Whether the debugger is enabled.</para> </listitem> </varlistentry> @@ -775,26 +789,26 @@ <varlistentry id="ini.enable-dl"> <term> - <parameter>enable_dl</parameter> - <type>boolean</type> + <parameter>enable_dl</parameter> + <type>boolean</type> </term> <listitem> - <para> - This directive is really only useful in the Apache module - version of PHP. You can turn dynamic loading of PHP - extensions with <function>dl</function> on and off per - virtual server or per directory. - </para> - <para> - The main reason for turning dynamic loading off is - security. With dynamic loading, it's possible to ignore all - the safe_mode and open_basedir restrictions. - </para> - <para> - The default is to allow dynamic loading, except when using - safe-mode. In safe-mode, it's always imposible to use - <function>dl</function>. - </para> + <para> + This directive is really only useful in the Apache module + version of PHP. You can turn dynamic loading of PHP + extensions with <function>dl</function> on and off per + virtual server or per directory. + </para> + <para> + The main reason for turning dynamic loading off is + security. With dynamic loading, it's possible to ignore all + the safe_mode and open_basedir restrictions. + </para> + <para> + The default is to allow dynamic loading, except when using + safe-mode. In safe-mode, it's always imposible to use + <function>dl</function>. + </para> </listitem> </varlistentry> @@ -805,8 +819,8 @@ </term> <listitem> <para> - In what directory PHP should look for dynamically loadable - extensions.</para> + In what directory PHP should look for dynamically loadable + extensions.</para> </listitem> </varlistentry> @@ -817,8 +831,8 @@ </term> <listitem> <para> - Which dynamically loadable extensions to load when PHP starts - up.</para> + Which dynamically loadable extensions to load when PHP starts + up.</para> </listitem> </varlistentry> @@ -836,7 +850,7 @@ </term> <listitem> <para> - Whether to allow persistent MySQL connections. + Whether to allow persistent MySQL connections. </para> </listitem> </varlistentry> @@ -848,8 +862,8 @@ </term> <listitem> <para> - The default server host to use when connecting to the database - server if no other host is specified. + The default server host to use when connecting to the database + server if no other host is specified. </para> </listitem> </varlistentry> @@ -861,8 +875,8 @@ </term> <listitem> <para> - The default user name to use when connecting to the database - server if no other name is specified. + The default user name to use when connecting to the database + server if no other name is specified. </para> </listitem> </varlistentry> @@ -874,8 +888,8 @@ </term> <listitem> <para> - The default password to use when connecting to the database - server if no other password is specified. + The default password to use when connecting to the database + server if no other password is specified. </para> </listitem> </varlistentry> @@ -887,8 +901,8 @@ </term> <listitem> <para> - The maximum number of persistent MySQL connections per - process. + The maximum number of persistent MySQL connections per + process. </para> </listitem> </varlistentry> @@ -900,8 +914,8 @@ </term> <listitem> <para> - The maximum number of MySQL connections per process, including - persistent connections. + The maximum number of MySQL connections per process, including + persistent connections. </para> </listitem> </varlistentry> @@ -920,7 +934,7 @@ </term> <listitem> <para> - Whether to allow persistent mSQL connections. + Whether to allow persistent mSQL connections. </para> </listitem> </varlistentry> @@ -932,7 +946,7 @@ </term> <listitem> <para> - The maximum number of persistent mSQL connections per process. + The maximum number of persistent mSQL connections per process. </para> </listitem> </varlistentry> @@ -944,8 +958,8 @@ </term> <listitem> <para> - The maximum number of mSQL connections per process, including - persistent connections. + The maximum number of mSQL connections per process, including + persistent connections. </para> </listitem> </varlistentry> @@ -964,7 +978,7 @@ </term> <listitem> <para> - Whether to allow persistent Postgres connections. + Whether to allow persistent Postgres connections. </para> </listitem> </varlistentry> @@ -976,8 +990,8 @@ </term> <listitem> <para> - The maximum number of persistent Postgres connections per - process. + The maximum number of persistent Postgres connections per + process. </para> </listitem> </varlistentry> @@ -989,8 +1003,8 @@ </term> <listitem> <para> - The maximum number of Postgres connections per process, - including persistent connections. + The maximum number of Postgres connections per process, + including persistent connections. </para> </listitem> </varlistentry> @@ -1010,10 +1024,10 @@ </term> <listitem> <para> - Name of BS2000 PLAM library containing the loadable SESAM - driver modules. Required for using SESAM functions. The - BS2000 PLAM library must be set ACCESS=READ,SHARE=YES - because it must be readable by the apache server's user id. + Name of BS2000 PLAM library containing the loadable SESAM + driver modules. Required for using SESAM functions. The + BS2000 PLAM library must be set ACCESS=READ,SHARE=YES + because it must be readable by the apache server's user id. </para> </listitem> </varlistentry> @@ -1026,13 +1040,13 @@ <listitem> <para> Name of SESAM application configuration file. Required for - using SESAM functions. The BS2000 file must be readable by - the apache server's user id. + using SESAM functions. The BS2000 file must be readable by + the apache server's user id. </para> <para> The application configuration file will usually contain a - configuration like (see SESAM - reference manual): + configuration like (see SESAM + reference manual): <informalexample> <programlisting role="bs2000"> CNF=B @@ -1050,14 +1064,14 @@ </term> <listitem> <para> - Name of SESAM message catalog file. In most cases, this - directive is not neccessary. Only if the SESAM message file - is not installed in the system's BS2000 message file table, - it can be set with this directive. + Name of SESAM message catalog file. In most cases, this + directive is not neccessary. Only if the SESAM message file + is not installed in the system's BS2000 message file table, + it can be set with this directive. </para> <para> - The message catalog must be set ACCESS=READ,SHARE=YES because - it must be readable by the apache server's user id. + The message catalog must be set ACCESS=READ,SHARE=YES because + it must be readable by the apache server's user id. </para> </listitem> </varlistentry> @@ -1077,7 +1091,7 @@ </term> <listitem> <para> - Whether to allow persistent Sybase connections. + Whether to allow persistent Sybase connections. </para> </listitem> </varlistentry> @@ -1089,8 +1103,8 @@ </term> <listitem> <para> - The maximum number of persistent Sybase connections per - process. + The maximum number of persistent Sybase connections per + process. </para> </listitem> </varlistentry> @@ -1102,8 +1116,8 @@ </term> <listitem> <para> - The maximum number of Sybase connections per process, - including persistent connections. + The maximum number of Sybase connections per process, + including persistent connections. </para> </listitem> </varlistentry> @@ -1122,8 +1136,8 @@ </term> <listitem> <para> - Whether to allow persistent Sybase-CT connections. - The default is on. + Whether to allow persistent Sybase-CT connections. + The default is on. </para> </listitem> </varlistentry> @@ -1135,8 +1149,8 @@ </term> <listitem> <para> - The maximum number of persistent Sybase-CT connections per - process. The default is -1 meaning unlimited. + The maximum number of persistent Sybase-CT connections per + process. The default is -1 meaning unlimited. </para> </listitem> </varlistentry> @@ -1148,9 +1162,9 @@ </term> <listitem> <para> - The maximum number of Sybase-CT connections per process, - including persistent connections. The default is -1 meaning - unlimited. + The maximum number of Sybase-CT connections per process, + including persistent connections. The default is -1 meaning + unlimited. </para> </listitem> </varlistentry> @@ -1410,7 +1424,7 @@ </term> <listitem> <para> - Number of decimal digits for all bcmath functions. + Number of decimal digits for all bcmath functions. </para> </listitem> </varlistentry> @@ -1429,8 +1443,8 @@ </term> <listitem> <para> - Name of browser capabilities file. See also - <function>get_browser</function>. + Name of browser capabilities file. See also + <function>get_browser</function>. </para> </listitem> </varlistentry> @@ -1449,9 +1463,9 @@ </term> <listitem> <para> - ODBC data source to use if none is specified in - <function>odbc_connect</function> or - <function>odbc_pconnect</function>. + ODBC data source to use if none is specified in + <function>odbc_connect</function> or + <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> @@ -1463,9 +1477,9 @@ </term> <listitem> <para> - User name to use if none is specified in - <function>odbc_connect</function> or - <function>odbc_pconnect</function>. + User name to use if none is specified in + <function>odbc_connect</function> or + <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> @@ -1477,9 +1491,9 @@ </term> <listitem> <para> - Password to use if none is specified in - <function>odbc_connect</function> or - <function>odbc_pconnect</function>. + Password to use if none is specified in + <function>odbc_connect</function> or + <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> @@ -1491,7 +1505,7 @@ </term> <listitem> <para> - Whether to allow persistent ODBC connections. + Whether to allow persistent ODBC connections. </para> </listitem> </varlistentry> @@ -1503,7 +1517,7 @@ </term> <listitem> <para> - The maximum number of persistent ODBC connections per process. + The maximum number of persistent ODBC connections per process. </para> </listitem> </varlistentry> @@ -1515,8 +1529,8 @@ </term> <listitem> <para> - The maximum number of ODBC connections per process, including - persistent connections. + The maximum number of ODBC connections per process, including + persistent connections. </para> </listitem> </varlistentry> @@ -1536,7 +1550,7 @@ <listitem> <para> <literal>mbstring.internal_encoding</literal> defines default - internal character encoding. + internal character encoding. </para> </listitem> </varlistentry> @@ -1549,7 +1563,7 @@ <listitem> <para> <literal>mbstring.http_input</literal> defines default - HTTP input character encoding. + HTTP input character encoding. </para> </listitem> </varlistentry> @@ -1562,7 +1576,7 @@ <listitem> <para> <literal>mbstring.http_output</literal> defines default - HTTP output character encoding. + HTTP output character encoding. </para> </listitem> </varlistentry> @@ -1575,7 +1589,7 @@ <listitem> <para> <literal>mbstring.detect_order</literal> defines default - character encoding detection order. + character encoding detection order. </para> </listitem> </varlistentry> Index: phpdoc/en/features/file-upload.xml diff -u phpdoc/en/features/file-upload.xml:1.18 phpdoc/en/features/file-upload.xml:1.19 --- phpdoc/en/features/file-upload.xml:1.18 Sat Jan 20 16:08:27 2001 +++ phpdoc/en/features/file-upload.xml Tue Jul 10 17:12:59 2001 @@ -35,15 +35,23 @@ The _URL_ should point to a PHP file. The MAX_FILE_SIZE hidden field must precede the file input field and its value is the maximum filesize accepted. The value is in bytes. + <warning> + <para> + The MAX_FILE_SIZE is advisory to the browser. It is easy to + circumvent this maximum. So don't count on it that the browser + obeys you wish! The PHP-settings for maximum-size, however, + cannot be fooled. + </para> + </warning> </para> <para> - In PHP 3, the following variables will be defined within the + In PHP, the following variables will be defined within the destination script upon a successful upload, assuming that <link linkend="ini.register-globals">register_globals</link> is turned - on in <filename>php3.ini</filename>. If <link + on in <filename>php.ini</filename>. If <link linkend="ini.track-vars">track_vars</link> is turned on, they will - also be available in PHP 3 within the global array + also be available in PHP within the global array <varname>$HTTP_POST_VARS</varname>. Note that the following variable names assume the use of the file upload name 'userfile', as used in the example above: @@ -215,9 +223,10 @@ <sect1 id="features.file-upload.common-pitfalls"> <title>Common Pitfalls</title> <simpara> - The MAX_FILE_SIZE item cannot specify a file size greater than the file - size that has been set in the upload_max_filesize in the PHP 3.ini file - or the corresponding php3_upload_max_filesize Apache .conf directive. + The <literal>MAX_FILE_SIZE</literal> item cannot specify a file size + greater than the file + size that has been set in the <link + linkend="ini.upload-max-filesize">upload_max_filesize</link> ini-setting. The default is 2 Megabytes. </simpara> <simpara> @@ -232,7 +241,7 @@ </simpara> </sect1> - <sect1 id="feature-fileupload.multiple"> + <sect1 id="features.file-upload.multiple"> <title>Uploading multiple files</title> <simpara> It is possible to upload multiple files simultaneously and have @@ -248,7 +257,7 @@ <para> <example> <title>Uploading multiple files</title> - <programlisting> + <programlisting role="html"> <form action="file-upload.php" method="post" enctype="multipart/form-data"> Send these files:<br> <input name="userfile[]" type="file"><br> @@ -260,9 +269,9 @@ </para> <simpara> When the above form is submitted, the arrays - <computeroutput>$userfile</computeroutput>, - <computeroutput>$userfile_name</computeroutput>, and - <computeroutput>$userfile_size</computeroutput> will be formed in + <varname>$userfile</varname>, + <varname>$userfile_name</varname>, and + <varname>$userfile_size</varname> will be formed in the global scope (as well as in $HTTP_POST_FILES ($HTTP_POST_VARS in PHP 3)). Each of these will be a numerically indexed array of the appropriate values for the submitted files. @@ -271,19 +280,19 @@ For instance, assume that the filenames <filename>/home/test/review.html</filename> and <filename>/home/test/xwp.out</filename> are submitted. In this - case, <computeroutput>$userfile_name[0]</computeroutput> would - contain the value <computeroutput>review.html</computeroutput>, - and <computeroutput>$userfile_name[1]</computeroutput> would + case, <varname>$userfile_name[0]</varname> would + contain the value <literal>review.html</literal>, + and <varname>$userfile_name[1]</varname> would contain the value - <computeroutput>xwp.out</computeroutput>. Similarly, - <computeroutput>$userfile_size[0]</computeroutput> would contain + <varname>xwp.out</varname>. Similarly, + <varname>$userfile_size[0]</varname> would contain <filename>review.html</filename>'s filesize, and so forth. </simpara> <simpara> - <computeroutput>$userfile['name'][0]</computeroutput>, - <computeroutput>$userfile['tmp_name'][0]</computeroutput>, - <computeroutput>$userfile['size'][0]</computeroutput>, and - <computeroutput>$userfile['type'][0]</computeroutput> are also set. + <varname>$userfile['name'][0]</varname>, + <varname>$userfile['tmp_name'][0]</varname>, + <varname>$userfile['size'][0]</varname>, and + <varname>$userfile['type'][0]</varname> are also set. </simpara> </sect1> @@ -313,18 +322,18 @@ a <Virtualhost> block. A line like this would do the trick: <informalexample> <programlisting> -Script PUT /put.php3 +Script PUT /put.php </programlisting> </informalexample> </para> <simpara> This tells Apache to send all PUT requests for URIs that match the - context in which you put this line to the put.php3 script. This - assumes, of course, that you have PHP enabled for the .php3 + context in which you put this line to the put.php script. This + assumes, of course, that you have PHP enabled for the .php extension and PHP is active. </simpara> <simpara> - Inside your put.php3 file you would then do something like this: + Inside your put.php file you would then do something like this: </simpara> <para> <informalexample><programlisting> Index: phpdoc/en/features/safe-mode.xml diff -u phpdoc/en/features/safe-mode.xml:1.2 phpdoc/en/features/safe-mode.xml:1.3 --- phpdoc/en/features/safe-mode.xml:1.2 Tue Jul 10 16:36:22 2001 +++ phpdoc/en/features/safe-mode.xml Tue Jul 10 17:12:59 2001 @@ -22,10 +22,10 @@ When safe_mode is on, PHP checks to see if the owner of the current script matches the owner of the file to be operated on by a file function. For example: - <computeroutput> + <programlisting role="ls"> -rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php -rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd - </computeroutput> + </programlisting> Running this script.php <programlisting role="php"> <?php @@ -33,10 +33,10 @@ ?> </programlisting> results in this error when safe mode is enabled: - <computeroutput> + <programlisting role="php"> Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 - </computeroutput> + </programlisting> </para> <para> If instead of safe_mode, you set an open_basedir directory then all file @@ -49,10 +49,10 @@ </programlisting> If you run the same script.php with this open_basedir setting then this is the result: - <computeroutput> + <programlisting role="php"> Warning: open_basedir restriction in effect. File is in wrong directory in /docroot/script.php on line 2 - </computeroutput> + </programlisting> </para> <para> You can also disable individual functions. If we add this to our php.ini @@ -61,9 +61,10 @@ disable_functions readfile,system </programlisting> Then we get this output: - <computeroutput> -Warning: readfile() has been disabled for security reasons in /docroot/script.php on line 2 - </computeroutput> + <programlisting role="php"> +Warning: readfile() has been disabled for security reasons in +/docroot/script.php on line 2 + </programlisting> </para> </chapter>
Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.16 phpdoc/en/chapters/config.xml:1.17 --- phpdoc/en/chapters/config.xml:1.16 Sat Jul 7 14:42:14 2001 +++ phpdoc/en/chapters/config.xml Tue Jul 10 17:12:59 2001 @@ -89,199 +89,199 @@ <variablelist> <varlistentry id="ini.allow-url-fopen"> <term> - <parameter>allow_url_fopen</parameter> - <type>boolean</type> + <parameter>allow_url_fopen</parameter> + <type>boolean</type> </term> <listitem> - <para> - This option enables the URL-aware fopen wrappers that enable accessing URL object - like files. Default wrappers are provided for the access of - <link linkend="features.remote-files">remote files</link> - using the ftp or http protocol, some extensions like zlib may register additional wrappers. - </para> - - <note> - <para> - This option was introduced immediately after the release of version 4.0.3. - For versions up to and including 4.0.3 you can only disable this feature at - compile time by using the configuration switch - <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. - </para> - </note> + <para> + This option enables the URL-aware fopen wrappers that enable accessing URL object + like files. Default wrappers are provided for the access of + <link linkend="features.remote-files">remote files</link> + using the ftp or http protocol, some extensions like zlib may register additional wrappers. + </para> + + <note> + <para> + This option was introduced immediately after the release of version 4.0.3. + For versions up to and including 4.0.3 you can only disable this feature at + compile time by using the configuration switch + <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>. + </para> + </note> </listitem> </varlistentry> <varlistentry id="ini.asp-tags"> <term> - <parameter>asp_tags</parameter> - <type>boolean</type> + <parameter>asp_tags</parameter> + <type>boolean</type> </term> <listitem> - <simpara> - Enables the use of ASP-like <% %> tags in addition to - the usual <?php ?> tags. This includes the - variable-value printing shorthand of <%= $value %>. For - more information, see <link linkend="language.basic-syntax.phpmode">Escaping from HTML</link>. - </simpara> - - <note> - <para>Support for ASP-style tags was added in 3.0.4.</para> - </note> + <simpara> + Enables the use of ASP-like <% %> tags in addition to + the usual <?php ?> tags. This includes the + variable-value printing shorthand of <%= $value %>. For + more information, see <link linkend="language.basic-syntax.phpmode">Escaping from HTML</link>. + </simpara> + + <note> + <para>Support for ASP-style tags was added in 3.0.4.</para> + </note> </listitem> </varlistentry> <varlistentry id="ini.auto-append-file"> <term> - <parameter>auto_append_file</parameter> - <type>string</type> + <parameter>auto_append_file</parameter> + <type>string</type> </term> <listitem> - <para> - Specifies the name of a file that is automatically parsed - after the main file. The file is included as if it was - called with the <function>include</function> function, so - <link linkend="ini.include-path">include_path</link> is used.</para> - <para> - The special value <systemitem class="constant">none</systemitem> disables auto-appending. - <note> - <simpara> - If the script is terminated with <function>exit</function>, - auto-append will <emphasis>not</emphasis> occur.</simpara> - </note></para> + <para> + Specifies the name of a file that is automatically parsed + after the main file. The file is included as if it was + called with the <function>include</function> function, so + <link linkend="ini.include-path">include_path</link> is used.</para> + <para> + The special value <systemitem class="constant">none</systemitem> disables auto-appending. + <note> + <simpara> + If the script is terminated with <function>exit</function>, + auto-append will <emphasis>not</emphasis> occur.</simpara> + </note></para> </listitem> </varlistentry> <varlistentry id="ini.auto-prepend-file"> <term> - <parameter>auto_prepend_file</parameter> - <type>string</type> + <parameter>auto_prepend_file</parameter> + <type>string</type> </term> <listitem> - <para> - Specifies the name of a file that is automatically parsed - before the main file. The file is included as if it was - called with the <function>include</function> function, so - <link linkend="ini.include-path">include_path</link> is used.</para> - <para> - The special value <systemitem class="constant">none</systemitem> disables auto-prepending.</para> + <para> + Specifies the name of a file that is automatically parsed + before the main file. The file is included as if it was + called with the <function>include</function> function, so + <link linkend="ini.include-path">include_path</link> is used.</para> + <para> + The special value <systemitem class="constant">none</systemitem> disables auto-prepending.</para> </listitem> </varlistentry> <varlistentry id="ini.cgi-ext"> <term> - <parameter>cgi_ext</parameter> - <type>string</type> + <parameter>cgi_ext</parameter> + <type>string</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> <varlistentry id="ini.display-errors"> <term> - <parameter>display_errors</parameter> - <type>boolean</type> + <parameter>display_errors</parameter> + <type>boolean</type> </term> <listitem> - <para> - This determines whether errors should be printed to the screen - as part of the HTML output or not. - </para> + <para> + This determines whether errors should be printed to the screen + as part of the HTML output or not. + </para> </listitem> </varlistentry> <varlistentry id="ini.doc-root"> <term> - <parameter>doc_root</parameter> - <type>string</type> + <parameter>doc_root</parameter> + <type>string</type> </term> <listitem> - <para> - PHP's "root directory" on the server. Only used if - non-empty. If PHP is configured with <link linkend="ini.safe-mode">safe mode</link>, no files outside - this directory are served. - </para> + <para> + PHP's "root directory" on the server. Only used if + non-empty. If PHP is configured with <link linkend="ini.safe-mode">safe mode</link>, no files outside + this directory are served. + </para> </listitem> </varlistentry> <varlistentry id="ini.engine"> <term> - <parameter>engine</parameter> - <type>boolean</type> + <parameter>engine</parameter> + <type>boolean</type> </term> <listitem> - <para> - This directive is really only useful in the Apache module - version of PHP. It is used by sites that would like to turn - PHP parsing on and off on a per-directory or per-virtual - server basis. By putting <userinput>engine - off</userinput> in the appropriate places in the - <filename>httpd.conf</filename> file, PHP can be enabled or - disabled. - </para> + <para> + This directive is really only useful in the Apache module + version of PHP. It is used by sites that would like to turn + PHP parsing on and off on a per-directory or per-virtual + server basis. By putting <userinput>engine + off</userinput> in the appropriate places in the + <filename>httpd.conf</filename> file, PHP can be enabled or + disabled. + </para> </listitem> </varlistentry> <varlistentry id="ini.error-log"> <term> - <parameter>error_log</parameter> - <type>string</type> + <parameter>error_log</parameter> + <type>string</type> </term> <listitem> - <para> - Name of file where script errors should be logged. If the - special value <literal>syslog</literal> is used, the errors - are sent to the system logger instead. On UNIX, this means - syslog(3) and on Windows NT it means the event log. The - system logger is not supported on Windows 95.</para> + <para> + Name of file where script errors should be logged. If the + special value <literal>syslog</literal> is used, the errors + are sent to the system logger instead. On UNIX, this means + syslog(3) and on Windows NT it means the event log. The + system logger is not supported on Windows 95.</para> </listitem> </varlistentry> <varlistentry id="ini.error-reporting"> <term> - <parameter>error_reporting</parameter> - <type>integer</type> + <parameter>error_reporting</parameter> + <type>integer</type> </term> <listitem> - <para> - Set the error reporting level. The parameter is an integer - representing a bit field. Add the values of the error - reporting levels you want. - <table> - <title>Error Reporting Levels</title> - <tgroup cols="2"> - <thead> - <row> - <entry>bit value</entry> - <entry>enabled reporting</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry>normal errors</entry> - </row> - <row> - <entry>2</entry> - <entry>normal warnings</entry> - </row> - <row> - <entry>4</entry> - <entry>parser errors</entry> - </row> - <row> - <entry>8</entry> - <entry>non-critical style-related warnings</entry> - </row> - </tbody> - </tgroup> - </table> - The default value for this directive is 7 (normal errors, - normal warnings and parser errors are shown). - </para> + <para> + Set the error reporting level. The parameter is an integer + representing a bit field. Add the values of the error + reporting levels you want. + <table> + <title>Error Reporting Levels</title> + <tgroup cols="2"> + <thead> + <row> + <entry>bit value</entry> + <entry>enabled reporting</entry> + </row> + </thead> + <tbody> + <row> + <entry>1</entry> + <entry>normal errors</entry> + </row> + <row> + <entry>2</entry> + <entry>normal warnings</entry> + </row> + <row> + <entry>4</entry> + <entry>parser errors</entry> + </row> + <row> + <entry>8</entry> + <entry>non-critical style-related warnings</entry> + </row> + </tbody> + </tgroup> + </table> + The default value for this directive is 7 (normal errors, + normal warnings and parser errors are shown). + </para> </listitem> </varlistentry> @@ -293,178 +293,178 @@ <listitem> <para> Turn off HTML tags in error messages. - </para> + </para> </listitem> </varlistentry> <varlistentry id="ini.open-basedir"> <term> - <parameter>open_basedir</parameter> - <type>string</type> + <parameter>open_basedir</parameter> + <type>string</type> </term> <listitem> - <para> - Limit the files that can be opened by PHP to the specified - directory-tree. - </para> - <para> - When a script tries to open a file with, - for example, fopen or gzopen, the location of the file is - checked. When the file is outside the specified directory-tree, - PHP will refuse to open it. All symbolic links are resolved, - so it's not possible to avoid this restriction with a symlink. - </para> - <para> - The special value <systemitem class="constant">.</systemitem> - indicates that the directory in which the script is stored will - be used as base-directory. - </para> - <para> - Under Windows, separate the directories with a semicolon. On all - other systems, separate the directories with a colon. As an Apache - module, open_basedir paths from parent directories are now - automatically inherited. - </para> + <para> + Limit the files that can be opened by PHP to the specified + directory-tree. + </para> + <para> + When a script tries to open a file with, + for example, fopen or gzopen, the location of the file is + checked. When the file is outside the specified directory-tree, + PHP will refuse to open it. All symbolic links are resolved, + so it's not possible to avoid this restriction with a symlink. + </para> + <para> + The special value <systemitem class="constant">.</systemitem> + indicates that the directory in which the script is stored will + be used as base-directory. + </para> + <para> + Under Windows, separate the directories with a semicolon. On all + other systems, separate the directories with a colon. As an Apache + module, open_basedir paths from parent directories are now + automatically inherited. + </para> <note> <para>Support for multiple directories was added in 3.0.7.</para> </note> - <para> - The default is to allow all files to be opened. - </para> + <para> + The default is to allow all files to be opened. + </para> </listitem> </varlistentry> <varlistentry id="ini.gpc-order"> <term> - <parameter>gpc_order</parameter> - <type>string</type> + <parameter>gpc_order</parameter> + <type>string</type> </term> <listitem> - <para> - Set the order of GET/POST/COOKIE variable parsing. The - default setting of this directive is "GPC". Setting this to - "GP", for example, will cause PHP to completely ignore cookies - and to overwrite any GET method variables with POST-method - variables of the same name. - </para> + <para> + Set the order of GET/POST/COOKIE variable parsing. The + default setting of this directive is "GPC". Setting this to + "GP", for example, will cause PHP to completely ignore cookies + and to overwrite any GET method variables with POST-method + variables of the same name. + </para> </listitem> </varlistentry> <varlistentry id="ini.ignore-user-abort"> <term> - <parameter>ignore_user_abort</parameter> - <type>string</type> + <parameter>ignore_user_abort</parameter> + <type>string</type> </term> <listitem> - <para> - On by default. If changed to Off scripts will be terminated as + <para> + On by default. If changed to Off scripts will be terminated as soon as they try to output something after a client has aborted their connection. - <function>ignore_user_abort</function>. - </para> + <function>ignore_user_abort</function>. + </para> </listitem> </varlistentry> <varlistentry id="ini.include-path"> <term> - <parameter>include_path</parameter> - <type>string</type> + <parameter>include_path</parameter> + <type>string</type> </term> <listitem> - <para> - Specifies a list of directories where the - <function>require</function>, <function>include</function> - and <function>fopen_with_path</function> functions look for - files. The format is like the system's <envar>PATH</envar> - environment variable: a list of directories separated with a - colon in UNIX or semicolon in Windows. - <example> - <title>UNIX include_path</title> - <programlisting role="php3.ini"> + <para> + Specifies a list of directories where the + <function>require</function>, <function>include</function> + and <function>fopen_with_path</function> functions look for + files. The format is like the system's <envar>PATH</envar> + environment variable: a list of directories separated with a + colon in UNIX or semicolon in Windows. + <example> + <title>UNIX include_path</title> + <programlisting role="php3.ini"> include_path=.:/home/httpd/php-lib </programlisting> - </example> - <example> - <title>Windows include_path</title> - <programlisting role="php3.ini"> + </example> + <example> + <title>Windows include_path</title> + <programlisting role="php3.ini"> include_path=".;c:\www\phplib" </programlisting> - </example> - The default value for this directive is <literal>.</literal> - (only the current directory).</para> + </example> + The default value for this directive is <literal>.</literal> + (only the current directory).</para> </listitem> </varlistentry> <varlistentry id="ini.isapi-ext"> <term> - <parameter>isapi_ext</parameter> - <type>string</type> + <parameter>isapi_ext</parameter> + <type>string</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> <varlistentry id="ini.log-errors"> <term> - <parameter>log_errors</parameter> - <type>boolean</type> + <parameter>log_errors</parameter> + <type>boolean</type> </term> <listitem> - <para> - Tells whether script error messages should be logged to the - server's error log. This option is thus server-specific.</para> + <para> + Tells whether script error messages should be logged to the + server's error log. This option is thus server-specific.</para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-gpc"> <term> - <parameter>magic_quotes_gpc</parameter> - <type>boolean</type> + <parameter>magic_quotes_gpc</parameter> + <type>boolean</type> </term> <listitem> - <para> - Sets the magic_quotes state for GPC (Get/Post/Cookie) - operations. When magic_quotes are on, all ' (single-quote), - " (double quote), \ (backslash) and NUL's are escaped - with a backslash automatically. If magic_quotes_sybase is - also on, a single-quote is escaped with a single-quote - instead of a backslash. - </para> + <para> + Sets the magic_quotes state for GPC (Get/Post/Cookie) + operations. When magic_quotes are on, all ' (single-quote), + " (double quote), \ (backslash) and NUL's are escaped + with a backslash automatically. If magic_quotes_sybase is + also on, a single-quote is escaped with a single-quote + instead of a backslash. + </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-runtime"> <term> - <parameter>magic_quotes_runtime</parameter> - <type>boolean</type> + <parameter>magic_quotes_runtime</parameter> + <type>boolean</type> </term> <listitem> - <para> - If <parameter>magic_quotes_runtime</parameter> is enabled, - most functions that return data from any sort of external - source including databases and text files will have quotes - escaped with a backslash. If - <parameter>magic_quotes_sybase</parameter> is also on, a - single-quote is escaped with a single-quote instead of a - backslash. - </para> + <para> + If <parameter>magic_quotes_runtime</parameter> is enabled, + most functions that return data from any sort of external + source including databases and text files will have quotes + escaped with a backslash. If + <parameter>magic_quotes_sybase</parameter> is also on, a + single-quote is escaped with a single-quote instead of a + backslash. + </para> </listitem> </varlistentry> <varlistentry id="ini.magic-quotes-sybase"> <term> - <parameter>magic_quotes_sybase</parameter> - <type>boolean</type> + <parameter>magic_quotes_sybase</parameter> + <type>boolean</type> </term> <listitem> - <para> + <para> If <parameter>magic_quotes_sybase</parameter> is also on, a single-quote is escaped with a single-quote instead of a backslash if <parameter>magic_quotes_gpc</parameter> or <parameter>magic_quotes_runtime</parameter> is enabled. - </para> + </para> </listitem> </varlistentry> @@ -479,47 +479,47 @@ run before it is terminated by the parser. This helps prevent poorly written scripts from tying up the server. The default setting is <literal>30</literal>. - </para> - <para> - The maximum execution time is not affected by system calls, - the <function>sleep</function> function, etc. Please see the - <function>set_time_limit</function> function for more - details. + </para> + <para> + The maximum execution time is not affected by system calls, + the <function>sleep</function> function, etc. Please see the + <function>set_time_limit</function> function for more + details. </para> </listitem> </varlistentry> <varlistentry id="ini.memory-limit"> <term> - <parameter>memory_limit</parameter> - <type>integer</type> + <parameter>memory_limit</parameter> + <type>integer</type> </term> <listitem> - <para> - This sets the maximum amount of memory in bytes that a script - is allowed to allocate. This helps prevent poorly written - scripts for eating up all available memory on a server. - </para> + <para> + This sets the maximum amount of memory in bytes that a script + is allowed to allocate. This helps prevent poorly written + scripts for eating up all available memory on a server. + </para> </listitem> </varlistentry> <varlistentry id="ini.nsapi-ext"> <term> - <parameter>nsapi_ext</parameter> - <type>string</type> + <parameter>nsapi_ext</parameter> + <type>string</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> - + <varlistentry id="ini.register-globals"> <term> <parameter>register_globals</parameter> <type>boolean</type> </term> - <listitem> + <listitem> <para> Tells whether or not to register the EGPCS (Environment, GET, POST, Cookie, Server) variables as global variables. You may @@ -535,44 +535,44 @@ <varname>$HTTP_SERVER_VARS</varname> arrays in the global scope. </para> - </listitem> + </listitem> </varlistentry> - + <varlistentry id="ini.short-open-tag"> <term> - <parameter>short_open_tag</parameter> - <type>boolean</type> + <parameter>short_open_tag</parameter> + <type>boolean</type> </term> <listitem> - <para> - Tells whether the short form (<userinput><? ?></userinput>) - of PHP's open tag should be allowed. If you want to use PHP in - combination with XML, you have to disable this option. If - disabled, you must use the long form of the open tag - (<userinput><?php ?></userinput>).</para> + <para> + Tells whether the short form (<userinput><? ?></userinput>) + of PHP's open tag should be allowed. If you want to use PHP in + combination with XML, you have to disable this option. If + disabled, you must use the long form of the open tag + (<userinput><?php ?></userinput>).</para> </listitem> </varlistentry> <varlistentry id="ini.sql.safe-mode"> <term> - <parameter>sql.safe_mode</parameter> - <type>boolean</type> + <parameter>sql.safe_mode</parameter> + <type>boolean</type> </term> <listitem> - <para> - </para> + <para> + </para> </listitem> </varlistentry> <varlistentry id="ini.track-errors"> <term> - <parameter>track_errors</parameter> - <type>boolean</type> + <parameter>track_errors</parameter> + <type>boolean</type> </term> <listitem> - <para> - If enabled, the last error message will always be present in the - global variable <symbol>$php_errormsg</symbol>.</para> + <para> + If enabled, the last error message will always be present in the + global variable <symbol>$php_errormsg</symbol>.</para> </listitem> </varlistentry> @@ -600,42 +600,56 @@ <varlistentry id="ini.upload-tmp-dir"> <term> - <parameter>upload_tmp_dir</parameter> - <type>string</type> + <parameter>upload_tmp_dir</parameter> + <type>string</type> </term> <listitem> - <para> - The temporary directory used for storing files when doing - file upload. Must be writable by whatever user PHP is - running as.</para> + <para> + The temporary directory used for storing files when doing + file upload. Must be writable by whatever user PHP is + running as. + </para> + </listitem> + </varlistentry> + + <varlistentry id="ini.upload-max-filesize"> + <term> + <parameter>upload_max_filesize</parameter> + <type>integer</type> + </term> + <listitem> + <para> + The maximum size of an uploaded file. The value is + in bytes. + </para> </listitem> </varlistentry> <varlistentry id="ini.user-dir"> <term> - <parameter>user_dir</parameter> - <type>string</type> + <parameter>user_dir</parameter> + <type>string</type> </term> <listitem> - <para> - The base name of the directory used on a user's home - directory for PHP files, for example - <literal>public_html</literal>.</para> + <para> + The base name of the directory used on a user's home + directory for PHP files, for example + <literal>public_html</literal>.</para> </listitem> </varlistentry> <varlistentry id="ini.warn-plus-overloading"> <term> - <parameter>warn_plus_overloading</parameter> - <type>boolean</type> + <parameter>warn_plus_overloading</parameter> + <type>boolean</type> </term> <listitem> - <para> - If enabled, this option makes PHP output a warning when the - plus (<literal>+</literal>) operator is used on strings. - This is to make it easier to find scripts that need to be - rewritten to using the string concatenator instead - (<literal>.</literal>).</para> + <para> + If enabled, this option makes PHP output a warning when the + plus (<literal>+</literal>) operator is used on strings. + This is to make it easier to find scripts that need to be + rewritten to using the string concatenator instead + (<literal>.</literal>).</para> </listitem> </varlistentry> @@ -654,9 +668,9 @@ </term> <listitem> <para> - DNS name or IP address of the SMTP server PHP under Windows - should use for mail sent with the <function>mail</function> - function.</para> + DNS name or IP address of the SMTP server PHP under Windows + should use for mail sent with the <function>mail</function> + function.</para> </listitem> </varlistentry> @@ -667,8 +681,8 @@ </term> <listitem> <para> - Which "From:" mail address should be used in mail sent from - PHP under Windows.</para> + Which "From:" mail address should be used in mail sent from + PHP under Windows.</para> </listitem> </varlistentry> @@ -679,18 +693,18 @@ </term> <listitem> <para> - Where the <command>sendmail</command> program can be found, - usually <filename>/usr/sbin/sendmail</filename> or - <filename>/usr/lib/sendmail</filename> - <command>configure</command> does an honest attempt of - locating this one for you and set a default, but if it fails, - you can set it here.</para> - <para> - Systems not using sendmail should set this directive to the - sendmail wrapper/replacement their mail system offers, if any. - For example, <ulink url="&url.qmail;">Qmail</ulink> - users can normally set it to - <filename>/var/qmail/bin/sendmail</filename>.</para> + Where the <command>sendmail</command> program can be found, + usually <filename>/usr/sbin/sendmail</filename> or + <filename>/usr/lib/sendmail</filename> + <command>configure</command> does an honest attempt of + locating this one for you and set a default, but if it fails, + you can set it here.</para> + <para> + Systems not using sendmail should set this directive to the + sendmail wrapper/replacement their mail system offers, if any. + For example, <ulink url="&url.qmail;">Qmail</ulink> + users can normally set it to + <filename>/var/qmail/bin/sendmail</filename>.</para> </listitem> </varlistentry> @@ -708,8 +722,8 @@ </term> <listitem> <para> - Whether to enable PHP's safe mode. Read the <link linkend="security">Security chapter</link> for more - more information.</para> + Whether to enable PHP's safe mode. Read the <link linkend="security">Security chapter</link> for more + more information.</para> </listitem> </varlistentry> @@ -720,9 +734,9 @@ </term> <listitem> <para> - If PHP is used in safe mode, <function>system</function> and - the other functions executing system programs refuse to start - programs that are not in this directory.</para> + If PHP is used in safe mode, <function>system</function> and + the other functions executing system programs refuse to start + programs that are not in this directory.</para> </listitem> </varlistentry> @@ -740,7 +754,7 @@ </term> <listitem> <para> - DNS name or IP address of host used by the debugger.</para> + DNS name or IP address of host used by the debugger.</para> </listitem> </varlistentry> @@ -751,7 +765,7 @@ </term> <listitem> <para> - Port number used by the debugger.</para> + Port number used by the debugger.</para> </listitem> </varlistentry> @@ -762,7 +776,7 @@ </term> <listitem> <para> - Whether the debugger is enabled.</para> + Whether the debugger is enabled.</para> </listitem> </varlistentry> @@ -775,26 +789,26 @@ <varlistentry id="ini.enable-dl"> <term> - <parameter>enable_dl</parameter> - <type>boolean</type> + <parameter>enable_dl</parameter> + <type>boolean</type> </term> <listitem> - <para> - This directive is really only useful in the Apache module - version of PHP. You can turn dynamic loading of PHP - extensions with <function>dl</function> on and off per - virtual server or per directory. - </para> - <para> - The main reason for turning dynamic loading off is - security. With dynamic loading, it's possible to ignore all - the safe_mode and open_basedir restrictions. - </para> - <para> - The default is to allow dynamic loading, except when using - safe-mode. In safe-mode, it's always imposible to use - <function>dl</function>. - </para> + <para> + This directive is really only useful in the Apache module + version of PHP. You can turn dynamic loading of PHP + extensions with <function>dl</function> on and off per + virtual server or per directory. + </para> + <para> + The main reason for turning dynamic loading off is + security. With dynamic loading, it's possible to ignore all + the safe_mode and open_basedir restrictions. + </para> + <para> + The default is to allow dynamic loading, except when using + safe-mode. In safe-mode, it's always imposible to use + <function>dl</function>. + </para> </listitem> </varlistentry> @@ -805,8 +819,8 @@ </term> <listitem> <para> - In what directory PHP should look for dynamically loadable - extensions.</para> + In what directory PHP should look for dynamically loadable + extensions.</para> </listitem> </varlistentry> @@ -817,8 +831,8 @@ </term> <listitem> <para> - Which dynamically loadable extensions to load when PHP starts - up.</para> + Which dynamically loadable extensions to load when PHP starts + up.</para> </listitem> </varlistentry> @@ -836,7 +850,7 @@ </term> <listitem> <para> - Whether to allow persistent MySQL connections. + Whether to allow persistent MySQL connections. </para> </listitem> </varlistentry> @@ -848,8 +862,8 @@ </term> <listitem> <para> - The default server host to use when connecting to the database - server if no other host is specified. + The default server host to use when connecting to the database + server if no other host is specified. </para> </listitem> </varlistentry> @@ -861,8 +875,8 @@ </term> <listitem> <para> - The default user name to use when connecting to the database - server if no other name is specified. + The default user name to use when connecting to the database + server if no other name is specified. </para> </listitem> </varlistentry> @@ -874,8 +888,8 @@ </term> <listitem> <para> - The default password to use when connecting to the database - server if no other password is specified. + The default password to use when connecting to the database + server if no other password is specified. </para> </listitem> </varlistentry> @@ -887,8 +901,8 @@ </term> <listitem> <para> - The maximum number of persistent MySQL connections per - process. + The maximum number of persistent MySQL connections per + process. </para> </listitem> </varlistentry> @@ -900,8 +914,8 @@ </term> <listitem> <para> - The maximum number of MySQL connections per process, including - persistent connections. + The maximum number of MySQL connections per process, including + persistent connections. </para> </listitem> </varlistentry> @@ -920,7 +934,7 @@ </term> <listitem> <para> - Whether to allow persistent mSQL connections. + Whether to allow persistent mSQL connections. </para> </listitem> </varlistentry> @@ -932,7 +946,7 @@ </term> <listitem> <para> - The maximum number of persistent mSQL connections per process. + The maximum number of persistent mSQL connections per process. </para> </listitem> </varlistentry> @@ -944,8 +958,8 @@ </term> <listitem> <para> - The maximum number of mSQL connections per process, including - persistent connections. + The maximum number of mSQL connections per process, including + persistent connections. </para> </listitem> </varlistentry> @@ -964,7 +978,7 @@ </term> <listitem> <para> - Whether to allow persistent Postgres connections. + Whether to allow persistent Postgres connections. </para> </listitem> </varlistentry> @@ -976,8 +990,8 @@ </term> <listitem> <para> - The maximum number of persistent Postgres connections per - process. + The maximum number of persistent Postgres connections per + process. </para> </listitem> </varlistentry> @@ -989,8 +1003,8 @@ </term> <listitem> <para> - The maximum number of Postgres connections per process, - including persistent connections. + The maximum number of Postgres connections per process, + including persistent connections. </para> </listitem> </varlistentry> @@ -1010,10 +1024,10 @@ </term> <listitem> <para> - Name of BS2000 PLAM library containing the loadable SESAM - driver modules. Required for using SESAM functions. The - BS2000 PLAM library must be set ACCESS=READ,SHARE=YES - because it must be readable by the apache server's user id. + Name of BS2000 PLAM library containing the loadable SESAM + driver modules. Required for using SESAM functions. The + BS2000 PLAM library must be set ACCESS=READ,SHARE=YES + because it must be readable by the apache server's user id. </para> </listitem> </varlistentry> @@ -1026,13 +1040,13 @@ <listitem> <para> Name of SESAM application configuration file. Required for - using SESAM functions. The BS2000 file must be readable by - the apache server's user id. + using SESAM functions. The BS2000 file must be readable by + the apache server's user id. </para> <para> The application configuration file will usually contain a - configuration like (see SESAM - reference manual): + configuration like (see SESAM + reference manual): <informalexample> <programlisting role="bs2000"> CNF=B @@ -1050,14 +1064,14 @@ </term> <listitem> <para> - Name of SESAM message catalog file. In most cases, this - directive is not neccessary. Only if the SESAM message file - is not installed in the system's BS2000 message file table, - it can be set with this directive. + Name of SESAM message catalog file. In most cases, this + directive is not neccessary. Only if the SESAM message file + is not installed in the system's BS2000 message file table, + it can be set with this directive. </para> <para> - The message catalog must be set ACCESS=READ,SHARE=YES because - it must be readable by the apache server's user id. + The message catalog must be set ACCESS=READ,SHARE=YES because + it must be readable by the apache server's user id. </para> </listitem> </varlistentry> @@ -1077,7 +1091,7 @@ </term> <listitem> <para> - Whether to allow persistent Sybase connections. + Whether to allow persistent Sybase connections. </para> </listitem> </varlistentry> @@ -1089,8 +1103,8 @@ </term> <listitem> <para> - The maximum number of persistent Sybase connections per - process. + The maximum number of persistent Sybase connections per + process. </para> </listitem> </varlistentry> @@ -1102,8 +1116,8 @@ </term> <listitem> <para> - The maximum number of Sybase connections per process, - including persistent connections. + The maximum number of Sybase connections per process, + including persistent connections. </para> </listitem> </varlistentry> @@ -1122,8 +1136,8 @@ </term> <listitem> <para> - Whether to allow persistent Sybase-CT connections. - The default is on. + Whether to allow persistent Sybase-CT connections. + The default is on. </para> </listitem> </varlistentry> @@ -1135,8 +1149,8 @@ </term> <listitem> <para> - The maximum number of persistent Sybase-CT connections per - process. The default is -1 meaning unlimited. + The maximum number of persistent Sybase-CT connections per + process. The default is -1 meaning unlimited. </para> </listitem> </varlistentry> @@ -1148,9 +1162,9 @@ </term> <listitem> <para> - The maximum number of Sybase-CT connections per process, - including persistent connections. The default is -1 meaning - unlimited. + The maximum number of Sybase-CT connections per process, + including persistent connections. The default is -1 meaning + unlimited. </para> </listitem> </varlistentry> @@ -1410,7 +1424,7 @@ </term> <listitem> <para> - Number of decimal digits for all bcmath functions. + Number of decimal digits for all bcmath functions. </para> </listitem> </varlistentry> @@ -1429,8 +1443,8 @@ </term> <listitem> <para> - Name of browser capabilities file. See also - <function>get_browser</function>. + Name of browser capabilities file. See also + <function>get_browser</function>. </para> </listitem> </varlistentry> @@ -1449,9 +1463,9 @@ </term> <listitem> <para> - ODBC data source to use if none is specified in - <function>odbc_connect</function> or - <function>odbc_pconnect</function>. + ODBC data source to use if none is specified in + <function>odbc_connect</function> or + <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> @@ -1463,9 +1477,9 @@ </term> <listitem> <para> - User name to use if none is specified in - <function>odbc_connect</function> or - <function>odbc_pconnect</function>. + User name to use if none is specified in + <function>odbc_connect</function> or + <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> @@ -1477,9 +1491,9 @@ </term> <listitem> <para> - Password to use if none is specified in - <function>odbc_connect</function> or - <function>odbc_pconnect</function>. + Password to use if none is specified in + <function>odbc_connect</function> or + <function>odbc_pconnect</function>. </para> </listitem> </varlistentry> @@ -1491,7 +1505,7 @@ </term> <listitem> <para> - Whether to allow persistent ODBC connections. + Whether to allow persistent ODBC connections. </para> </listitem> </varlistentry> @@ -1503,7 +1517,7 @@ </term> <listitem> <para> - The maximum number of persistent ODBC connections per process. + The maximum number of persistent ODBC connections per process. </para> </listitem> </varlistentry> @@ -1515,8 +1529,8 @@ </term> <listitem> <para> - The maximum number of ODBC connections per process, including - persistent connections. + The maximum number of ODBC connections per process, including + persistent connections. </para> </listitem> </varlistentry> @@ -1536,7 +1550,7 @@ <listitem> <para> <literal>mbstring.internal_encoding</literal> defines default - internal character encoding. + internal character encoding. </para> </listitem> </varlistentry> @@ -1549,7 +1563,7 @@ <listitem> <para> <literal>mbstring.http_input</literal> defines default - HTTP input character encoding. + HTTP input character encoding. </para> </listitem> </varlistentry> @@ -1562,7 +1576,7 @@ <listitem> <para> <literal>mbstring.http_output</literal> defines default - HTTP output character encoding. + HTTP output character encoding. </para> </listitem> </varlistentry> @@ -1575,7 +1589,7 @@ <listitem> <para> <literal>mbstring.detect_order</literal> defines default - character encoding detection order. + character encoding detection order. </para> </listitem> </varlistentry> Index: phpdoc/en/features/file-upload.xml diff -u phpdoc/en/features/file-upload.xml:1.18 phpdoc/en/features/file-upload.xml:1.19 --- phpdoc/en/features/file-upload.xml:1.18 Sat Jan 20 16:08:27 2001 +++ phpdoc/en/features/file-upload.xml Tue Jul 10 17:12:59 2001 @@ -35,15 +35,23 @@ The _URL_ should point to a PHP file. The MAX_FILE_SIZE hidden field must precede the file input field and its value is the maximum filesize accepted. The value is in bytes. + <warning> + <para> + The MAX_FILE_SIZE is advisory to the browser. It is easy to + circumvent this maximum. So don't count on it that the browser + obeys you wish! The PHP-settings for maximum-size, however, + cannot be fooled. + </para> + </warning> </para> <para> - In PHP 3, the following variables will be defined within the + In PHP, the following variables will be defined within the destination script upon a successful upload, assuming that <link linkend="ini.register-globals">register_globals</link> is turned - on in <filename>php3.ini</filename>. If <link + on in <filename>php.ini</filename>. If <link linkend="ini.track-vars">track_vars</link> is turned on, they will - also be available in PHP 3 within the global array + also be available in PHP within the global array <varname>$HTTP_POST_VARS</varname>. Note that the following variable names assume the use of the file upload name 'userfile', as used in the example above: @@ -215,9 +223,10 @@ <sect1 id="features.file-upload.common-pitfalls"> <title>Common Pitfalls</title> <simpara> - The MAX_FILE_SIZE item cannot specify a file size greater than the file - size that has been set in the upload_max_filesize in the PHP 3.ini file - or the corresponding php3_upload_max_filesize Apache .conf directive. + The <literal>MAX_FILE_SIZE</literal> item cannot specify a file size + greater than the file + size that has been set in the <link + linkend="ini.upload-max-filesize">upload_max_filesize</link> ini-setting. The default is 2 Megabytes. </simpara> <simpara> @@ -232,7 +241,7 @@ </simpara> </sect1> - <sect1 id="feature-fileupload.multiple"> + <sect1 id="features.file-upload.multiple"> <title>Uploading multiple files</title> <simpara> It is possible to upload multiple files simultaneously and have @@ -248,7 +257,7 @@ <para> <example> <title>Uploading multiple files</title> - <programlisting> + <programlisting role="html"> <form action="file-upload.php" method="post" enctype="multipart/form-data"> Send these files:<br> <input name="userfile[]" type="file"><br> @@ -260,9 +269,9 @@ </para> <simpara> When the above form is submitted, the arrays - <computeroutput>$userfile</computeroutput>, - <computeroutput>$userfile_name</computeroutput>, and - <computeroutput>$userfile_size</computeroutput> will be formed in + <varname>$userfile</varname>, + <varname>$userfile_name</varname>, and + <varname>$userfile_size</varname> will be formed in the global scope (as well as in $HTTP_POST_FILES ($HTTP_POST_VARS in PHP 3)). Each of these will be a numerically indexed array of the appropriate values for the submitted files. @@ -271,19 +280,19 @@ For instance, assume that the filenames <filename>/home/test/review.html</filename> and <filename>/home/test/xwp.out</filename> are submitted. In this - case, <computeroutput>$userfile_name[0]</computeroutput> would - contain the value <computeroutput>review.html</computeroutput>, - and <computeroutput>$userfile_name[1]</computeroutput> would + case, <varname>$userfile_name[0]</varname> would + contain the value <literal>review.html</literal>, + and <varname>$userfile_name[1]</varname> would contain the value - <computeroutput>xwp.out</computeroutput>. Similarly, - <computeroutput>$userfile_size[0]</computeroutput> would contain + <varname>xwp.out</varname>. Similarly, + <varname>$userfile_size[0]</varname> would contain <filename>review.html</filename>'s filesize, and so forth. </simpara> <simpara> - <computeroutput>$userfile['name'][0]</computeroutput>, - <computeroutput>$userfile['tmp_name'][0]</computeroutput>, - <computeroutput>$userfile['size'][0]</computeroutput>, and - <computeroutput>$userfile['type'][0]</computeroutput> are also set. + <varname>$userfile['name'][0]</varname>, + <varname>$userfile['tmp_name'][0]</varname>, + <varname>$userfile['size'][0]</varname>, and + <varname>$userfile['type'][0]</varname> are also set. </simpara> </sect1> @@ -313,18 +322,18 @@ a <Virtualhost> block. A line like this would do the trick: <informalexample> <programlisting> -Script PUT /put.php3 +Script PUT /put.php </programlisting> </informalexample> </para> <simpara> This tells Apache to send all PUT requests for URIs that match the - context in which you put this line to the put.php3 script. This - assumes, of course, that you have PHP enabled for the .php3 + context in which you put this line to the put.php script. This + assumes, of course, that you have PHP enabled for the .php extension and PHP is active. </simpara> <simpara> - Inside your put.php3 file you would then do something like this: + Inside your put.php file you would then do something like this: </simpara> <para> <informalexample><programlisting> Index: phpdoc/en/features/safe-mode.xml diff -u phpdoc/en/features/safe-mode.xml:1.2 phpdoc/en/features/safe-mode.xml:1.3 --- phpdoc/en/features/safe-mode.xml:1.2 Tue Jul 10 16:36:22 2001 +++ phpdoc/en/features/safe-mode.xml Tue Jul 10 17:12:59 2001 @@ -22,10 +22,10 @@ When safe_mode is on, PHP checks to see if the owner of the current script matches the owner of the file to be operated on by a file function. For example: - <computeroutput> + <programlisting role="ls"> -rw-rw-r-- 1 rasmus rasmus 33 Jul 1 19:20 script.php -rw-r--r-- 1 root root 1116 May 26 18:01 /etc/passwd - </computeroutput> + </programlisting> Running this script.php <programlisting role="php"> <?php @@ -33,10 +33,10 @@ ?> </programlisting> results in this error when safe mode is enabled: - <computeroutput> + <programlisting role="php"> Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 - </computeroutput> + </programlisting> </para> <para> If instead of safe_mode, you set an open_basedir directory then all file @@ -49,10 +49,10 @@ </programlisting> If you run the same script.php with this open_basedir setting then this is the result: - <computeroutput> + <programlisting role="php"> Warning: open_basedir restriction in effect. File is in wrong directory in /docroot/script.php on line 2 - </computeroutput> + </programlisting> </para> <para> You can also disable individual functions. If we add this to our php.ini @@ -61,9 +61,10 @@ disable_functions readfile,system </programlisting> Then we get this output: - <computeroutput> -Warning: readfile() has been disabled for security reasons in /docroot/script.php on line 2 - </computeroutput> + <programlisting role="php"> +Warning: readfile() has been disabled for security reasons in +/docroot/script.php on line 2 + </programlisting> </para> </chapter>