svn: /phpdoc/en/trunk/ appendices/wrappers.xml reference/stream/streamwrapper/stream-open.xml reference/stream/streamwrapper/url-stat.xml
| From: | Rasmus Lerdorf | Date: | Mon, 27 Jul 2009 00:57:18 +0000 |
| Subject: | svn: /phpdoc/en/trunk/ appendices/wrappers.xml reference/stream/streamwrapper/stream-open.xml reference/stream/streamwrapper/url-stat.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-4515@lists.php.net to get a copy of this message | ||
rasmus Mon, 27 Jul 2009 00:57:18 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=286382
Log:
Note about the URL-syntax supported by the wrappers
Changed paths:
U phpdoc/en/trunk/appendices/wrappers.xml
U phpdoc/en/trunk/reference/stream/streamwrapper/stream-open.xml
U phpdoc/en/trunk/reference/stream/streamwrapper/url-stat.xml
Modified: phpdoc/en/trunk/appendices/wrappers.xml
===================================================================
--- phpdoc/en/trunk/appendices/wrappers.xml 2009-07-26 23:44:59 UTC (rev 286381)
+++ phpdoc/en/trunk/appendices/wrappers.xml 2009-07-27 00:57:18 UTC (rev 286382)
@@ -3,12 +3,17 @@
<appendix xml:id="wrappers" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
<title>List of Supported Protocols/Wrappers</title>
<para>
- PHP comes with many built-in wrappers for various URL style protocols
+ PHP comes with many built-in wrappers for various URL-style protocols
for use with the filesystem functions such as <function>fopen</function>
and <function>copy</function>. In addition to these wrappers, you can as of
PHP 4.3.0, write your own wrappers using the
<function>stream_wrapper_register</function>
function.
</para>
+ <note>
+ <simpara>The URL syntax used to describe a wrapper only supports the scheme://... syntax.
+ scheme:/ and scheme: syntaxes are not supported.
+ </simpara>
+ </note>
<para>
List of context options is available in the chapter <xref linkend="context"/>.
</para>
Modified: phpdoc/en/trunk/reference/stream/streamwrapper/stream-open.xml
===================================================================
--- phpdoc/en/trunk/reference/stream/streamwrapper/stream-open.xml 2009-07-26 23:44:59 UTC (rev
286381)
+++ phpdoc/en/trunk/reference/stream/streamwrapper/stream-open.xml 2009-07-27 00:57:18 UTC (rev
286382)
@@ -34,7 +34,8 @@
</para>
<note>
<para>
- The URL can be broken apart with <function>parse_url</function>.
+ The URL can be broken apart with <function>parse_url</function>. Note that
only URLs
+ delimited by :// are supported. : and :/ while technically valid URLs, are not.
</para>
</note>
</listitem>
Modified: phpdoc/en/trunk/reference/stream/streamwrapper/url-stat.xml
===================================================================
--- phpdoc/en/trunk/reference/stream/streamwrapper/url-stat.xml 2009-07-26 23:44:59 UTC (rev 286381)
+++ phpdoc/en/trunk/reference/stream/streamwrapper/url-stat.xml 2009-07-27 00:57:18 UTC (rev 286382)
@@ -66,7 +66,8 @@
<term><parameter>path</parameter></term>
<listitem>
<para>
- The file URL which should retrieve information about.
+ The file path or URL to stat. Note that in the case of a URL, it must be a :// delimited
+ URL. Other URL forms are not supported.
</para>
</listitem>
</varlistentry>