Document ftps:// and add a table listing supported wrappers to the

appendices.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@95901 c90b9560-bf6c-de11-be94-00142212c4b1

appendices/wrappers.xml

@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- $Revision: 1.1 $ -->
+<appendix id="wrappers">
+ <title>List of Supported Protocols/Wrappers</title>
+ <para>
+  The following is a list of the various URL style protocols that
+  PHP has built-in for use with the filesystem functions such as
+  <function>fopen</function> and <function>copy</function>.
+  In addition to these wrappers, as of PHP 4.3, you can write
+  your own wrappers using PHP script and
+  <function>file_register_wrapper</function>.
+
+  <table>
+   <title>URL Wrappers</title>
+   <tgroup cols="3">
+   <thead>
+    <row>
+     <entry>Protocol</entry>
+     <entry>Versions</entry>
+     <entry>Description</entry>
+    </row>
+   </thead>
+   <tbody>
+    <row>
+     <entry>http://</entry>
+     <entry>All</entry>
+     <entry>Allows read-only access to files/resources via HTTP.</entry>
+    </row>
+    <row>
+     <entry>https://</entry>
+     <entry>PHP 4.3 and up, with SSL support</entry>
+     <entry>Allows read-only access to files/resources via SSL secured
+      HTTP.
+     </entry>
+    </row>
+    <row>
+     <entry>ftp://</entry>
+     <entry>All</entry>
+     <entry>Allows read access to existing files and creation of new files
+      via FTP.
+     </entry>
+    </row>
+    <row>
+     <entry>ftps://</entry>
+     <entry>PHP 4.3 and up, with SSL support</entry>
+     <entry>The same as ftp://, but uses SSL when supported by the FTP server.</entry>
+    </row>
+    <row>
+     <entry>php://stdin</entry>
+     <entry>PHP 3.0.13 and up</entry>
+     <entry>Allows read acess to the standard input stream of the PHP process.</entry>
+    </row>
+    <row>
+     <entry>php://stdout</entry>
+     <entry>PHP 3.0.13 and up</entry>
+     <entry>Allows write acess to the standard output stream of the PHP process.</entry>
+    </row>
+    <row>
+     <entry>php://stderr</entry>
+     <entry>PHP 3.0.13 and up</entry>
+     <entry>Allows write acess to the standard error stream of the PHP process.</entry>
+    </row>
+    <row>
+     <entry>php://output</entry>
+     <entry>PHP 4.3 and up</entry>
+     <entry>Allows write acess to the output buffer mechanism, just like
+      <function>echo</function> and <function>print</function>.
+     </entry>
+    </row>
+    <row>
+     <entry>zlib:</entry>
+     <entry>PHP 4.0.4 - PHP 4.2.3, systems with fopencookie only</entry>
+     <entry>Works like <function>gzopen</function>, except that the
+      stream can be used with <function>fread</function> and the other
+      filesystem functions.  This is deprecated as of PHP 4.3 due
+      to ambiguities with filenames containing ':' characters; use
+      compress.zlib:// instead.
+     </entry>
+    </row>
+    <row>
+     <entry>compress.zlib://</entry>
+     <entry>PHP 4.3 and up</entry>
+     <entry>Works just like <function>gzopen</function>, even on systems
+      without fopencookie.
+     </entry>
+    </row>
+    <row>
+     <entry>compress.bzip2://</entry>
+     <entry>PHP 4.3 and up</entry>
+     <entry>Works just like <function>bzopen</function>.
+     </entry>
+    </row>
+   </tbody>
+   </tgroup>
+  </table>
+ </para>
+</appendix>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/filesystem/functions/fopen.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.fopen">
    <refnamediv>
@@ -33,7 +33,7 @@
      response header you need to be using PHP 4.0.5 or later;
      The headers will be stored in the $http_response_header variable.
      As of PHP 4.3.0, the header information can be retrieved using 
-     the <function>file_get_wrapper_data</function>.
+     <function>file_get_wrapper_data</function>.
     </simpara>
     <simpara>
      HTTP connections are read-only; you cannot write data or copy
@@ -54,6 +54,13 @@
      If you need to update existing files over ftp, use
      <function>ftp_connect</function>.
     </simpara>
+    <simpara>
+     As of PHP 4.3.0, if you have compiled in support for OpenSSL, 
+     you may use "ftps://" to open an FTP connection that will
+     use SSL to encrypt the connection.  PHP will fall-back and
+     work just like regular ftp:// if the server does not support
+     SSL.
+    </simpara>
     <simpara>
      If <parameter>filename</parameter> is one of "php://stdin",
      "php://stdout", or "php://stderr", the corresponding stdio
@@ -166,7 +173,8 @@ $fp = fopen ("c:\\data\\info.txt", "r");
      </informalexample>
     </para>
     <simpara>
-     See also <function>fclose</function>,
+     See also <xref linkend="wrappers"/>
+     <function>fclose</function>,
      <function>fgets</function>, 
      <function>fsockopen</function>,
      <function>file</function>,