X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http%2FParams.md;h=4349769938a6aafcdb802d1865e267d3491eeb02;hb=3bf080fbfef8496240a6d42d4a2d4c08c04cf8fd;hp=7943b9726d98139ee1318855de08cde53ba204a0;hpb=594e4eea4c360ce54300e9f6030a715bc52b0029;p=mdref%2Fmdref-http diff --git a/http/Params.md b/http/Params.md index 7943b97..4349769 100644 --- a/http/Params.md +++ b/http/Params.md @@ -2,139 +2,6 @@ Parse, interpret and compose HTTP (header) parameters. -## Changelog: - -Version | Change ---------|------- -2.1.0 | Added [RFC5987](http://tools.ietf.org/html/rfc5987) support -2.5.0 | Added [RFC5988](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" - -## Web Linking Example: - - $link = <<; - rel="previous"; title*=UTF-8'de'letztes%20Kapitel, - ; - rel="next"; title*=UTF-8'de'n%c3%a4chstes%20Kapitel - EOF; - - $p = current(http\Header::parse($link, "http\\Header"))->getParams( - http\Params::DEF_PARAM_SEP, - http\Params::DEF_ARG_SEP, - http\Params::DEF_VAL_SEP, - http\Params::PARSE_RFC5988 | http\Params::PARSE_ESCAPED - ); - - var_dump($p->params); - var_dump((string)$p); - -Yields: - - array(2) { - ["/TheBook/chapter2"]=> - array(2) { - ["value"]=> - bool(true) - ["arguments"]=> - array(2) { - ["rel"]=> - string(8) "previous" - ["*rfc5987*"]=> - array(1) { - ["title"]=> - array(1) { - ["de"]=> - string(15) "letztes Kapitel" - } - } - } - } - ["/TheBook/chapter4"]=> - array(2) { - ["value"]=> - bool(true) - ["arguments"]=> - array(2) { - ["rel"]=> - string(4) "next" - ["*rfc5987*"]=> - array(1) { - ["title"]=> - array(1) { - ["de"]=> - string(17) "nächstes Kapitel" - } - } - } - } - } - string(139) ";rel="previous";title*=utf-8'de'letztes%20Kapitel,;rel="next";title*=utf-8'de'n%C3%A4chstes%20Kapitel" - ## Constants: * DEF_PARAM_SEP @@ -155,9 +22,9 @@ Yields: 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 Parse [RFC5987](http://tools.ietf.org/html/rfc5987) style encoded character set and language information embedded in HTTP header params. -* PARSE_RFC5988 +* PARSE_RFC5988 Parse [RFC5988](http://tools.ietf.org/html/rfc5988) (Web Linking) tags of Link headers. ## Properties: