philip Sun Jun 1 16:19:24 2003 EDT
Modified files:
/phpdoc/en/reference/funchand/functions
register-shutdown-function.xml
Log:
Clarify the generated E_WARNING for undefined functions. And, see also
exit, auto_append_file, and connection handling. Closes bug #23929
Index: phpdoc/en/reference/funchand/functions/register-shutdown-function.xml
diff -u phpdoc/en/reference/funchand/functions/register-shutdown-function.xml:1.4
phpdoc/en/reference/funchand/functions/register-shutdown-function.xml:1.5
--- phpdoc/en/reference/funchand/functions/register-shutdown-function.xml:1.4 Sat
May 31 10:48:44 2003
+++ phpdoc/en/reference/funchand/functions/register-shutdown-function.xml Sun
Jun 1 16:19:24 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/funchand.xml, last change in rev 1.1 -->
<refentry id="function.register-shutdown-function">
<refnamediv>
@@ -16,9 +16,7 @@
</methodsynopsis>
<simpara>
Registers the function named by <parameter>function</parameter> to be
- executed when script processing is complete. If the function
- <parameter>function</parameter> does not exist (undefined), an error of
- level <constant>E_WARNING</constant> is generated.
+ executed when script processing is complete.
</simpara>
<para>
Multiple calls to <function>register_shutdown_function</function> can be
@@ -33,6 +31,21 @@
to send output to the browser using <function>echo</function> or
<function>print</function>, or retrieve the contents of any output
buffers using <function>ob_get_contents</function>.
+ </para>
+ <note>
+ <para>
+ Typically undefined functions cause fatal errors in PHP, but when the
+ <parameter>function</parameter> called with
+ <function>register_shutdown_function</function> is undefined, an error
+ of level <constant>E_WARNING</constant> is generated instead. Also,
+ for reasons internal to PHP, this error will refer to
+ <function>Unknown</function> at line #0.
+ </para>
+ </note>
+ <para>
+ See also <link linkend="ini.auto-append-file">auto_append_file</link>,
+ <function>exit</function>, and the section on
+ <link linkend="features.connection-handling">connection handling</link>.
</para>
</refsect1>
</refentry>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
