support sub dirs
[mdref/mdref-http] / http.md
1 # pecl/http v2
2
3 > **Note:** This documentation is work-in-progress.
4
5 ## About:
6
7 Extended HTTP support. Again. Keep in mind that it's got the major version 2, because it's incompatible with pecl_http v1.
8
9 * Introduces the http namespace.
10 * Message bodies have been remodeled to use PHP temporary streams instead of in-memory buffers.
11 * The utterly misunderstood HttpResponse class has been reimplemented as http\Env\Response inheriting http\Message.
12 * Currently, there's only one Exception class left, http\Exception.
13 * Errors triggered by the extension can be configured statically by http\Object::$defaultErrorHandling or inherited http\Object->errorHandling.
14 * The request ecosystem has been modularized to support different libraries, though for the moment only libcurl is supported.
15
16 ## Installation:
17
18 This extension is hosted at PECL (<http://pecl.php.net>) and can be installed eith PEAR's pecl command:
19
20 # pecl install pecl_http
21
22 ## INI Directives:
23
24 * http.etag.mode = "crc32b"
25 Default hash method for dynamic response payloads to generate an ETag.
26