tweaks
[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.
8
9 * Introduces the http namespace.
10 * PHP stream based message bodies.
11 * Encapsulated env request/response.
12 * Versatile error handling.
13 * Modular client support.
14
15 ## Installation:
16
17 This extension is hosted at [PECL](http://pecl.php.net) and can be installed with [PEAR](http://pear.php.net)'s pecl command:
18
19 # pecl install pecl_http
20
21 ## Dependencies:
22
23 This extension unconditionally depends on the pre-loaded presence of the following PHP extensions:
24
25 * raphf
26 * propro
27 * spl
28
29
30 If configured ```--with-http-shared-deps``` (default) it requires on the pre-loaded presence of the following extensions, as long as they where available at build time:
31
32 * hash
33 * iconv
34 * json
35
36 ## Conflicts:
37
38 pecl/http-v2 conflicts with thw following extensions:
39
40 * http-v1
41 * event
42
43 ## INI Directives:
44
45 * http.etag.mode = "crc32b"
46 Default hash method for dynamic response payloads to generate an ETag.
47
48 ## Stream Filters:
49
50 The http extension registers the ```http.*``` namespace for its stream filters. Provided stream filters are:
51
52 * http.chunked_decode
53 Decode a stream encoded with chunked transfer encoding.
54 * http.chunked_encode
55 Encode a stream with chunked transfer encoding.
56 * http.inflate
57 Decode a stream encoded with deflate/zlib/gzip encoding.
58 * http.deflate
59 Encode a stream with deflate/zlib/gzip encoding.