CVS update: php3/doc/chapters

Date: Saturday December 26, 1998 @ 6:13 Author: eschmid Update of /repository/php3/doc/chapters In directory asf:/u/temp/cvs-serv27723 Modified Files: config.sgml Log Message: Some line breakings. Index: php3/doc/chapters/config.sgml diff -c php3/doc/chapters/config.sgml:1.43 php3/doc/chapters/config.sgml:1.44 *** php3/doc/chapters/config.sgml:1.43 Wed Dec 9 21:07:25 1998 --- php3/doc/chapters/config.sgml Sat Dec 26 06:13:48 1998 *************** *** 1,25 **** <chapter id="configuration"> <title>Configuration</title> - <simpara> <sect1 id="php3.ini"> <title>The php3.ini file</title> <simpara> The <filename>php3.ini</filename> file is read when PHP's parser starts up. For the server module versions of PHP, this happens only once when the web server is started. For the <acronym>CGI</acronym> version, it happens on every invocation. ! </simpara> <simpara> Just about every directive listed here has a corresponding Apache <filename>httpd.conf</filename> directive. Simply prepend <emphasis>php3_</emphasis> to the start of the directive names listed here. ! </simpara> <simpara> ! You can view the settings of most of the configuration values ! in the output of <function>phpinfo</function>. ! </simpara> <sect2 id="ini.sect.general"> <title>General Configuration Directives</title> --- 1,25 ---- <chapter id="configuration"> <title>Configuration</title> <sect1 id="php3.ini"> <title>The php3.ini file</title> + <simpara> The <filename>php3.ini</filename> file is read when PHP's parser starts up. For the server module versions of PHP, this happens only once when the web server is started. For the <acronym>CGI</acronym> version, it happens on every invocation. ! <simpara> Just about every directive listed here has a corresponding Apache <filename>httpd.conf</filename> directive. Simply prepend <emphasis>php3_</emphasis> to the start of the directive names listed here. ! <simpara> ! You can view the settings of most of the configuration values in ! the output of <function>phpinfo</function>. ! <sect2 id="ini.sect.general"> <title>General Configuration Directives</title> *************** *** 251,258 **** include_path=".;c:\www\phplib" </programlisting> </example> ! The default value for this directive is <literal>.</literal> (only ! the current directory). </listitem> </varlistentry> --- 251,258 ---- include_path=".;c:\www\phplib" </programlisting> </example> ! The default value for this directive is <literal>.</literal> ! (only the current directory). </listitem> </varlistentry> *************** *** 413,420 **** </term> <listitem> <para> ! If enabled, GET, POST and cookie input can be found in the global ! associative arrays <symbol>$HTTP_GET_VARS</symbol>, <symbol>$HTTP_POST_VARS</symbol> and <symbol>$HTTP_COOKIE_VARS</symbol>, respectively. </listitem> --- 413,420 ---- </term> <listitem> <para> ! If enabled, GET, POST and cookie input can be found in the ! global associative arrays <symbol>$HTTP_GET_VARS</symbol>, <symbol>$HTTP_POST_VARS</symbol> and <symbol>$HTTP_COOKIE_VARS</symbol>, respectively. </listitem> *************** *** 427,434 **** </term> <listitem> <para> ! The temporary directory used for storing files when doing file ! upload. Must be writable by whatever user PHP is running as. </listitem> </varlistentry> --- 427,435 ---- </term> <listitem> <para> ! The temporary directory used for storing files when doing ! file upload. Must be writable by whatever user PHP is ! running as. </listitem> </varlistentry> *************** *** 530,537 **** <listitem> <para> Whether to enable PHP's safe mode. Read the <link ! linkend="config-security">Security chapter</link> for more more ! information. </listitem> </varlistentry> --- 531,538 ---- <listitem> <para> Whether to enable PHP's safe mode. Read the <link ! linkend="config-security">Security chapter</link> for more ! more information. </listitem> </varlistentry> *************** *** 758,764 **** </term> <listitem> <para> ! The maximum number of persistent Postgres connections per process. </para> </listitem> </varlistentry> --- 759,766 ---- </term> <listitem> <para> ! The maximum number of persistent Postgres connections per ! process. </para> </listitem> </varlistentry> *************** *** 770,777 **** </term> <listitem> <para> ! The maximum number of Postgres connections per process, including ! persistent connections. </para> </listitem> </varlistentry> --- 772,779 ---- </term> <listitem> <para> ! The maximum number of Postgres connections per process, ! including persistent connections. </para> </listitem> </varlistentry> *************** *** 802,808 **** </term> <listitem> <para> ! The maximum number of persistent Sybase connections per process. </para> </listitem> </varlistentry> --- 804,811 ---- </term> <listitem> <para> ! The maximum number of persistent Sybase connections per ! process. </para> </listitem> </varlistentry> *************** *** 814,821 **** </term> <listitem> <para> ! The maximum number of Sybase connections per process, including ! persistent connections. </para> </listitem> </varlistentry> --- 817,824 ---- </term> <listitem> <para> ! The maximum number of Sybase connections per process, ! including persistent connections. </para> </listitem> </varlistentry> *************** *** 923,932 **** <listitem> <para> The maximum time in seconds to wait for a select_db or query ! operation to succeed before returning failure. Note that if ! max_execution_time has been exceeded when am operation times out, ! your script will be terminated before it can take action on failure. ! The default is no limit. </para> </listitem> </varlistentry> --- 926,935 ---- <listitem> <para> The maximum time in seconds to wait for a select_db or query ! operation to succeed before returning failure. Note that if ! max_execution_time has been exceeded when am operation times ! out, your script will be terminated before it can take action ! on failure. The default is no limit. </para> </listitem> </varlistentry> *************** *** 938,945 **** </term> <listitem> <para> ! The name of the host you claim to be connecting from, ! for display by sp_who. The default is none. </para> </listitem> </varlistentry> --- 941,948 ---- </term> <listitem> <para> ! The name of the host you claim to be connecting from, for ! display by sp_who. The default is none. </para> </listitem> </varlistentry> *************** *** 1175,1184 **** <simpara> In PHP, compile-time configuration option <link ! linkend="enable-force-cgi-redirect">--enable-force-cgi-redirect</link> and runtime configuration directives <link ! linkend="ini.doc-root">doc_root</link> and <link ! linkend="ini.user-dir">user_dir</link> can be used to prevent this attack, if the server document tree has any directories with access restrictions. See below for full explanation of different combinations. --- 1178,1187 ---- <simpara> In PHP, compile-time configuration option <link ! linkend="enable-force-cgi-redirect">--enable-force-cgi-redirect</link> and runtime configuration directives <link ! linkend="ini.doc-root">doc_root</link> and <link ! linkend="ini.user-dir">user_dir</link> can be used to prevent this attack, if the server document tree has any directories with access restrictions. See below for full explanation of different combinations. *************** *** 1214,1226 **** <sect3 id="config-security-cgi-force"> <title>Case 2: using --enable-force-cgi-redirect</title> <simpara> ! This compile-time option prevents anyone from calling PHP directly ! with a url like <filename role=php>http://my.host/cgi-bin/php/secretdir/script.php3</filename>. ! Instead, PHP will only parse in this mode if it has gone through ! a web server redirect rule. <simpara> Usually the redirection in the Apache configuration is done with ! the following directives: <programlisting role="apache-conf"> Action php3-script /cgi-bin/php AddHandler php3-script .php3 --- 1217,1230 ---- <sect3 id="config-security-cgi-force"> <title>Case 2: using --enable-force-cgi-redirect</title> <simpara> ! This compile-time option prevents anyone from calling PHP ! directly with a url like <filename ! role=php>http://my.host/cgi-bin/php/secretdir/script.php3</filename>. ! Instead, PHP will only parse in this mode if it has gone through ! a web server redirect rule. <simpara> Usually the redirection in the Apache configuration is done with ! the following directives: <programlisting role="apache-conf"> Action php3-script /cgi-bin/php AddHandler php3-script .php3 *************** *** 1303,1309 **** similar to: <informalexample> ! <programlisting>#!/usr/local/bin/php</programlisting> </informalexample> as the first line of any file containing PHP tags. You will --- 1307,1315 ---- similar to: <informalexample> ! <programlisting> ! #!/usr/local/bin/php ! </programlisting> </informalexample> as the first line of any file containing PHP tags. You will -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net