[PHP-DOC] cvs: phpdoc /en/chapters config.xml /en/functions info.xml From: Daniel Beckham (danbeck <email protected>)
Date: 06/26/01

danbeck Wed Jun 27 05:52:38 2001 EDT

  Modified files:
    /phpdoc/en/chapters config.xml
    /phpdoc/en/functions info.xml
  Log:
  documented issue in bug #5827
  
Index: phpdoc/en/chapters/config.xml
diff -u phpdoc/en/chapters/config.xml:1.14 phpdoc/en/chapters/config.xml:1.15
--- phpdoc/en/chapters/config.xml:1.14 Tue Jun 19 22:08:13 2001
+++ phpdoc/en/chapters/config.xml Wed Jun 27 05:52:38 2001
@@ -476,9 +476,15 @@
        <listitem>
         <para>
          This sets the maximum time in seconds a script is allowed to
- take before it is terminated by the parser. This helps
+ 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>.
+ 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>
        </listitem>
       </varlistentry>
Index: phpdoc/en/functions/info.xml
diff -u phpdoc/en/functions/info.xml:1.51 phpdoc/en/functions/info.xml:1.52
--- phpdoc/en/functions/info.xml:1.51 Tue Jun 26 13:24:50 2001
+++ phpdoc/en/functions/info.xml Wed Jun 27 05:52:38 2001
@@ -1390,10 +1390,10 @@
     <simpara>
      Set the number of seconds a script is allowed to run. If this is
      reached, the script returns a fatal error. The default limit is
- 30 seconds or, if it exists, the max_execution_time value defined
- in the <link linkend="configuration.file">configuration
- file</link>. If seconds is set to zero, no time limit is
- imposed.
+ 30 seconds or, if it exists, the
+ <literal>max_execution_time</literal> value defined in the <link
+ linkend="ini.max-execution-time">configuration file</link>. If
+ seconds is set to zero, no time limit is imposed.
     </simpara>
     <simpara>
      When called, <function>set_time_limit</function> restarts the
@@ -1403,11 +1403,24 @@
      total of 45 seconds before timing out.
     </simpara>
     <simpara>
- Note that <function>set_time_limit</function> has no effect when
+ <function>set_time_limit</function> has no effect when
      PHP is running in safe mode. There is no workaround other than
      turning off safe mode or changing the time limit in the <link
- linkend="configuration.file">configuration file</link>.
+ linkend="ini.max-execution-time">configuration file</link>.
     </simpara>
+ <note>
+ <para>
+ The <function>set_time_limit</function> function and the
+ configuration directive <link
+ linkend="ini.max-execution-time">max_execution_time</link> only
+ affect the execution time of the script itself. Any time spent
+ on activity that happens outside the execution of the script
+ such as system calls using <function>system</function>, the
+ <function>sleep</function> function, database queries, etc. is
+ not included when determining the maximum time that the script
+ has been running.
+ </para>
+ </note>
    </refsect1>
   </refentry>