From 6e8ea74b6f377ff2d1a7bffc682aa773ec3400ff Mon Sep 17 00:00:00 2001 From: Michael Wallner Date: Fri, 1 Aug 2014 10:22:46 +0200 Subject: [PATCH] 2.1.0 --- http/Client.md | 2 +- http/Client/Curl.md | 18 +++++++++-- http/Params.md | 74 +++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 90 insertions(+), 4 deletions(-) diff --git a/http/Client.md b/http/Client.md index 64d7aa8..4e9cb4e 100644 --- a/http/Client.md +++ b/http/Client.md @@ -1,6 +1,6 @@ # class http\Client implements SplSubject, Countable -The HTTP client. The only driver currently supported is http\Client\Curl. +The HTTP client. See http\Client\Curl's [options](http/Client/Curl#Options:) which is the only driver currently supported. ## Examples: diff --git a/http/Client/Curl.md b/http/Client/Curl.md index d0f692b..8051b73 100644 --- a/http/Client/Curl.md +++ b/http/Client/Curl.md @@ -2,6 +2,12 @@ The http\Client\Curl namespace holds option value constants specific to the curl driver of the http\Client. +## Changelog + +Version | Change +--------|------- +2.1.0 | Added $dns_interface, $dns_local_ip4, $dns_local_ip6 options. + ## Constants: ### HTTP Protocol Version @@ -75,6 +81,7 @@ The http\Client\Curl namespace holds option value constants specific to the curl ## Options: +The option names used here are more or less derived from the corresponding CURLOPT_* names. ### HTTP * int $protocol @@ -106,8 +113,14 @@ The http\Client\Curl namespace holds option value constants specific to the curl * array $resolve A list of HOST:PORT:ADDRESS mappings which pre-populate the DNS cache. Available if libcurl is v7.21.3 or more recent. * string $dns_servers - Comma separated list of custom DNS servers of the form HOST[:PORT]. Available if libcurl is v7.24.0 or more recent. - + Comma separated list of custom DNS servers of the form HOST[:PORT]. Available if libcurl is v7.24.0 or more recent and has built-in c-ares support. +* string $dns_interface + The name of the network interface ***name*** that the DNS resolver should bind to. Available if libcurl is v7.33.0 or more recent and has built-in c-ares support. +* string $dns_local_ip4 + The local IPv4 ***address*** that the resolver should bind to. Available if libcurl is v7.33.0 or more recent and has built-in c-ares support. +* string $dns_local_ip6 + The local IPv6 ***address*** that the resolver should bind to. Available if libcurl is v7.33.0 or more recent and has built-in c-ares support. + ### Limits * int $low_speed_limit @@ -242,4 +255,3 @@ The http\Client\Curl namespace holds option value constants specific to the curl File with the concatenation of CRL in PEM format. Available if libcurl was built with OpenSSL support. * bool $certinfo Enable gathering of SSL certificate chain information. Available if libcurl is v7.19.1 or more recent. - diff --git a/http/Params.md b/http/Params.md index d8bf3b7..51863f0 100644 --- a/http/Params.md +++ b/http/Params.md @@ -2,6 +2,78 @@ Parse, interpret and compose HTTP (header) parameters. +## Changelog: + +Version | Change +--------|------- +2.0.1 | Added [RFC5987](http://tools.ietf.org/html/rfc5987) support + +## Example: + + params, $p->toString()); + + ?> + +Yields: + + array(3) { + ["p1"]=> + array(2) { + ["*rfc5987*"]=> + array(1) { + ["de"]=> + string(5) "süß" + } + ["arguments"]=> + array(0) { + } + } + ["p2"]=> + array(2) { + ["*rfc5987*"]=> + array(1) { + [""]=> + string(5) "heiß" + } + ["arguments"]=> + array(2) { + ["*rfc5987*"]=> + array(2) { + ["a1"]=> + array(1) { + [""]=> + string(3) "aß" + } + ["a2"]=> + array(1) { + [""]=> + string(3) "eß" + } + } + ["a3"]=> + string(2) "no" + } + } + ["p3"]=> + array(2) { + ["value"]=> + string(3) "not" + ["arguments"]=> + array(0) { + } + } + } + string(98) "p1*=utf-8'de's%C3%BC%C3%9F,p2*=utf-8''hei%C3%9F;a1*=utf-8''a%C3%9F;a2*=utf-8''e%C3%9F;a3=no,p3=not" + + ## Constants: * DEF_PARAM_SEP @@ -22,6 +94,8 @@ Parse, interpret and compose HTTP (header) parameters. Parse sub dimensions indicated by square brackets. * PARSE_QUERY Parse URL querystring (same as http\Params::PARSE_URLENCODED|http\Params::PARSE_DIMENSION). +* PARSE_RFC5987 + Parse [RFC5987](http://tools.ietf.org/html/rfc5987) style encoded character set and language information embedded in HTTP header params. ## Properties: -- 2.30.2