X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=http%2FUrl.md;h=71d41e111b6613b74457df07a607bae86f1cb016;hb=280e2cd3c237e14c6b8659cd4e7c604dbe5e9ec6;hp=b9ef47f11586b36c53bcf9bfc7f048834a39efd9;hpb=95e046983749327a4f1271b99badaae7a838ec67;p=mdref%2Fmdref-http diff --git a/http/Url.md b/http/Url.md index b9ef47f..71d41e1 100644 --- a/http/Url.md +++ b/http/Url.md @@ -2,6 +2,20 @@ 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 @@ -30,23 +44,30 @@ The http\Url class provides versatile means to parse, construct and manipulate U Import initial URL parts from the SAPI environment. * SANITIZE_PATH Whether to sanitize the URL path (consolidate double slashes, directory jumps etc.) - +* PARSE_MBUTF8 + Parse UTF-8 encododed 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_TOPCT + Percent encode multibyte sequences in the userinfo, path, query and fragment parts of the URL. ## Properties: -* public $scheme = NULL +* public string $scheme = NULL The URL's scheme. -* public $user = NULL +* public string $user = NULL Authenticating user. -* public $pass = NULL +* public string $pass = NULL Authentication password. -* public $host = NULL +* public string $host = NULL Hostname/domain. -* public $port = NULL +* public string $port = NULL Port. -* public $path = NULL +* public string $path = NULL URL path. -* public $query = NULL +* public string $query = NULL URL querystring. -* public $fragment = NULL +* public string $fragment = NULL URL fragment (hash).