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
