From 6441e07fbec599e76d2514b806a6f1dff4961bbd Mon Sep 17 00:00:00 2001
From: Jakub Vrana <vrana@php.net>
Date: Tue, 27 Jul 2004 21:17:22 +0000
Subject: [PATCH] Functions are defined even if they are after return statement
 in included file (bug #26032)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@164493 c90b9560-bf6c-de11-be94-00142212c4b1
---
 appendices/migration5.xml       | 13 ++++++++++++-
 language/control-structures.xml | 11 ++++++++++-
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/appendices/migration5.xml b/appendices/migration5.xml
index 01b4640966..a9d80a0dd2 100755
--- a/appendices/migration5.xml
+++ b/appendices/migration5.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.27 $ -->
+<!-- $Revision: 1.28 $ -->
  <appendix id="migration5">
   <title>Migrating from PHP 4 to PHP 5</title>
 
@@ -107,6 +107,17 @@
       <literal>-1</literal>.
      </simpara>
     </listitem>
+    <listitem>
+     <simpara>
+      If there are functions defined in the included file, they can be used in the
+      main file independent if they are before <function>return</function> or after.
+      If the file is included twice, PHP 5 issues fatal error because functions
+      were already declared, while PHP 4 doesn't complain about it.
+      It is recommended to use <function>include_once</function> instead of
+      checking if the file was already included and conditionally return inside
+      the included file.
+     </simpara>
+    </listitem>
     <listitem>
      <simpara>
       <function>include_once</function> and <function>require_once</function>
diff --git a/language/control-structures.xml b/language/control-structures.xml
index f2aaf47aed..2de073da1f 100644
--- a/language/control-structures.xml
+++ b/language/control-structures.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.100 $ -->
+<!-- $Revision: 1.101 $ -->
  <chapter id="language.control-structures">
   <title>Control Structures</title>
 
@@ -1500,6 +1500,15 @@ echo $bar; // prints 1
     If the file can't be included, &false; is returned and
     <literal>E_WARNING</literal> is issued.
    </simpara>
+   <para>
+    If there are functions defined in the included file, they can be used in the
+    main file independent if they are before <function>return</function> or after.
+    If the file is included twice, PHP 5 issues fatal error because functions
+    were already declared, while PHP 4 doesn't complain about it.
+    It is recommended to use <function>include_once</function> instead of
+    checking if the file was already included and conditionally return inside
+    the included file.
+   </para>
    <simpara>
     A few other ways to "include" files into variables are with 
     <function>fopen</function>, <function>file</function> or by using