mfischer Mon Jun 10 17:41:16 2002 EDT
Modified files:
/phpdoc/en/language control-structures.xml
/phpdoc/en/features remote-files.xml
/phpdoc/en/chapters config.xml
/phpdoc/en language-snippets.ent
Log:
- Add appropriate warnings that Windows does not support remote file access
for the include/require friends.
Index: phpdoc/en/language/control-structures.xml
diff -u phpdoc/en/language/control-structures.xml:1.58
phpdoc/en/language/control-structures.xml:1.59
--- phpdoc/en/language/control-structures.xml:1.58 Fri May 24 09:23:17 2002
+++ phpdoc/en/language/control-structures.xml Mon Jun 10 17:41:15 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
<chapter id="control-structures">
<title>Control Structures</title>
@@ -1077,6 +1077,7 @@
<function>require</function> itself happens only once.
</simpara>
</note>
+ &warn.no-win32-fopen-wrapper;
<simpara>
See also <function>include</function>, <function>require_once</function>,
<function>include_once</function>, <function>eval</function>,
@@ -1191,6 +1192,7 @@
being run on the remote server and the result is then being
included into the local script.
</simpara>
+ &warn.no-win32-fopen-wrapper;
<para>
<example>
<title><function>include</function> through HTTP</title>
@@ -1355,6 +1357,7 @@
<function>require_once</function> was added in PHP 4.0.1pl2
</para>
</note>
+ &warn.no-win32-fopen-wrapper;
<para>
See also: <function>require</function>,
<function>include</function>, <function>include_once</function>,
@@ -1392,6 +1395,7 @@
<function>include_once</function> was added in PHP 4.0.1pl2
</para>
</note>
+ &warn.no-win32-fopen-wrapper;
<para>
See also <function>include</function>,
<function>require</function>, <function>require_once</function>,
Index: phpdoc/en/features/remote-files.xml
diff -u phpdoc/en/features/remote-files.xml:1.16
phpdoc/en/features/remote-files.xml:1.17
--- phpdoc/en/features/remote-files.xml:1.16 Thu Apr 18 19:07:18 2002
+++ phpdoc/en/features/remote-files.xml Mon Jun 10 17:41:15 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.16 $ -->
+<!-- $Revision: 1.17 $ -->
<chapter id="features.remote-files">
<title>Using remote files</title>
@@ -16,8 +16,10 @@
<para>
<note>
<para>
- You can't use remote files in <function>include</function> and
- <function>require</function> statements on Windows.
+ The Windows version of <literal>PHP</literal> currently does not support
+ remote file accessing for the following functions:
+ <function>include</function>, <function>include_once</function>,
+ <function>require</function> and <function>require_once</function>.
</para>
</note>
</para>
Index: phpdoc/en/chapters/config.xml
diff -u phpdoc/en/chapters/config.xml:1.56 phpdoc/en/chapters/config.xml:1.57
--- phpdoc/en/chapters/config.xml:1.56 Mon Jun 10 06:22:39 2002
+++ phpdoc/en/chapters/config.xml Mon Jun 10 17:41:15 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.56 $ -->
+<!-- $Revision: 1.57 $ -->
<chapter id="configuration">
<title>Configuration</title>
@@ -169,6 +169,14 @@
isable-url-fopen-wrapper</parameter></link>.
</para>
</note>
+ <warning>
+ <para>
+ On Windows, the following functions do not support remote file
+ accesing: <function>include</function>,
+ <function>include_once</function>, <function>require</function> and
+ <function>require_once</function>.
+ </para>
+ </warning>
</listitem>
</varlistentry>
Index: phpdoc/en/language-snippets.ent
diff -u phpdoc/en/language-snippets.ent:1.25 phpdoc/en/language-snippets.ent:1.26
--- phpdoc/en/language-snippets.ent:1.25 Mon Apr 22 07:41:06 2002
+++ phpdoc/en/language-snippets.ent Mon Jun 10 17:41:16 2002
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.25 $ -->
+<!-- $Revision: 1.26 $ -->
<!ENTITY warn.experimental '<warning><simpara>This extension is
<emphasis>EXPERIMENTAL</emphasis>. The behaviour of this extension,
@@ -16,6 +16,12 @@
<!ENTITY warn.undocumented.func '<warning><simpara>This function is
currently not documented; only the argument list is
available.</simpara></warning>'>
+
+<!ENTITY warn.no-win32-fopen-wrapper '<warning><para>The Windows
+version of <literal>PHP</literal> currently does not support remote
+file accessing for this function, even if
+<link linkend="ini.allow-url-fopen">allow_url_fopen</link> is enabled.
+</para></warning>'>
<!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs
its result directly to the browser, you can use the <link
