X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;ds=sidebyside;f=http.md;h=e78795a39cdd97260beabcfee361844bd6903755;hb=2e725f2f76304475dceb47d3f22b778b0e6c91ca;hp=b5b3bf1ca627a5983265250aa0f8bab352a31e5e;hpb=f513a6191eace8b2dc8abb2de5ad8bbdae6fdea4;p=mdref%2Fmdref-http diff --git a/http.md b/http.md index b5b3bf1..e78795a 100644 --- a/http.md +++ b/http.md @@ -17,6 +17,40 @@ This extension is hosted at [PECL](http://pecl.php.net) and can be installed wit ## Dependencies: +pecl/http depends on a number of system libraries and PHP extensions for special features. + +#### Required system libraries: + +The following system libraries are required to build this extension: + +=zlib= + Provides gzip/zlib/deflate encoding. + Minimum version: 1.2.0.4 + Install on Debian: `apt-get install zlib1g-dev` + + +#### Optional system libraries: + +The following system libraries are optional and provide additional features: + +=libidn= + Provides IDNA support in URLs. + Minimum version: none + Install on Debian: `apt-get install libidn11-dev` + +=libcurl= + Provides HTTP request functionality. + Minimum version: 7.18.2 + Install on Debian: `apt-get install libcurl4-openssl-dev` + Note: There are usually different styles of SSL support for libcurl available, so you can replace 'openssl' in the above command f.e. with 'nss' or 'gnutls'. + +=libevent= + Eventloop support for the HTTP client. + Minimum version: none + Install on Debian: `apt-get install libevent-dev` + +### PHP extensions: + This extension unconditionally depends on the pre-loaded presence of the following PHP extensions: * raphf @@ -24,18 +58,32 @@ This extension unconditionally depends on the pre-loaded presence of the followi * spl -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: +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 +Please ensure that all extension on which pecl/http depends, are loaded before it, e.g in your `php.ini`: + + ; obligatory deps + extension = raphf.so + extension = propro.so + + ; if shared deps were enabled + extension = hash.so + extension = iconv.so + extension = json.so + + ; finally load pecl/http + extension = http.so + ## Conflicts: -pecl/http-v2 conflicts with thw following extensions: +pecl/http-v2 conflicts with the following extensions: * http-v1 -* event +* event (only until <= 2.0.3) ## INI Directives: @@ -54,3 +102,9 @@ The http extension registers the ```http.*``` namespace for its stream filters. 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.