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


Reply via email to