From e789fee4bb39083a83ab3dd8f9d52f1546ad26b3 Mon Sep 17 00:00:00 2001
From: Hartmut Holzgraefe <hholzgra@php.net>
Date: Fri, 13 Oct 2000 00:05:57 +0000
Subject: [PATCH] fopen wrappers configuration has changed

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@33784 c90b9560-bf6c-de11-be94-00142212c4b1
---
 chapters/config.xml       | 24 ++++++++++++++++++++++++
 chapters/install.xml      |  8 ++++++++
 features/remote-files.xml |  4 +++-
 3 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/chapters/config.xml b/chapters/config.xml
index 7d0d0488c7..3b8cbf080f 100644
--- a/chapters/config.xml
+++ b/chapters/config.xml
@@ -85,6 +85,30 @@
     <para>
      <variablelist>
 	  
+	  <varlistentry id="ini.allow-url-fopen">
+	   <term>
+		<parameter>allow_url_fopen</parameter>
+		<type>boolean</type>
+	   </term>
+	   <listitem>
+		<para>
+     This option enables the URL-aware fopen wrappers that enable accessing URL object
+     like files. Default wrappers are provided for the access of 
+     <link linkend="features.remote-files">remote files</link>
+     using the ftp or http protocol, some extensions like zlib may register additional wrappers. 
+		</para>
+
+		<note>
+		 <para>
+      This option was introduced immediately after the release of version 4.0.3. For versions up to 
+      and including 4.0.3 you can only disable this feature at compile time by using the configuration switch 
+      <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>.
+     </para>
+		</note>
+
+	   </listitem>
+	  </varlistentry>
+
 	  <varlistentry id="ini.asp-tags">
 	   <term>
 		<parameter>asp_tags</parameter>
diff --git a/chapters/install.xml b/chapters/install.xml
index b6002889f9..99c768cad1 100644
--- a/chapters/install.xml
+++ b/chapters/install.xml
@@ -2121,6 +2121,14 @@
         PHP 3, PHP 4: Disable the URL-aware fopen wrapper that allows accessing
         files via http or ftp.
        </para>
+			 <warning>
+				<para>
+				 This switch is only available for PHP versions up to 4.0.3, newer
+				 versions provide an INI parameter called 
+         <parameter>allow_url_fopen</parameter> instead of forcing you to
+         decide upon this feature at compile time.
+				</para>
+			 </warning>
       </listitem>
      </varlistentry>
 
diff --git a/features/remote-files.xml b/features/remote-files.xml
index 5bf469baa8..db66893ca1 100644
--- a/features/remote-files.xml
+++ b/features/remote-files.xml
@@ -4,7 +4,9 @@
   <para>
    As long as support for the &quot;URL fopen wrapper&quot; is enabled when
    you configure PHP (which it is unless you explicitly pass the
-   <option>--disable-url-fopen-wrapper</option> flag to configure),
+   <option>--disable-url-fopen-wrapper</option> flag to configure (for versions 
+   up to 4.0.3) or set <parameter>allow_url_fopen</parameter> to off in php.ini 
+   (for newer versions),
    you can use HTTP and FTP URLs with most functions that take a
    filename as a parameter, including the <function>require</function>
    and <function>include</function> statements.