mdref.json config
[mdref/mdref-http] / http / Url.md
index 71d41e111b6613b74457df07a607bae86f1cb016..0c8aa8dd0b04a64b9cec6c90476cc6788ce99392 100644 (file)
@@ -2,20 +2,6 @@
 
 The http\Url class provides versatile means to parse, construct and manipulate URLs.
 
-## Changelog:
-
-Version | Changes
---------|--------
-2.2.0   | Added parser constants:<br> http\Url::PARSE_MBUTF8,<br> http\Url::PARSE_MBLOC (on systems with wide character support),<br>http\Url::PARSE_TOPCT,<br>http\Url::PARSE_TOIDN (with libidn support).
-
-## Backwards compatibility
-
-### New parser in v2.2.0
-
-PHP's [parse_url()](http://php.net/parse_url) is avoided since v2.2.0.
-
-Creating an empty url by `new http\Url(NULL, NULL, 0)` will not result in `http://localhost/` anymore but in an empty URL instead.
-
 ## Constants:
 
 * REPLACE  
@@ -36,7 +22,7 @@ Creating an empty url by `new http\Url(NULL, NULL, 0)` will not result in `http:
   Do not include the URL path.
 * STRIP_QUERY  
   Do not include the URL querystring.
-* STRIP_FRAMGENT  
+* STRIP_FRAGMENT  
   Strip the fragment (hash) from the URL.
 * STRIP_ALL  
   Strip everything except scheme and host information.
@@ -45,13 +31,24 @@ Creating an empty url by `new http\Url(NULL, NULL, 0)` will not result in `http:
 * SANITIZE_PATH  
   Whether to sanitize the URL path (consolidate double slashes, directory jumps etc.)
 * PARSE_MBUTF8  
-  Parse UTF-8 encododed multibyte sequences.
+  Parse UTF-8 encoded multibyte sequences.
 * PARSE_MBLOC  
   Parse locale encoded multibyte sequences (on systems with wide character support).
 * PARSE_TOIDN  
-  Parse and convert multibyte hostnames according to IDNA (with libidn support).
+  Parse and convert multibyte hostnames according to IDNA (with IDNA support).
+* PARSE_TOIDN_2003  
+  Explicitly request IDNA2003 implementation if available (libidn, idnkit or ICU).
+* PARSE_TOIDN_2008  
+  Explicitly request IDNA2008 implementation if available (libidn2, idnkit2 or ICU).
 * PARSE_TOPCT  
   Percent encode multibyte sequences in the userinfo, path, query and fragment parts of the URL.
+* IGNORE_ERRORS  
+  Continue parsing when encountering errors.
+* SILENT_ERRORS  
+  Suppress errors/exceptions.
+* STDFLAGS  
+  Standard flags used by default internally for e.g. http\Message::setRequestUrl().
+  Enables joining path and query, sanitizing path, multibyte/unicode, international domain names and transient percent encoding.
 
 ## Properties: