X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http%2FUrl.md;h=0c8aa8dd0b04a64b9cec6c90476cc6788ce99392;hb=HEAD;hp=71d41e111b6613b74457df07a607bae86f1cb016;hpb=594e4eea4c360ce54300e9f6030a715bc52b0029;p=mdref%2Fmdref-http diff --git a/http/Url.md b/http/Url.md index 71d41e1..0c8aa8d 100644 --- a/http/Url.md +++ b/http/Url.md @@ -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:
http\Url::PARSE_MBUTF8,
http\Url::PARSE_MBLOC (on systems with wide character support),
http\Url::PARSE_TOPCT,
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: