wez Sat Mar 16 10:06:09 2002 EDT Modified files: /phpdoc/en/functions filesystem.xml network.xml Log: update docs to reflect recent streams changes Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.128 phpdoc/en/functions/filesystem.xml:1.129 --- phpdoc/en/functions/filesystem.xml:1.128 Sat Mar 9 13:01:17 2002 +++ phpdoc/en/functions/filesystem.xml Sat Mar 16 10:06:08 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.128 $ --> +<!-- $Revision: 1.129 $ --> <reference id="ref.filesystem"> <title>Filesystem functions</title> <titleabbrev>Filesystem</titleabbrev> @@ -1130,6 +1130,35 @@ </refsect1> </refentry> + <refentry id="function.fgetwrapperdata"> + <refnamediv> + <refname>fgetwrapperdata</refname> + <refpurpose>Retrieves header/meta data from "wrapped" file pointers</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mixed</type><methodname>fgetwrapperdata</methodname> + <methodparam><type>int</type><parameter>fp</parameter></methodparam> + </methodsynopsis> + <simpara> + This function returns header or meta data from files opened with + <function>fopen</function>. This is useful to return the response + headers for HTTP connections, or some other statistics for other + resources. + </simpara> + <simpara> + The format of the returned data is deliberately undocumented at this + time. + </simpara> + <note> + <para> + This function was introduced in PHP 4.3.0. + </para> + </note> + </refsect1> + </refentry> + <refentry id="function.fopen"> <refnamediv> <refname>fopen</refname> @@ -1152,10 +1181,20 @@ request in order to handle name-based virtual hosts. </simpara> <simpara> + As of PHP 4.3.0 (not yet released), if you have compiled in + support for OpenSSL, you may use "https://" to open an HTTP + connection over SSL. + <simpara> Note that the file pointer allows you to retrieve only the - <emphasis>body</emphasis> of the response; you cannot - access the HTTP response header using this function. Additionally, - HTTP connections are read-only. + <emphasis>body</emphasis> of the response; to retrieve the HTTP + 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 (not yet released), the header information can + be retrieved using the <function>fgetwrapperdata</function>. + </simpara> + <simpara> + HTTP connections are read-only; you cannot write data or copy + files to an HTTP resource. </simpara> <simpara> Versions prior to PHP 4.0.5 do not handle HTTP redirects. Because Index: phpdoc/en/functions/network.xml diff -u phpdoc/en/functions/network.xml:1.59 phpdoc/en/functions/network.xml:1.60 --- phpdoc/en/functions/network.xml:1.59 Wed Mar 13 14:18:30 2002 +++ phpdoc/en/functions/network.xml Sat Mar 16 10:06:08 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.59 $ --> +<!-- $Revision: 1.60 $ --> <reference id="ref.network"> <title>Network Functions</title> <titleabbrev>Network</titleabbrev> @@ -159,6 +159,13 @@ socket, <parameter>port</parameter> must be set to 0 in this case. The optional <parameter>timeout</parameter> can be used to set a timeout in seconds for the connect system call. + </para> + <para> + As of PHP 4.3.0, if you have compiled in OpenSSL support, you may + prefix the <parameter>hostname</parameter> with either + '<literal>ssl://</literal>' or '<literal>tls://</literal>' to + use an SSL or TLS client connection over TCP/IP to connect + to the remote host. </para> <para> <function>fsockopen</function> returns a file pointer which may