X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http.md;h=0f395412ef749c53860b30609a40fe11ce602c0e;hb=c2e4d7edf424ea7684c31fc15310ab563a27725f;hp=6175e26c14ad76f980ed602ba08a95527161d260;hpb=fb2ab0c8596f274acb2a3aea76f97c895ee2af34;p=mdref%2Fmdref-http diff --git a/http.md b/http.md index 6175e26..0f39541 100644 --- a/http.md +++ b/http.md @@ -1,5 +1,62 @@ -# namespace http +# pecl/http v2 -This is pecl_http-v2. +## About: -This documentation is work-in-progress. +Extended HTTP support. Again. + +* Introduces the http namespace. +* PHP stream based message bodies. +* Encapsulated env request/response. +* Modular client support. + +## Installation: + +This extension is hosted at [PECL](http://pecl.php.net) and can be installed with [PEAR](http://pear.php.net)'s pecl command: + + # pecl install pecl_http + +## Dependencies: + +This extension unconditionally depends on the pre-loaded presence of the following PHP extensions: + +* raphf +* propro +* spl + + +If configured ```--with-http-shared-deps``` (default) it depends on the pre-loaded presence of the following extensions, as long as they were available at build time: + +* hash +* iconv +* json + +## Conflicts: + +pecl/http-v2 conflicts with the following extensions: + +* http-v1 +* event (only until <= 2.0.3) + +## INI Directives: + +* http.etag.mode = "crc32b" + Default hash method for dynamic response payloads to generate an ETag. + +## Stream Filters: + +The http extension registers the ```http.*``` namespace for its stream filters. Provided stream filters are: + +* http.chunked_decode + Decode a stream encoded with chunked transfer encoding. +* http.chunked_encode + Encode a stream with chunked transfer encoding. +* http.inflate + Decode a stream encoded with deflate/zlib/gzip encoding. +* http.deflate + Encode a stream with deflate/zlib/gzip encoding. + +## Changelog: + +Version | Change +--------|------- +2.0.4 | Dropped the pecl/event conflict.