update docs to reflect recent streams changes

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@73589 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Wez Furlong 2002-03-16 15:06:08 +00:00
parent 8455a0dff1
commit 01d277e32f
2 changed files with 51 additions and 5 deletions

View file

@ -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 @@ $fcontents = implode ('', file ('http://www.php.net/'));
</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>
@ -1151,11 +1180,21 @@ $fcontents = implode ('', file ('http://www.php.net/'));
of the body of the response. A 'Host:' header is sent with the
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

View file

@ -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>
@ -160,6 +160,13 @@
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
be used together with the other file functions (such as