nlopess Fri Sep 22 15:36:16 2006 UTC
Modified files:
/phpdoc/en/appendices wrappers.xml
Log:
add the new 'data:' wrapper
http://cvs.php.net/viewvc.cgi/phpdoc/en/appendices/wrappers.xml?r1=1.62&r2=1.63&diff_format=u
Index: phpdoc/en/appendices/wrappers.xml
diff -u phpdoc/en/appendices/wrappers.xml:1.62
phpdoc/en/appendices/wrappers.xml:1.63
--- phpdoc/en/appendices/wrappers.xml:1.62 Fri Aug 11 22:00:05 2006
+++ phpdoc/en/appendices/wrappers.xml Fri Sep 22 15:36:16 2006
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.62 $ -->
+<!-- $Revision: 1.63 $ -->
<appendix id="wrappers">
<title>List of Supported Protocols/Wrappers</title>
<para>
@@ -889,6 +889,99 @@
</table>
</para>
</section>
+
+ <section id="wrappers.data">
+ <title>Data (RFC 2397)</title>
+ <simpara>
+ The <filename>data:</filename> (<ulink url="&url.rfc;2397">RFC
+ 2397</ulink>) is available since PHP 5.2.0.
+ </simpara>
+
+ <example>
+ <title>Print data:// contents</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// prints "I love PHP"
+echo file_get_contents('data://text/plain;base64,' . base64_encode("I love
PHP\n"));
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <example>
+ <title>Fetch the media type</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$fp = fopen('data://text/plain;base64,', 'r');
+$meta = stream_get_meta_data($fp);
+
+// prints "text/plain"
+echo $meta['mediatype'];
+?>
+]]>
+ </programlisting>
+ </example>
+
+
+ <para>
+ <table>
+ <title>Wrapper Summary</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Attribute</entry>
+ <entry>Supported</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Restricted by <link
linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Allows Reading</entry>
+ <entry>Yes</entry>
+ </row>
+ <row>
+ <entry>Allows Writing</entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Allows Appending</entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Allows Simultaneous Reading and Writing</entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Supports <function>stat</function></entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Supports <function>unlink</function></entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Supports <function>rename</function></entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Supports <function>mkdir</function></entry>
+ <entry>No</entry>
+ </row>
+ <row>
+ <entry>Supports <function>rmdir</function></entry>
+ <entry>No</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ </section>
+
<section id="wrappers.ssh2">
<title>Secure Shell 2</title>
<simpara>
