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