[PHP-DOC] cvs: phpdoc /en/language control-structures.xml From: Gabor Hojtsy (gabor <email protected>)
Date: 07/29/02

goba Mon Jul 29 16:57:18 2002 EDT

  Modified files:
    /phpdoc/en/language control-structures.xml
  Log:
  Adding case sensitivity note to include_once and require_once
  
  
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.59 phpdoc/en/language/control-structures.xml:1.60
--- phpdoc/en/language/control-structures.xml:1.59 Mon Jun 10 17:41:15 2002
+++ phpdoc/en/language/control-structures.xml Mon Jul 29 16:57:18 2002
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.59 $ -->
+<!-- $Revision: 1.60 $ -->
  <chapter id="control-structures">
   <title>Control Structures</title>
 
@@ -1357,6 +1357,22 @@
      <function>require_once</function> was added in PHP 4.0.1pl2
     </para>
    </note>
+ <note>
+ <para>
+ Be aware, that the behaviour of <function>require_once</function>
+ amd <function>include_once</function> may not be what you expect
+ on a non case sensitive operating system (such as Windows).
+ <example>
+ <title><function>require_once</function> is case sensitive</title>
+ <programlisting role="php">
+<![CDATA[
+require_once("a.php"); // this will include a.php
+require_once("A.php"); // this will include a.php again on Windows!
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </note>
    &warn.no-win32-fopen-wrapper;
    <para>
     See also: <function>require</function>,
@@ -1393,6 +1409,22 @@
    <note>
     <para>
      <function>include_once</function> was added in PHP 4.0.1pl2
+ </para>
+ </note>
+ <note>
+ <para>
+ Be aware, that the behaviour of <function>include_once</function>
+ amd <function>require_once</function> may not be what you expect
+ on a non case sensitive operating system (such as Windows).
+ <example>
+ <title><function>include_once</function> is case sensitive</title>
+ <programlisting role="php">
+<![CDATA[
+include_once("a.php"); // this will include a.php
+include_once("A.php"); // this will include a.php again on Windows!
+]]>
+ </programlisting>
+ </example>
     </para>
    </note>
    &warn.no-win32-fopen-wrapper;

-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php