cvs: phpdoc / manual.xml.in /en/appendices wrappers.xml /en/reference/filesystem/functions fopen.xml

wez Mon Sep 16 14:13:37 2002 EDT Added files: /phpdoc/en/appendices wrappers.xml Modified files: /phpdoc manual.xml.in /phpdoc/en/reference/filesystem/functions fopen.xml Log: Document ftps:// and add a table listing supported wrappers to the appendices. Index: phpdoc/manual.xml.in diff -u phpdoc/manual.xml.in:1.135 phpdoc/manual.xml.in:1.136 --- phpdoc/manual.xml.in:1.135 Mon Aug 12 08:46:14 2002 +++ phpdoc/manual.xml.in Mon Sep 16 14:13:37 2002 @@ -228,6 +228,7 @@ &appendices.aliases; &appendices.reserved; &appendices.resources; + &appendices.wrappers; &appendices.tokens; &appendices.about; &global.function-index; Index: phpdoc/en/reference/filesystem/functions/fopen.xml diff -u phpdoc/en/reference/filesystem/functions/fopen.xml:1.3 phpdoc/en/reference/filesystem/functions/fopen.xml:1.4 --- phpdoc/en/reference/filesystem/functions/fopen.xml:1.3 Sun Jul 14 14:56:44 2002 +++ phpdoc/en/reference/filesystem/functions/fopen.xml Mon Sep 16 14:13:37 2002 @@ -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 @@ -55,6 +55,13 @@ <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 stream will be opened. (This was introduced in PHP 3.0.13; @@ -166,7 +173,8 @@ </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>, Index: phpdoc/en/appendices/wrappers.xml +++ phpdoc/en/appendices/wrappers.xml <?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 -->