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