2002-04-15 00:12:54 +00:00
|
|
|
<?xml version="1.0" encoding="iso-8859-1"?>
|
2007-06-20 22:25:43 +00:00
|
|
|
<!-- $Revision: 1.24 $ -->
|
2005-09-04 19:39:32 +00:00
|
|
|
<!-- Purpose: basic.php -->
|
2006-07-24 11:01:55 +00:00
|
|
|
<!-- Membership: pecl -->
|
2005-09-04 19:39:32 +00:00
|
|
|
|
2007-06-20 22:25:43 +00:00
|
|
|
<reference xml:id="ref.http" xmlns="http://docbook.org/ns/docbook">
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>HTTP</title>
|
|
|
|
<titleabbrev>http</titleabbrev>
|
2002-04-15 00:12:54 +00:00
|
|
|
|
2006-07-24 11:01:55 +00:00
|
|
|
<partintro>
|
2007-06-20 22:25:43 +00:00
|
|
|
<section xml:id="http.intro">
|
2002-05-26 21:16:38 +00:00
|
|
|
&reftitle.intro;
|
2006-07-24 11:01:55 +00:00
|
|
|
<simpara>
|
|
|
|
This HTTP extension aims to provide a convenient and powerful
|
|
|
|
set of functionality for one of PHPs major applications.
|
|
|
|
</simpara>
|
|
|
|
<simpara>
|
2006-09-08 08:48:16 +00:00
|
|
|
It eases handling of HTTP URLs, dates, redirects, headers and
|
2006-07-24 11:01:55 +00:00
|
|
|
messages, provides means for negotiation of clients preferred
|
|
|
|
language and charset, as well as a convenient way to send any
|
|
|
|
arbitrary data with caching and resuming capabilities.
|
|
|
|
</simpara>
|
|
|
|
<simpara>
|
|
|
|
It provides powerful request functionality, if built with CURL
|
|
|
|
support. Parallel requests are available for PHP 5 and greater.
|
|
|
|
</simpara>
|
|
|
|
<simpara>
|
|
|
|
Additionally to the API reference in this manual you can find
|
|
|
|
information about how to install and configure as well as
|
|
|
|
which global constants are predefined in the following sections:
|
|
|
|
</simpara>
|
|
|
|
<simplelist>
|
|
|
|
<member><link linkend="http.install">Installation</link></member>
|
|
|
|
<member><link linkend="http.configuration">Configuration</link></member>
|
|
|
|
<member><link linkend="http.constants">Global Constants</link></member>
|
2007-03-04 08:38:38 +00:00
|
|
|
<member><link linkend="http.resources">Resource Types</link></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
2002-05-26 21:16:38 +00:00
|
|
|
|
2007-06-20 22:25:43 +00:00
|
|
|
<section xml:id="classess.http">
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Classes</title>
|
2007-03-29 17:49:01 +00:00
|
|
|
&extension.classes;
|
|
|
|
<simpara>
|
|
|
|
The <classname>HttpResponse</classname> class requires at least PHP v5.1.
|
|
|
|
Any other class is available as of PHP v5.0.
|
|
|
|
</simpara>
|
|
|
|
<note>
|
|
|
|
<simpara>
|
2007-04-13 18:11:10 +00:00
|
|
|
Be aware though, that some methods are not available with PHP v5.0.
|
2007-03-29 17:49:01 +00:00
|
|
|
</simpara>
|
|
|
|
</note>
|
2006-07-24 11:01:55 +00:00
|
|
|
<simplelist>
|
|
|
|
<member><link linkend="http.HttpMessage"><classname>HttpMessage</classname></link></member>
|
|
|
|
<member><link linkend="http.HttpQueryString"><classname>HttpQueryString</classname></link></member>
|
|
|
|
<member><link linkend="http.HttpDeflateStream"><classname>HttpDeflateStream</classname></link></member>
|
|
|
|
<member><link linkend="http.HttpInflateStream"><classname>HttpInflateStream</classname></link></member>
|
|
|
|
<member><link linkend="http.HttpRequest"><classname>HttpRequest</classname></link></member>
|
|
|
|
<member><link linkend="http.HttpRequestPool"><classname>HttpRequestPool</classname></link></member>
|
2006-08-06 04:48:10 +00:00
|
|
|
<member><link linkend="http.HttpResponse"><classname>HttpResponse</classname></link></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
2002-05-26 21:16:38 +00:00
|
|
|
|
2007-06-20 22:25:43 +00:00
|
|
|
<section xml:id="functions.http">
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Functions</title>
|
2007-03-25 16:46:48 +00:00
|
|
|
<section>
|
2007-02-15 09:24:37 +00:00
|
|
|
<title>Built-in Functions</title>
|
2006-07-24 11:01:55 +00:00
|
|
|
<simpara>
|
2007-02-15 09:24:37 +00:00
|
|
|
Built-in HTTP related functions previously listed on this page can be found in the
|
2006-07-24 11:01:55 +00:00
|
|
|
<link linkend="ref.network">networking</link> category.
|
|
|
|
</simpara>
|
|
|
|
<simpara>
|
|
|
|
The following functions do not need the HTTP module to be present:
|
|
|
|
<function>header</function>, <function>headers_list</function>, <function>headers_sent</function>,
|
|
|
|
<function>setcookie</function> &listendand; <function>setrawcookie</function>.
|
|
|
|
</simpara>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Caching</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_cache_etag</function></member>
|
|
|
|
<member><function>http_cache_last_modified</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Encodings</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_chunked_decode</function></member>
|
|
|
|
<member><function>http_deflate</function></member>
|
|
|
|
<member><function>http_inflate</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-27 03:29:39 +00:00
|
|
|
<title>Miscellaneous</title>
|
2006-07-24 11:01:55 +00:00
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_build_cookie</function></member>
|
|
|
|
<member><function>http_date</function></member>
|
|
|
|
<member><function>http_get_request_body_stream</function></member>
|
|
|
|
<member><function>http_get_request_body</function></member>
|
|
|
|
<member><function>http_get_request_headers</function></member>
|
|
|
|
<member><function>http_match_etag</function></member>
|
|
|
|
<member><function>http_match_modified</function></member>
|
|
|
|
<member><function>http_match_request_header</function></member>
|
|
|
|
<member><function>http_support</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Negotiation</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_negotiate_charset</function></member>
|
|
|
|
<member><function>http_negotiate_content_type</function></member>
|
|
|
|
<member><function>http_negotiate_language</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Outputhandlers</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>ob_deflatehandler</function></member>
|
|
|
|
<member><function>ob_etaghandler</function></member>
|
|
|
|
<member><function>ob_inflatehandler</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Parsers</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_parse_cookie</function></member>
|
|
|
|
<member><function>http_parse_headers</function></member>
|
|
|
|
<member><function>http_parse_message</function></member>
|
|
|
|
<member><function>http_parse_params</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Requests</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_get</function></member>
|
|
|
|
<member><function>http_head</function></member>
|
|
|
|
<member><function>http_post_data</function></member>
|
|
|
|
<member><function>http_post_fields</function></member>
|
|
|
|
<member><function>http_put_data</function></member>
|
|
|
|
<member><function>http_put_file</function></member>
|
|
|
|
<member><function>http_put_stream</function></member>
|
|
|
|
<member><function>http_request_body_encode</function></member>
|
|
|
|
<member><function>http_request_method_exists</function></member>
|
|
|
|
<member><function>http_request_method_name</function></member>
|
|
|
|
<member><function>http_request_method_register</function></member>
|
|
|
|
<member><function>http_request_method_unregister</function></member>
|
|
|
|
<member><function>http_request</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-07-24 11:01:55 +00:00
|
|
|
<title>Responses</title>
|
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_redirect</function></member>
|
|
|
|
<member><function>http_send_content_disposition</function></member>
|
|
|
|
<member><function>http_send_content_type</function></member>
|
|
|
|
<member><function>http_send_data</function></member>
|
|
|
|
<member><function>http_send_file</function></member>
|
|
|
|
<member><function>http_send_last_modified</function></member>
|
|
|
|
<member><function>http_send_status</function></member>
|
|
|
|
<member><function>http_send_stream</function></member>
|
|
|
|
<member><function>http_throttle</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
|
|
|
<section>
|
2006-09-08 08:48:16 +00:00
|
|
|
<title>URLs</title>
|
2006-07-24 11:01:55 +00:00
|
|
|
<simplelist>
|
2007-03-27 10:18:05 +00:00
|
|
|
<member><function>http_build_str</function></member>
|
|
|
|
<member><function>http_build_url</function></member>
|
2006-07-24 11:01:55 +00:00
|
|
|
</simplelist>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
2007-03-28 06:33:29 +00:00
|
|
|
<section>
|
|
|
|
<title>Persistent Handles</title>
|
|
|
|
<simplelist>
|
|
|
|
<member><function>http_persistent_handles_count</function></member>
|
|
|
|
<member><function>http_persistent_handles_ident</function></member>
|
2007-03-29 15:32:53 +00:00
|
|
|
<member><function>http_persistent_handles_clean</function></member>
|
2007-03-28 06:33:29 +00:00
|
|
|
</simplelist>
|
|
|
|
</section>
|
2007-03-25 16:46:48 +00:00
|
|
|
</section>
|
2002-05-26 21:16:38 +00:00
|
|
|
|
2006-07-24 11:01:55 +00:00
|
|
|
</partintro>
|
2002-04-15 00:12:54 +00:00
|
|
|
|
2006-07-24 11:01:55 +00:00
|
|
|
&reference.http.install;
|
|
|
|
&reference.http.configuration;
|
2007-03-04 08:38:38 +00:00
|
|
|
&reference.http.resources;
|
2006-07-24 11:01:55 +00:00
|
|
|
&reference.http.constants;
|
2007-03-27 10:13:49 +00:00
|
|
|
&reference.http.request-options;
|
2006-07-24 11:01:55 +00:00
|
|
|
&reference.http.HttpMessage;
|
|
|
|
&reference.http.HttpQueryString;
|
|
|
|
&reference.http.HttpDeflateStream;
|
|
|
|
&reference.http.HttpInflateStream;
|
|
|
|
&reference.http.HttpRequest;
|
|
|
|
&reference.http.HttpRequestPool;
|
|
|
|
&reference.http.HttpResponse;
|
2007-03-27 10:13:49 +00:00
|
|
|
|
2006-07-24 11:01:55 +00:00
|
|
|
&reference.http.functions;
|
|
|
|
|
|
|
|
</reference>
|
2002-04-15 00:12:54 +00:00
|
|
|
|
|
|
|
<!-- 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
|
|
|
|
-->
|