X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http%2FParams.md;h=51863f0f7c369ff859d9335e345b5d1f9c760b22;hb=f10a5d76f8f9e493a22228c64030edaccfe1228c;hp=d8bf3b77b691e3a690cb18e937b70a78e297d2cf;hpb=95e046983749327a4f1271b99badaae7a838ec67;p=mdref%2Fmdref-http

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:
+
+	<?php
+
+	$u = urlencode("ü");
+	$s = urlencode("ß");
+
+	$t = "p1*=utf-8'de's$u$s,p2*=utf-8''hei$s;a1*=utf-8''a$s;a2*=utf-8''e$s;a3=no,p3=not";
+	$p = new http\Params($t);
+
+	var_dump($p->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: