From d79195000ceb7567db8a6f1f3cb3716708bd6c7e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Thu, 26 Feb 2026 21:44:57 +0100 Subject: [PATCH 1/5] Document ext/uri Co-authored-by: Jordi Kroon --- appendices/extensions.xml | 2 + reference/uri/book.xml | 52 ++++++++ reference/uri/rfc3986/uri/construct.xml | 80 ++++++++++++ reference/uri/rfc3986/uri/debuginfo.xml | 58 +++++++++ reference/uri/rfc3986/uri/equals.xml | 103 +++++++++++++++ reference/uri/rfc3986/uri/getfragment.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/gethost.xml | 86 +++++++++++++ reference/uri/rfc3986/uri/getpassword.xml | 88 +++++++++++++ reference/uri/rfc3986/uri/getpath.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getport.xml | 84 ++++++++++++ reference/uri/rfc3986/uri/getquery.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getrawfragment.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getrawhost.xml | 86 +++++++++++++ reference/uri/rfc3986/uri/getrawpassword.xml | 88 +++++++++++++ reference/uri/rfc3986/uri/getrawpath.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getrawquery.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getrawscheme.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getrawuserinfo.xml | 88 +++++++++++++ reference/uri/rfc3986/uri/getrawusername.xml | 87 +++++++++++++ reference/uri/rfc3986/uri/getscheme.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/getuserinfo.xml | 90 +++++++++++++ reference/uri/rfc3986/uri/getusername.xml | 88 +++++++++++++ reference/uri/rfc3986/uri/parse.xml | 110 ++++++++++++++++ reference/uri/rfc3986/uri/resolve.xml | 101 +++++++++++++++ reference/uri/rfc3986/uri/serialize.xml | 60 +++++++++ reference/uri/rfc3986/uri/torawstring.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/tostring.xml | 85 +++++++++++++ reference/uri/rfc3986/uri/unserialize.xml | 82 ++++++++++++ reference/uri/rfc3986/uri/withfragment.xml | 101 +++++++++++++++ reference/uri/rfc3986/uri/withhost.xml | 102 +++++++++++++++ reference/uri/rfc3986/uri/withpath.xml | 102 +++++++++++++++ reference/uri/rfc3986/uri/withport.xml | 101 +++++++++++++++ reference/uri/rfc3986/uri/withquery.xml | 102 +++++++++++++++ reference/uri/rfc3986/uri/withscheme.xml | 102 +++++++++++++++ reference/uri/rfc3986/uri/withuserinfo.xml | 107 ++++++++++++++++ reference/uri/uri.invaliduriexception.xml | 61 +++++++++ reference/uri/uri.rfc3986.uri.xml | 53 ++++++++ reference/uri/uri.urierror.xml | 61 +++++++++ reference/uri/uri.uriexception.xml | 61 +++++++++ .../uri/uri.whatwg.invalidurlexception.xml | 71 +++++++++++ reference/uri/uri.whatwg.url.xml | 53 ++++++++ .../uri/uri.whatwg.urlvalidationerror.xml | 67 ++++++++++ reference/uri/versions.xml | 107 ++++++++++++++++ .../whatwg/invalidurlexception/construct.xml | 80 ++++++++++++ reference/uri/whatwg/url/construct.xml | 90 +++++++++++++ reference/uri/whatwg/url/debuginfo.xml | 61 +++++++++ reference/uri/whatwg/url/equals.xml | 103 +++++++++++++++ reference/uri/whatwg/url/getasciihost.xml | 85 +++++++++++++ reference/uri/whatwg/url/getfragment.xml | 85 +++++++++++++ reference/uri/whatwg/url/getpassword.xml | 85 +++++++++++++ reference/uri/whatwg/url/getpath.xml | 85 +++++++++++++ reference/uri/whatwg/url/getport.xml | 84 ++++++++++++ reference/uri/whatwg/url/getquery.xml | 85 +++++++++++++ reference/uri/whatwg/url/getscheme.xml | 85 +++++++++++++ reference/uri/whatwg/url/getunicodehost.xml | 86 +++++++++++++ reference/uri/whatwg/url/getusername.xml | 85 +++++++++++++ reference/uri/whatwg/url/parse.xml | 120 ++++++++++++++++++ reference/uri/whatwg/url/resolve.xml | 111 ++++++++++++++++ reference/uri/whatwg/url/serialize.xml | 59 +++++++++ reference/uri/whatwg/url/toasciistring.xml | 86 +++++++++++++ reference/uri/whatwg/url/tounicodestring.xml | 86 +++++++++++++ reference/uri/whatwg/url/unserialize.xml | 80 ++++++++++++ reference/uri/whatwg/url/withfragment.xml | 101 +++++++++++++++ reference/uri/whatwg/url/withhost.xml | 102 +++++++++++++++ reference/uri/whatwg/url/withpassword.xml | 102 +++++++++++++++ reference/uri/whatwg/url/withpath.xml | 101 +++++++++++++++ reference/uri/whatwg/url/withport.xml | 101 +++++++++++++++ reference/uri/whatwg/url/withquery.xml | 101 +++++++++++++++ reference/uri/whatwg/url/withscheme.xml | 101 +++++++++++++++ reference/uri/whatwg/url/withusername.xml | 103 +++++++++++++++ .../whatwg/urlvalidationerror/construct.xml | 70 ++++++++++ 71 files changed, 6057 insertions(+) create mode 100644 reference/uri/book.xml create mode 100644 reference/uri/rfc3986/uri/construct.xml create mode 100644 reference/uri/rfc3986/uri/debuginfo.xml create mode 100644 reference/uri/rfc3986/uri/equals.xml create mode 100644 reference/uri/rfc3986/uri/getfragment.xml create mode 100644 reference/uri/rfc3986/uri/gethost.xml create mode 100644 reference/uri/rfc3986/uri/getpassword.xml create mode 100644 reference/uri/rfc3986/uri/getpath.xml create mode 100644 reference/uri/rfc3986/uri/getport.xml create mode 100644 reference/uri/rfc3986/uri/getquery.xml create mode 100644 reference/uri/rfc3986/uri/getrawfragment.xml create mode 100644 reference/uri/rfc3986/uri/getrawhost.xml create mode 100644 reference/uri/rfc3986/uri/getrawpassword.xml create mode 100644 reference/uri/rfc3986/uri/getrawpath.xml create mode 100644 reference/uri/rfc3986/uri/getrawquery.xml create mode 100644 reference/uri/rfc3986/uri/getrawscheme.xml create mode 100644 reference/uri/rfc3986/uri/getrawuserinfo.xml create mode 100644 reference/uri/rfc3986/uri/getrawusername.xml create mode 100644 reference/uri/rfc3986/uri/getscheme.xml create mode 100644 reference/uri/rfc3986/uri/getuserinfo.xml create mode 100644 reference/uri/rfc3986/uri/getusername.xml create mode 100644 reference/uri/rfc3986/uri/parse.xml create mode 100644 reference/uri/rfc3986/uri/resolve.xml create mode 100644 reference/uri/rfc3986/uri/serialize.xml create mode 100644 reference/uri/rfc3986/uri/torawstring.xml create mode 100644 reference/uri/rfc3986/uri/tostring.xml create mode 100644 reference/uri/rfc3986/uri/unserialize.xml create mode 100644 reference/uri/rfc3986/uri/withfragment.xml create mode 100644 reference/uri/rfc3986/uri/withhost.xml create mode 100644 reference/uri/rfc3986/uri/withpath.xml create mode 100644 reference/uri/rfc3986/uri/withport.xml create mode 100644 reference/uri/rfc3986/uri/withquery.xml create mode 100644 reference/uri/rfc3986/uri/withscheme.xml create mode 100644 reference/uri/rfc3986/uri/withuserinfo.xml create mode 100644 reference/uri/uri.invaliduriexception.xml create mode 100644 reference/uri/uri.rfc3986.uri.xml create mode 100644 reference/uri/uri.urierror.xml create mode 100644 reference/uri/uri.uriexception.xml create mode 100644 reference/uri/uri.whatwg.invalidurlexception.xml create mode 100644 reference/uri/uri.whatwg.url.xml create mode 100644 reference/uri/uri.whatwg.urlvalidationerror.xml create mode 100644 reference/uri/versions.xml create mode 100644 reference/uri/whatwg/invalidurlexception/construct.xml create mode 100644 reference/uri/whatwg/url/construct.xml create mode 100644 reference/uri/whatwg/url/debuginfo.xml create mode 100644 reference/uri/whatwg/url/equals.xml create mode 100644 reference/uri/whatwg/url/getasciihost.xml create mode 100644 reference/uri/whatwg/url/getfragment.xml create mode 100644 reference/uri/whatwg/url/getpassword.xml create mode 100644 reference/uri/whatwg/url/getpath.xml create mode 100644 reference/uri/whatwg/url/getport.xml create mode 100644 reference/uri/whatwg/url/getquery.xml create mode 100644 reference/uri/whatwg/url/getscheme.xml create mode 100644 reference/uri/whatwg/url/getunicodehost.xml create mode 100644 reference/uri/whatwg/url/getusername.xml create mode 100644 reference/uri/whatwg/url/parse.xml create mode 100644 reference/uri/whatwg/url/resolve.xml create mode 100644 reference/uri/whatwg/url/serialize.xml create mode 100644 reference/uri/whatwg/url/toasciistring.xml create mode 100644 reference/uri/whatwg/url/tounicodestring.xml create mode 100644 reference/uri/whatwg/url/unserialize.xml create mode 100644 reference/uri/whatwg/url/withfragment.xml create mode 100644 reference/uri/whatwg/url/withhost.xml create mode 100644 reference/uri/whatwg/url/withpassword.xml create mode 100644 reference/uri/whatwg/url/withpath.xml create mode 100644 reference/uri/whatwg/url/withport.xml create mode 100644 reference/uri/whatwg/url/withquery.xml create mode 100644 reference/uri/whatwg/url/withscheme.xml create mode 100644 reference/uri/whatwg/url/withusername.xml create mode 100644 reference/uri/whatwg/urlvalidationerror/construct.xml diff --git a/appendices/extensions.xml b/appendices/extensions.xml index 3434c95e8c14..28202c591c88 100644 --- a/appendices/extensions.xml +++ b/appendices/extensions.xml @@ -163,6 +163,7 @@ + @@ -228,6 +229,7 @@ + diff --git a/reference/uri/book.xml b/reference/uri/book.xml new file mode 100644 index 000000000000..39425695e8df --- /dev/null +++ b/reference/uri/book.xml @@ -0,0 +1,52 @@ + + + + URI + URI + + + &reftitle.intro; + + This chapter describes the functions that allow you to work with + Uniform Resource Identifiers (URIs). A URI is a string of characters + used to identify a resource. URIs are used in web technologies to + identify resources on the Internet. + + + URI implements RFC 3986, Uniform Resource Identifier (URI): Generic Syntax, + which can be found at http://www.ietf.org/rfc/rfc3986.txt. + And WHATWG URL Standard, which can be found at + https://url.spec.whatwg.org/. + + + + &reference.uri.uri.invaliduriexception; + &reference.uri.uri.urierror; + &reference.uri.uri.uriexception; + + &reference.uri.uri.rfc3986.uri; + + &reference.uri.uri.whatwg.invalidurlexception; + &reference.uri.uri.whatwg.url; + &reference.uri.uri.whatwg.urlvalidationerror; + + diff --git a/reference/uri/rfc3986/uri/construct.xml b/reference/uri/rfc3986/uri/construct.xml new file mode 100644 index 000000000000..7d679fe34415 --- /dev/null +++ b/reference/uri/rfc3986/uri/construct.xml @@ -0,0 +1,80 @@ + + + + Uri\Rfc3986\Uri::__construct + Construct the Uri object + + + + &reftitle.description; + + public Uri\Rfc3986\Uri::__construct + stringuri + Uri\Rfc3986\UrinullbaseUrl&null; + + + Constructs the Uri\Rfc3986\Uri object. + + + + + &reftitle.parameters; + + + uri + + + URI to parse. + + + + + baseUrl + + + When a &string; is passed, uri is applied on + baseUrl, if uri is a relative reference. + If either &null; is passed, or uri is a not a relative reference, then + baseUrl doesn't have any effect. + + + + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::parse + Uri\WhatWg\Url::__construct + + + + + diff --git a/reference/uri/rfc3986/uri/debuginfo.xml b/reference/uri/rfc3986/uri/debuginfo.xml new file mode 100644 index 000000000000..9b1c67ba18c7 --- /dev/null +++ b/reference/uri/rfc3986/uri/debuginfo.xml @@ -0,0 +1,58 @@ + + + + Uri\Rfc3986\Uri::__debugInfo + Return the internal state of the URI + + + + &reftitle.description; + + public arrayUri\Rfc3986\Uri::__debugInfo + + + + Returns the internal state of the URI. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the internal state of the URI as an &array;. + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__debugInfo + + + + + diff --git a/reference/uri/rfc3986/uri/equals.xml b/reference/uri/rfc3986/uri/equals.xml new file mode 100644 index 000000000000..3db9e5eb1388 --- /dev/null +++ b/reference/uri/rfc3986/uri/equals.xml @@ -0,0 +1,103 @@ + + + + Uri\Rfc3986\Uri::equals + Check if two URIs are equivalent + + + + &reftitle.description; + + public boolUri\Rfc3986\Uri::equals + Uri\Rfc3986\Uriuri + Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + uri + + + URI to compare the current URI against. + + + + + comparisonMode + + + Description. + + + + + + + + &reftitle.returnvalues; + + Returns &true; if the two URIs are equivalent, or &false; otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::equals</methodname> example + + Description. + + +equals($uri2)); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::equals + + + + + diff --git a/reference/uri/rfc3986/uri/getfragment.xml b/reference/uri/rfc3986/uri/getfragment.xml new file mode 100644 index 000000000000..24c190a0dc36 --- /dev/null +++ b/reference/uri/rfc3986/uri/getfragment.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getFragment + Retrieve the normalized fragment component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getFragment + + + + Retrieves the normalized fragment component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized fragment component as a &string; if the fragment component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getFragment</methodname> example + + Description. + + +getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawFragment + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + + diff --git a/reference/uri/rfc3986/uri/gethost.xml b/reference/uri/rfc3986/uri/gethost.xml new file mode 100644 index 000000000000..5c5c411d5a25 --- /dev/null +++ b/reference/uri/rfc3986/uri/gethost.xml @@ -0,0 +1,86 @@ + + + + Uri\Rfc3986\Uri::getHost + Retrieve the normalized host component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getHost + + + + Retrieves the normalized host component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized host component as a &string; if the host component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getHost</methodname> example + + Description. + + +getHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::withHost + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + + + + + diff --git a/reference/uri/rfc3986/uri/getpassword.xml b/reference/uri/rfc3986/uri/getpassword.xml new file mode 100644 index 000000000000..119607cf0f48 --- /dev/null +++ b/reference/uri/rfc3986/uri/getpassword.xml @@ -0,0 +1,88 @@ + + + + Uri\Rfc3986\Uri::getPassword + >Retrieve the normalized password + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getPassword + + + + Retrieves the normalized password part (the text after the first : character) + from the userinfo component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized password as a &string; if the userinfo component contains a : character. + An empty string is returned when the userinfo component doesn't contain a : character. + &null; is returned when the userinfo component doesn't exist. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getPassword</methodname> example + + Description. + + +getPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::withPassword + Uri\WhatWg\Url::getPassword + + + + + diff --git a/reference/uri/rfc3986/uri/getpath.xml b/reference/uri/rfc3986/uri/getpath.xml new file mode 100644 index 000000000000..abfbc11e0622 --- /dev/null +++ b/reference/uri/rfc3986/uri/getpath.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getPath + >Retrieve the normalized path component + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::getPath + + + + Retrieves the normalized path component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized path component as a &string;. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getPath</methodname> example + + Description. + + +getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawPath + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + + diff --git a/reference/uri/rfc3986/uri/getport.xml b/reference/uri/rfc3986/uri/getport.xml new file mode 100644 index 000000000000..db950ee725b0 --- /dev/null +++ b/reference/uri/rfc3986/uri/getport.xml @@ -0,0 +1,84 @@ + + + + Uri\Rfc3986\Uri::getPort + >Retrieve the normalized port component + + + + &reftitle.description; + + public intnullUri\Rfc3986\Uri::getPort + + + + Retrieves the normalized port component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized port component as an ∫ if the port component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getPort</methodname> example + + Description. + + +getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withPort + Uri\WhatWg\Url::getPort + + + + + diff --git a/reference/uri/rfc3986/uri/getquery.xml b/reference/uri/rfc3986/uri/getquery.xml new file mode 100644 index 000000000000..6a48751a0ea4 --- /dev/null +++ b/reference/uri/rfc3986/uri/getquery.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getQuery + >Retrieve the normalized query component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getQuery + + + + Retrieves the normalized query component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized query component as a &string; if the query component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getQuery</methodname> example + + Description. + + +getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + + diff --git a/reference/uri/rfc3986/uri/getrawfragment.xml b/reference/uri/rfc3986/uri/getrawfragment.xml new file mode 100644 index 000000000000..9d6618ee24b5 --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawfragment.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getRawFragment + >Retrieve the raw fragment component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawFragment + + + + Retrieves the raw (non-normalized) fragment component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw fragment component as a &string; if the fragment component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawFragment</methodname> example + + Description. + + +getRawFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getFragment + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + + diff --git a/reference/uri/rfc3986/uri/getrawhost.xml b/reference/uri/rfc3986/uri/getrawhost.xml new file mode 100644 index 000000000000..520d9ae893db --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawhost.xml @@ -0,0 +1,86 @@ + + + + Uri\Rfc3986\Uri::getRawHost + Retrieve the raw host component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawHost + + + + Retrieves the raw (non-normalized) host component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw host component as a &string; if the host component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawHost</methodname> example + + Description. + + +getRawHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getHost + Uri\Rfc3986\Uri::withHost + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + + + + + diff --git a/reference/uri/rfc3986/uri/getrawpassword.xml b/reference/uri/rfc3986/uri/getrawpassword.xml new file mode 100644 index 000000000000..ecff17d10904 --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawpassword.xml @@ -0,0 +1,88 @@ + + + + Uri\Rfc3986\Uri::getRawPassword + Retrieve the raw password + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawPassword + + + + Retrieves the raw (non-normalized) password part (the text after the first : character) + from the userinfo component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw (non-normalized) password as a &string; if the userinfo component contains a : character. + An empty string is returned when the userinfo component doesn't contain a : character. + &null; is returned when the userinfo component doesn't exist. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawPassword</methodname> example + + Description. + + +getRawPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getPassword + + + + + diff --git a/reference/uri/rfc3986/uri/getrawpath.xml b/reference/uri/rfc3986/uri/getrawpath.xml new file mode 100644 index 000000000000..df9d8f1eece9 --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawpath.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getRawPath + Retrieve the raw path component + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::getRawPath + + + + Retrieves the raw (non-normalized) path component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw path component as a &string;. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawPath</methodname> example + + Description. + + +getRawPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPath + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + + diff --git a/reference/uri/rfc3986/uri/getrawquery.xml b/reference/uri/rfc3986/uri/getrawquery.xml new file mode 100644 index 000000000000..88f10e7bf62a --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawquery.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getRawQuery + Retrieve the raw query component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawQuery + + + + Retrieves the raw (non-normalized) query component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw query component as a &string; if the query component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawQuery</methodname> example + + Description. + + +getRawQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getQuery + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + + diff --git a/reference/uri/rfc3986/uri/getrawscheme.xml b/reference/uri/rfc3986/uri/getrawscheme.xml new file mode 100644 index 000000000000..f9f22b45d6e3 --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawscheme.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getRawScheme + Retrieve the raw scheme component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawScheme + + + + Retrieves the raw (non-normalized) scheme component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw scheme component as a &string; if the scheme component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawScheme</methodname> example + + Description. + + +getRawScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getScheme + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + + diff --git a/reference/uri/rfc3986/uri/getrawuserinfo.xml b/reference/uri/rfc3986/uri/getrawuserinfo.xml new file mode 100644 index 000000000000..1cbef49976a5 --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawuserinfo.xml @@ -0,0 +1,88 @@ + + + + Uri\Rfc3986\Uri::getRawUserInfo + Retrieve the raw userinfo component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawUserInfo + + + + Retrieves the raw (non-normalized) userinfo component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw userinfo component as a &string; if the userinfo component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawUserInfo</methodname> example + + Description. + + +getRawUserInfo(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + + + + + diff --git a/reference/uri/rfc3986/uri/getrawusername.xml b/reference/uri/rfc3986/uri/getrawusername.xml new file mode 100644 index 000000000000..3de1f921adaf --- /dev/null +++ b/reference/uri/rfc3986/uri/getrawusername.xml @@ -0,0 +1,87 @@ + + + + Uri\Rfc3986\Uri::getRawUsername + Retrieve the raw username + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawUsername + + + + Retrieves the raw (non-normalized) username part (the text before the first : character) + from userinfo component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the raw (non-normalized) username as a &string; if the userinfo component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getRawUsername</methodname> example + + Description. + + +getRawUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + + + + + diff --git a/reference/uri/rfc3986/uri/getscheme.xml b/reference/uri/rfc3986/uri/getscheme.xml new file mode 100644 index 000000000000..dc379892de0f --- /dev/null +++ b/reference/uri/rfc3986/uri/getscheme.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::getScheme + Retrieve the normalized scheme component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getScheme + + + + Retrieves the normalized scheme component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized scheme component as a &string; if the scheme component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getScheme</methodname> example + + Description. + + +getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + + diff --git a/reference/uri/rfc3986/uri/getuserinfo.xml b/reference/uri/rfc3986/uri/getuserinfo.xml new file mode 100644 index 000000000000..32bdc3143f82 --- /dev/null +++ b/reference/uri/rfc3986/uri/getuserinfo.xml @@ -0,0 +1,90 @@ + + + + Uri\Rfc3986\Uri::getUserInfo + Retrieve the normalized userinfo component + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getUserInfo + + + + Retrieves the normalized userinfo component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized userinfo component as a &string; if the userinfo component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getUserInfo</methodname> example + + Description. + + +getUserInfo(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + + + + + diff --git a/reference/uri/rfc3986/uri/getusername.xml b/reference/uri/rfc3986/uri/getusername.xml new file mode 100644 index 000000000000..727571d8ad01 --- /dev/null +++ b/reference/uri/rfc3986/uri/getusername.xml @@ -0,0 +1,88 @@ + + + + Uri\Rfc3986\Uri::getUsername + Retrieve the normalized username + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getUsername + + + + Retrieves the normalized username part (the text before the first : character) + from the userinfo component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the normalized username as a &string; if the userinfo component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::getUsername</methodname> example + + Description. + + +getUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + + + + + diff --git a/reference/uri/rfc3986/uri/parse.xml b/reference/uri/rfc3986/uri/parse.xml new file mode 100644 index 000000000000..3216a9c93e01 --- /dev/null +++ b/reference/uri/rfc3986/uri/parse.xml @@ -0,0 +1,110 @@ + + + + Uri\Rfc3986\Uri::parse + Parse a URI + + + + &reftitle.description; + + public static staticnullUri\Rfc3986\Uri::parse + stringuri + Uri\Rfc3986\UrinullbaseUrl&null; + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + uri + + + URI to parse. + + + + + baseUrl + + + When a &string; is passed, uri is applied on + baseUrl, if uri is a relative reference. + If either &null; is passed, or uri is a not a relative reference, then + baseUrl doesn't have any effect. + + + + + + + + &reftitle.returnvalues; + + Returns a Uri\Rfc3986\Uri instance on success, or &null; on failure. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::parse</methodname> example + + Description. + + +toString(); +} +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__construct + Uri\WhatWg\Url::parse + + + + + diff --git a/reference/uri/rfc3986/uri/resolve.xml b/reference/uri/rfc3986/uri/resolve.xml new file mode 100644 index 000000000000..23a9b4188b1d --- /dev/null +++ b/reference/uri/rfc3986/uri/resolve.xml @@ -0,0 +1,101 @@ + + + + Uri\Rfc3986\Uri::resolve + Resolve a reference + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::resolve + stringuri + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + uri + + + A URI to apply on top of the current URI. + + + + + + + + &reftitle.returnvalues; + + A new Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::resolve</methodname> example + + Description. + + +resolve("/foo"); + +echo $uri->toString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::resolve + + + + + diff --git a/reference/uri/rfc3986/uri/serialize.xml b/reference/uri/rfc3986/uri/serialize.xml new file mode 100644 index 000000000000..8bcbcb69c9fa --- /dev/null +++ b/reference/uri/rfc3986/uri/serialize.xml @@ -0,0 +1,60 @@ + + + + Uri\Rfc3986\Uri::__serialize + Serialize the Uri object + + + + &reftitle.description; + + public arrayUri\Rfc3986\Uri::__serialize + + + + Serializes the Uri\Rfc3986\Uri object. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the serialized URI as a &string;. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__unserialize + Uri\WhatWg\Url::__serialize + Uri\WhatWg\Url::__unserialize + + + + + diff --git a/reference/uri/rfc3986/uri/torawstring.xml b/reference/uri/rfc3986/uri/torawstring.xml new file mode 100644 index 000000000000..fc499b1b8b8d --- /dev/null +++ b/reference/uri/rfc3986/uri/torawstring.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::toRawString + Recompose the raw URI + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::toRawString + + + + Recomposes the raw (non-normalized) URI to a &string;. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the recomposed raw (non-normalized) URI as a &string;. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::toRawString</methodname> example + + Description. + + +toString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toString + Uri\WhatWg\Url::toAsciiString + Uri\WhatWg\Url::toUnicodeString + + + + + diff --git a/reference/uri/rfc3986/uri/tostring.xml b/reference/uri/rfc3986/uri/tostring.xml new file mode 100644 index 000000000000..6aa4ba145b3c --- /dev/null +++ b/reference/uri/rfc3986/uri/tostring.xml @@ -0,0 +1,85 @@ + + + + Uri\Rfc3986\Uri::toString + Recompose the normalized URI + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::toString + + + + Recomposes the normalized URI to a &string;. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the recomposed normalized URI as a &string;. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::toString</methodname> example + + Description. + + +toString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toRawString + Uri\WhatWg\Url::toAsciiString + Uri\WhatWg\Url::toUnicodeString + + + + + diff --git a/reference/uri/rfc3986/uri/unserialize.xml b/reference/uri/rfc3986/uri/unserialize.xml new file mode 100644 index 000000000000..956776338303 --- /dev/null +++ b/reference/uri/rfc3986/uri/unserialize.xml @@ -0,0 +1,82 @@ + + + + Uri\Rfc3986\Uri::__unserialize + Deserialize the data parameter into a Uri object + + + + &reftitle.description; + + public voidUri\Rfc3986\Uri::__unserialize + arraydata + + &warn.undocumented.func; + + Deserializes a data parameter into a Uri\Rfc3986\Uri object. + + + + + &reftitle.parameters; + + + data + + + The serialized data as an array. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + If the __unserialize method is called on an already existing URI, Error + is thrown. + + + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__serialize + Uri\WhatWg\Url::__serialize + Uri\WhatWg\Url::__unserialize + + + + + diff --git a/reference/uri/rfc3986/uri/withfragment.xml b/reference/uri/rfc3986/uri/withfragment.xml new file mode 100644 index 000000000000..1841f8ebc2f5 --- /dev/null +++ b/reference/uri/rfc3986/uri/withfragment.xml @@ -0,0 +1,101 @@ + + + + Uri\Rfc3986\Uri::withFragment + Modify the fragment component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withFragment + stringnullfragment + + + Creates a new URI and modifies its fragment component. + + + + + &reftitle.parameters; + + + fragment + + + New fragment component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withFragment</methodname> example + + Description. + + +withFragment("bar"); + +echo $uri->getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getFragment + Uri\Rfc3986\Uri::getRawFragment + Uri\WhatWg\Url::withFragment + + + + + diff --git a/reference/uri/rfc3986/uri/withhost.xml b/reference/uri/rfc3986/uri/withhost.xml new file mode 100644 index 000000000000..d2c9a4b04353 --- /dev/null +++ b/reference/uri/rfc3986/uri/withhost.xml @@ -0,0 +1,102 @@ + + + + Uri\Rfc3986\Uri::withHost + Modify the host component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withHost + stringnullhost + + + Creates a new URI and modifies its host component. + + + + + &reftitle.parameters; + + + host + + + New host component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withHost</methodname> example + + Description. + + +withHost("example.net"); + +echo $uri->getHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getHost + Uri\Rfc3986\Uri::getRawHost + Uri\WhatWg\Url::withHost + + + + + diff --git a/reference/uri/rfc3986/uri/withpath.xml b/reference/uri/rfc3986/uri/withpath.xml new file mode 100644 index 000000000000..9803751161a1 --- /dev/null +++ b/reference/uri/rfc3986/uri/withpath.xml @@ -0,0 +1,102 @@ + + + + Uri\Rfc3986\Uri::withPath + Modify the path component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withPath + stringpath + + + Creates a new URI and modifies its path component. + + + + + &reftitle.parameters; + + + path + + + New path component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withPath</methodname> example + + Description. + + +withPath("/baz"); + +echo $uri->getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPath + Uri\Rfc3986\Uri::getRawPath + Uri\WhatWg\Url::withPath + + + + + diff --git a/reference/uri/rfc3986/uri/withport.xml b/reference/uri/rfc3986/uri/withport.xml new file mode 100644 index 000000000000..aa412fbaa42b --- /dev/null +++ b/reference/uri/rfc3986/uri/withport.xml @@ -0,0 +1,101 @@ + + + + Uri\Rfc3986\Uri::withPort + Modify the port component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withPort + intnullport + + + Creates a new URI and modifies its port component. + + + + + &reftitle.parameters; + + + port + + + New port component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withPort</methodname> example + + Description. + + +withPort(443); + +echo $uri->getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPort + Uri\WhatWg\Url::withPort + + + + + diff --git a/reference/uri/rfc3986/uri/withquery.xml b/reference/uri/rfc3986/uri/withquery.xml new file mode 100644 index 000000000000..0d3011dd8062 --- /dev/null +++ b/reference/uri/rfc3986/uri/withquery.xml @@ -0,0 +1,102 @@ + + + + Uri\Rfc3986\Uri::withQuery + Modify the query component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withQuery + stringnullquery + + + Creates a new URI and modifies its query component. + + + + + &reftitle.parameters; + + + query + + + New query component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withQuery</methodname> example + + Description. + + +withQuery("foo=baz"); + +echo $uri->getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::getQuery + Uri\WhatWg\Url::withQuery + + + + + diff --git a/reference/uri/rfc3986/uri/withscheme.xml b/reference/uri/rfc3986/uri/withscheme.xml new file mode 100644 index 000000000000..b74b4f2eb546 --- /dev/null +++ b/reference/uri/rfc3986/uri/withscheme.xml @@ -0,0 +1,102 @@ + + + + Uri\Rfc3986\Uri::withScheme + Modify the scheme component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withScheme + stringnullscheme + + + Creates a new URI and modifies its scheme component. + + + + + &reftitle.parameters; + + + scheme + + + New scheme component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withScheme</methodname> example + + Description. + + +withScheme("http"); + +echo $uri->getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::getScheme + Uri\WhatWg\Url::withScheme + + + + + diff --git a/reference/uri/rfc3986/uri/withuserinfo.xml b/reference/uri/rfc3986/uri/withuserinfo.xml new file mode 100644 index 000000000000..a7be6b164617 --- /dev/null +++ b/reference/uri/rfc3986/uri/withuserinfo.xml @@ -0,0 +1,107 @@ + + + + Uri\Rfc3986\Uri::withUserInfo + Modify the userinfo component + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withUserInfo + #[\SensitiveParameter]stringnulluserinfo + + + Creates a new URI and modifies its userinfo component. + + + + + &reftitle.parameters; + + + userinfo + + + New userinfo component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\Rfc3986\Uri instance. + + + + + &reftitle.errors; + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\Rfc3986\Uri::withUserInfo</methodname> example + + Description. + + +withUserInfo("userinfo"); + +echo $uri->getUserInfo(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getPassword + Uri\WhatWg\Url::withUsername + Uri\WhatWg\Url::withPassword + + + + + diff --git a/reference/uri/uri.invaliduriexception.xml b/reference/uri/uri.invaliduriexception.xml new file mode 100644 index 000000000000..1b6d326ba8a7 --- /dev/null +++ b/reference/uri/uri.invaliduriexception.xml @@ -0,0 +1,61 @@ + + + The Uri\InvalidUriException class + Uri\InvalidUriException + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + Uri\InvalidUriException + + + + extends + Uri\UriException + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + +
+ + + diff --git a/reference/uri/uri.rfc3986.uri.xml b/reference/uri/uri.rfc3986.uri.xml new file mode 100644 index 000000000000..bbe59fe47a1c --- /dev/null +++ b/reference/uri/uri.rfc3986.uri.xml @@ -0,0 +1,53 @@ + + + The Uri\Rfc3986\Uri class + Uri\Rfc3986\Uri + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + final + readonly + Uri\Rfc3986\Uri + + + &Methods; + + + + + + + +
+ + + diff --git a/reference/uri/uri.urierror.xml b/reference/uri/uri.urierror.xml new file mode 100644 index 000000000000..05eba02f3460 --- /dev/null +++ b/reference/uri/uri.urierror.xml @@ -0,0 +1,61 @@ + + + The Uri\UriError class + Uri\UriError + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + Uri\UriError + + + + extends + Error + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + +
+ + + diff --git a/reference/uri/uri.uriexception.xml b/reference/uri/uri.uriexception.xml new file mode 100644 index 000000000000..0ead27d60c81 --- /dev/null +++ b/reference/uri/uri.uriexception.xml @@ -0,0 +1,61 @@ + + + The Uri\UriException class + Uri\UriException + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + Uri\UriException + + + + extends + Exception + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + +
+ + + diff --git a/reference/uri/uri.whatwg.invalidurlexception.xml b/reference/uri/uri.whatwg.invalidurlexception.xml new file mode 100644 index 000000000000..f1bd5035cbb2 --- /dev/null +++ b/reference/uri/uri.whatwg.invalidurlexception.xml @@ -0,0 +1,71 @@ + + + The Uri\WhatWg\InvalidUrlException class + Uri\WhatWg\InvalidUrlException + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + Uri\WhatWg\InvalidUrlException + + + + extends + Uri\InvalidUriException + + + &Properties; + + public + readonly + array + errors + + + &InheritedProperties; + + + + + &Methods; + + + + + &InheritedMethods; + + + + +
+ + + diff --git a/reference/uri/uri.whatwg.url.xml b/reference/uri/uri.whatwg.url.xml new file mode 100644 index 000000000000..58c58d1bb7b8 --- /dev/null +++ b/reference/uri/uri.whatwg.url.xml @@ -0,0 +1,53 @@ + + + The Uri\WhatWg\Url class + Uri\WhatWg\Url + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + final + readonly + Uri\WhatWg\Url + + + &Methods; + + + + + + + +
+ + + diff --git a/reference/uri/uri.whatwg.urlvalidationerror.xml b/reference/uri/uri.whatwg.urlvalidationerror.xml new file mode 100644 index 000000000000..593539879a86 --- /dev/null +++ b/reference/uri/uri.whatwg.urlvalidationerror.xml @@ -0,0 +1,67 @@ + + + The Uri\WhatWg\UrlValidationError class + Uri\WhatWg\UrlValidationError + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + + final + readonly + Uri\WhatWg\UrlValidationError + + + &Properties; + + public + string + context + + + public + Uri\WhatWg\UrlValidationErrorType + type + + + public + bool + failure + + + &Methods; + + + + +
+ + + diff --git a/reference/uri/versions.xml b/reference/uri/versions.xml new file mode 100644 index 000000000000..445315188a7f --- /dev/null +++ b/reference/uri/versions.xml @@ -0,0 +1,107 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/reference/uri/whatwg/invalidurlexception/construct.xml b/reference/uri/whatwg/invalidurlexception/construct.xml new file mode 100644 index 000000000000..5d8ccd9cbb4b --- /dev/null +++ b/reference/uri/whatwg/invalidurlexception/construct.xml @@ -0,0 +1,80 @@ + + + + Uri\WhatWg\InvalidUrlException::__construct + Construct an InvalidUrlException object + + + + &reftitle.description; + + public Uri\WhatWg\InvalidUrlException::__construct + stringmessage"" + arrayerrors[] + intcode0 + Throwablenullprevious&null; + + &warn.undocumented.func; + + Constructs a Uri\WhatWg\InvalidUrlException object. + + + + + &reftitle.parameters; + + + message + + + Exception message. + + + + + errors + + + An &array; of Uri\WhatWg\UrlValidationError objects. + + + + + code + + + Exception code. + + + + + previous + + + The previous exception used for exception chaining. + + + + + + + diff --git a/reference/uri/whatwg/url/construct.xml b/reference/uri/whatwg/url/construct.xml new file mode 100644 index 000000000000..b96c20cf6f21 --- /dev/null +++ b/reference/uri/whatwg/url/construct.xml @@ -0,0 +1,90 @@ + + + + Uri\WhatWg\Url::__construct + Construct the Url object + + + + &reftitle.description; + + public Uri\WhatWg\Url::__construct + stringuri + Uri\WhatWg\UrlnullbaseUrl&null; + arraysoftErrors&null; + + + Constructs the Uri\Rfc3986\Uri object. + + + + + &reftitle.parameters; + + + uri + + + URI to parse. + + + + + baseUrl + + + When a &string; is passed, uri is applied on + baseUrl, if uri is a relative-URL string. + If either &null; is passed, or uri is a not a relative-URL string, then + baseUrl doesn't have any effect. + + + + + softErrors + + + An &array; to pass a list of Uri\WhatWg\UrlValidationError + instances by reference to provide extended information about the errors triggered during parsing. + + + + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__construct + Uri\WhatWg\Url::parse + + + + + diff --git a/reference/uri/whatwg/url/debuginfo.xml b/reference/uri/whatwg/url/debuginfo.xml new file mode 100644 index 000000000000..485aefa551ad --- /dev/null +++ b/reference/uri/whatwg/url/debuginfo.xml @@ -0,0 +1,61 @@ + + + + Uri\WhatWg\Url::__debugInfo + Return the internal state of the URL + + + + &reftitle.description; + + public arrayUri\WhatWg\Url::__debugInfo + + + &warn.undocumented.func; + + Returns the internal state of the URL. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the internal state of the URL as an &array;. + + + + + &reftitle.seealso; + + ClassName::otherMethodName + some_function + something appendix + + + + + diff --git a/reference/uri/whatwg/url/equals.xml b/reference/uri/whatwg/url/equals.xml new file mode 100644 index 000000000000..d9b1024bc717 --- /dev/null +++ b/reference/uri/whatwg/url/equals.xml @@ -0,0 +1,103 @@ + + + + Uri\WhatWg\Url::equals + Check if two URLs are equivalent + + + + &reftitle.description; + + public boolUri\WhatWg\Url::equals + Uri\WhatWg\Urlurl + Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + url + + + URL to compare the current URL against. + + + + + comparisonMode + + + Description. + + + + + + + + &reftitle.returnvalues; + + Returns &true; if the two URLs are equivalent, or &false; otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::equals</methodname> example + + Description. + + +equals($url2)); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::equals + + + + + diff --git a/reference/uri/whatwg/url/getasciihost.xml b/reference/uri/whatwg/url/getasciihost.xml new file mode 100644 index 000000000000..669c2c9d3acd --- /dev/null +++ b/reference/uri/whatwg/url/getasciihost.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getAsciiHost + Retrieve the host component as an ASCII &string; + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getAsciiHost + + + + Retrieves the host component as an ASCII &string;. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the host component as an ASCII &string; if the host component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getAsciiHost</methodname> example + + Description. + + +getAsciiHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getHost + Uri\Rfc3986\Uri::getRawHost + Uri\WhatWg\Url::withHost + + + + + diff --git a/reference/uri/whatwg/url/getfragment.xml b/reference/uri/whatwg/url/getfragment.xml new file mode 100644 index 000000000000..3429305e8532 --- /dev/null +++ b/reference/uri/whatwg/url/getfragment.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getFragment + Retrieve the fragment component + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getFragment + + + + Retrieves the fragment component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the fragment component as a &string; if the fragment component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getFragment</methodname> example + + Description. + + +getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getFragment + Uri\Rfc3986\Uri::getRawFragment + Uri\WhatWg\Url::withFragment + + + + + diff --git a/reference/uri/whatwg/url/getpassword.xml b/reference/uri/whatwg/url/getpassword.xml new file mode 100644 index 000000000000..7c9dee943d4d --- /dev/null +++ b/reference/uri/whatwg/url/getpassword.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getPassword + Retrieve the password component + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getPassword + + + + Retrieves the password component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the password component as a &string; if the password component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getPassword</methodname> example + + Description. + + +getPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::getRawPassword + Uri\WhatWg\Url::withPassword + + + + + diff --git a/reference/uri/whatwg/url/getpath.xml b/reference/uri/whatwg/url/getpath.xml new file mode 100644 index 000000000000..527fecef8eff --- /dev/null +++ b/reference/uri/whatwg/url/getpath.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getPath + Retrieve the path component + + + + &reftitle.description; + + public stringUri\WhatWg\Url::getPath + + + + Retrieves the path component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the path component as a &string;. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getPath</methodname> example + + Description. + + +getPath(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPath + Uri\Rfc3986\Uri::getRawPath + Uri\WhatWg\Url::withPath + + + + + diff --git a/reference/uri/whatwg/url/getport.xml b/reference/uri/whatwg/url/getport.xml new file mode 100644 index 000000000000..9cde76d75de3 --- /dev/null +++ b/reference/uri/whatwg/url/getport.xml @@ -0,0 +1,84 @@ + + + + Uri\WhatWg\Url::getPort + Retrieve the port component + + + + &reftitle.description; + + public intnullUri\WhatWg\Url::getPort + + + + Retrieves the port component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the port component as an ∫ if the port component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getPort</methodname> example + + Description. + + +getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPort + Uri\WhatWg\Url::withPort + + + + + diff --git a/reference/uri/whatwg/url/getquery.xml b/reference/uri/whatwg/url/getquery.xml new file mode 100644 index 000000000000..46f0f75c1731 --- /dev/null +++ b/reference/uri/whatwg/url/getquery.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getQuery + Retrieve the query component + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getQuery + + + + Retrieves the query component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the query component as a &string; if the query component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getQuery</methodname> example + + Description. + + +getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::getQuery + Uri\WhatWg\Url::withQuery + + + + + diff --git a/reference/uri/whatwg/url/getscheme.xml b/reference/uri/whatwg/url/getscheme.xml new file mode 100644 index 000000000000..07900f19f311 --- /dev/null +++ b/reference/uri/whatwg/url/getscheme.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getScheme + Retrieve the scheme component + + + + &reftitle.description; + + public stringUri\WhatWg\Url::getScheme + + + + Retrieves the scheme component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the scheme component as a &string; if the scheme component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getScheme</methodname> example + + Description. + + +getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::getScheme + Uri\WhatWg\Url::withScheme + + + + + diff --git a/reference/uri/whatwg/url/getunicodehost.xml b/reference/uri/whatwg/url/getunicodehost.xml new file mode 100644 index 000000000000..65c6ae566e58 --- /dev/null +++ b/reference/uri/whatwg/url/getunicodehost.xml @@ -0,0 +1,86 @@ + + + + Uri\WhatWg\Url::getUnicodeHost + Retrieve the host component as an Unicode &string; + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getUnicodeHost + + + + Retrieves the host component as an Unicode &string;. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the host component as a Unicode &string; if the host component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getUnicodeHost</methodname> example + + Description. + + +getUnicodeHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::getHost + Uri\WhatWg\Url::getUnicodeHost + Uri\WhatWg\Url::withHost + + + + + diff --git a/reference/uri/whatwg/url/getusername.xml b/reference/uri/whatwg/url/getusername.xml new file mode 100644 index 000000000000..3c1258604923 --- /dev/null +++ b/reference/uri/whatwg/url/getusername.xml @@ -0,0 +1,85 @@ + + + + Uri\WhatWg\Url::getUsername + Retrieve the username component + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getUsername + + + + Retrieves the username component. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the username component as a &string; if the username component exists, &null; is returned otherwise. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::getUsername</methodname> example + + Description. + + +getUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + Uri\WhatWg\Url::withUsername + + + + + diff --git a/reference/uri/whatwg/url/parse.xml b/reference/uri/whatwg/url/parse.xml new file mode 100644 index 000000000000..a7920e51ef16 --- /dev/null +++ b/reference/uri/whatwg/url/parse.xml @@ -0,0 +1,120 @@ + + + + Uri\WhatWg\Url::parse + Parse a URL + + + + &reftitle.description; + + public static staticnullUri\WhatWg\Url::parse + stringuri + Uri\WhatWg\UrlnullbaseUrl&null; + arrayerrors&null; + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + uri + + + URI to parse. + + + + + baseUrl + + + When a &string; is passed, uri is applied on + baseUrl, if uri is a relative-URL string. + If either &null; is passed, or uri is a not a relative-URL string, then + baseUrl doesn't have any effect. + + + + + errors + + + An &array; to pass a list of Uri\WhatWg\UrlValidationError + instances by reference to provide extended information about the errors triggered during parsing. + + + + + + + + &reftitle.returnvalues; + + Returns a Uri\WhatWg\Url instance on success, or &null; on failure. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::parse</methodname> example + + Basic example + + +toAsciiString(); +} +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::parse + Uri\WhatWg\Url::__construct + + + + + diff --git a/reference/uri/whatwg/url/resolve.xml b/reference/uri/whatwg/url/resolve.xml new file mode 100644 index 000000000000..d56f445f870d --- /dev/null +++ b/reference/uri/whatwg/url/resolve.xml @@ -0,0 +1,111 @@ + + + + Uri\WhatWg\Url::resolve + Resolve a reference + + + + &reftitle.description; + + public staticUri\WhatWg\Url::resolve + stringuri + arraysoftErrors&null; + + &warn.undocumented.func; + + Description. + + + + + &reftitle.parameters; + + + uri + + + Description. + + + + + softErrors + + + An &array; to pass a list of Uri\WhatWg\UrlValidationError + instances by reference to provide extended information about the soft errors triggered during reference resolution. + + + + + + + + &reftitle.returnvalues; + + A new Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::resolve</methodname> example + + Basic example + + +resolve("/foo"); + +echo $url->toAsciiString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::resolve + + + + + diff --git a/reference/uri/whatwg/url/serialize.xml b/reference/uri/whatwg/url/serialize.xml new file mode 100644 index 000000000000..24e6639b1759 --- /dev/null +++ b/reference/uri/whatwg/url/serialize.xml @@ -0,0 +1,59 @@ + + + + Uri\WhatWg\Url::__serialize + Serialize the Url object + + + + &reftitle.description; + + public arrayUri\WhatWg\Url::__serialize + + + + Serializes the Uri\WhatWg\Url object. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the serialized URL as an &array;. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__serialize + Uri\WhatWg\Url::__unserialize + + + + + diff --git a/reference/uri/whatwg/url/toasciistring.xml b/reference/uri/whatwg/url/toasciistring.xml new file mode 100644 index 000000000000..7b835bb1294c --- /dev/null +++ b/reference/uri/whatwg/url/toasciistring.xml @@ -0,0 +1,86 @@ + + + + Uri\WhatWg\Url::toAsciiString + Recompose the URL as an ASCII &string; + + + + &reftitle.description; + + public stringUri\WhatWg\Url::toAsciiString + + + &warn.undocumented.func; + + Recomposes the URL as an ASCII &string;. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the recomposed URL as an ASCII &string;. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::toAsciiString</methodname> example + + Description. + + +toAsciiString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toRawString + Uri\Rfc3986\Uri::toString + Uri\WhatWg\Url::toUnicodeString + + + + + diff --git a/reference/uri/whatwg/url/tounicodestring.xml b/reference/uri/whatwg/url/tounicodestring.xml new file mode 100644 index 000000000000..9c09ed60d7eb --- /dev/null +++ b/reference/uri/whatwg/url/tounicodestring.xml @@ -0,0 +1,86 @@ + + + + Uri\WhatWg\Url::toUnicodeString + Recompose the URL as a Unicode &string; + + + + &reftitle.description; + + public stringUri\WhatWg\Url::toUnicodeString + + + &warn.undocumented.func; + + Recomposes the URL as a Unicode &string;. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Returns the recomposed URL as a Unicode &string;. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::toUnicodeString</methodname> example + + Description. + + +toAsciiString(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toRawString + Uri\Rfc3986\Uri::toString + Uri\WhatWg\Url::toAsciiString + + + + + diff --git a/reference/uri/whatwg/url/unserialize.xml b/reference/uri/whatwg/url/unserialize.xml new file mode 100644 index 000000000000..0eed036a2c63 --- /dev/null +++ b/reference/uri/whatwg/url/unserialize.xml @@ -0,0 +1,80 @@ + + + + Uri\WhatWg\Url::__unserialize + Deserialize the data parameter into a Url object + + + + &reftitle.description; + + public voidUri\WhatWg\Url::__unserialize + arraydata + + + Deserializes a data parameter into a Uri\WhatWg\Url object. + + + + + &reftitle.parameters; + + + data + + + The serialized data as an array. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + If the __unserialize method is called on an already existing URL, Error + is thrown. + + + + If the resulting URI is invalid, a Uri\InvalidUriException is thrown. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__unserialize + Uri\WhatWg\Url::__serialize + + + + + diff --git a/reference/uri/whatwg/url/withfragment.xml b/reference/uri/whatwg/url/withfragment.xml new file mode 100644 index 000000000000..7fcc487f1ccd --- /dev/null +++ b/reference/uri/whatwg/url/withfragment.xml @@ -0,0 +1,101 @@ + + + + Uri\WhatWg\Url::withFragment + Modify the fragment component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withFragment + stringnullfragment + + + Creates a new URL and modifies its fragment component. + + + + + &reftitle.parameters; + + + fragment + + + New fragment component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withFragment</methodname> example + + Description. + + +withFragment("bar"); + +echo $url->getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + + diff --git a/reference/uri/whatwg/url/withhost.xml b/reference/uri/whatwg/url/withhost.xml new file mode 100644 index 000000000000..8113559b68e8 --- /dev/null +++ b/reference/uri/whatwg/url/withhost.xml @@ -0,0 +1,102 @@ + + + + Uri\WhatWg\Url::withHost + Modify the host component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withHost + stringnullhost + + + Creates a new URL and modifies its host component. + + + + + &reftitle.parameters; + + + host + + + New host component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withHost</methodname> example + + Description. + + +withHost("example.net"); + +echo $url->getHost(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withHost + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + + + + + diff --git a/reference/uri/whatwg/url/withpassword.xml b/reference/uri/whatwg/url/withpassword.xml new file mode 100644 index 000000000000..31767abea1ab --- /dev/null +++ b/reference/uri/whatwg/url/withpassword.xml @@ -0,0 +1,102 @@ + + + + Uri\WhatWg\Url::withPassword + Modify the password component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPassword + #[\SensitiveParameter]stringnullpassword + + &warn.undocumented.func; + + Creates a new URL and modifies its password component. + + + + + &reftitle.parameters; + + + password + + + New password component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withPassword</methodname> example + + Description. + + +withPassword("pass"); + +echo $url->getPassword(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getUserInfo + Uri\WhatWg\Url::getPassword + + + + + diff --git a/reference/uri/whatwg/url/withpath.xml b/reference/uri/whatwg/url/withpath.xml new file mode 100644 index 000000000000..a387668576e2 --- /dev/null +++ b/reference/uri/whatwg/url/withpath.xml @@ -0,0 +1,101 @@ + + + + Uri\WhatWg\Url::withPath + Modify the path component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPath + stringpath + + + Creates a new URL and modifies its path component. + + + + + &reftitle.parameters; + + + path + + + New path component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withPath</methodname> example + + Description. + + +with("/baz"); + +echo $url->get(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + + diff --git a/reference/uri/whatwg/url/withport.xml b/reference/uri/whatwg/url/withport.xml new file mode 100644 index 000000000000..86ab9bc12c6a --- /dev/null +++ b/reference/uri/whatwg/url/withport.xml @@ -0,0 +1,101 @@ + + + + Uri\WhatWg\Url::withPort + Modify the port component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPort + intnullport + + + Creates a new URL and modifies its port component. + + + + + &reftitle.parameters; + + + port + + + New port component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withPort</methodname> example + + Description. + + +withPort(443); + +echo $url->getPort(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withPort + Uri\WhatWg\Url::getPort + + + + + diff --git a/reference/uri/whatwg/url/withquery.xml b/reference/uri/whatwg/url/withquery.xml new file mode 100644 index 000000000000..cacb2f12d6bb --- /dev/null +++ b/reference/uri/whatwg/url/withquery.xml @@ -0,0 +1,101 @@ + + + + Uri\WhatWg\Url::withQuery + Modify the query component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withQuery + stringnullquery + + + Creates a new URL and modifies its query component. + + + + + &reftitle.parameters; + + + query + + + New query component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withQuery</methodname> example + + Description. + + +withQuery("foo=baz"); + +echo $url->getQuery(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + + diff --git a/reference/uri/whatwg/url/withscheme.xml b/reference/uri/whatwg/url/withscheme.xml new file mode 100644 index 000000000000..58f8e0f5ee5c --- /dev/null +++ b/reference/uri/whatwg/url/withscheme.xml @@ -0,0 +1,101 @@ + + + + Uri\WhatWg\Url::withScheme + Modify the scheme component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withScheme + stringscheme + + + Creates a new URL and modifies its scheme component. + + + + + &reftitle.parameters; + + + scheme + + + New scheme component. + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withScheme</methodname> example + + Description. + + +withScheme("http"); + +echo $url->getScheme(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + + diff --git a/reference/uri/whatwg/url/withusername.xml b/reference/uri/whatwg/url/withusername.xml new file mode 100644 index 000000000000..fd0a57a9d740 --- /dev/null +++ b/reference/uri/whatwg/url/withusername.xml @@ -0,0 +1,103 @@ + + + + Uri\WhatWg\Url::withUsername + Modify the username component + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withUsername + stringnullusername + + + Creates a new URL and modifies its username component. + + + + + &reftitle.parameters; + + + username + + + New username component. + + + + + + + + + &reftitle.returnvalues; + + The modified Uri\WhatWg\Url instance. + + + + + &reftitle.errors; + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + + + + + &reftitle.examples; + + <methodname>Uri\WhatWg\Url::withUsername</methodname> example + + Description. + + +withUsername("usr"); + +echo $url->getUsername(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getRawUsername + Uri\WhatWg\Url::getUsername + + + + + diff --git a/reference/uri/whatwg/urlvalidationerror/construct.xml b/reference/uri/whatwg/urlvalidationerror/construct.xml new file mode 100644 index 000000000000..ac67a065df8a --- /dev/null +++ b/reference/uri/whatwg/urlvalidationerror/construct.xml @@ -0,0 +1,70 @@ + + + + Uri\WhatWg\UrlValidationError::__construct + Construct a UrlValidationError object + + + + &reftitle.description; + + public Uri\WhatWg\UrlValidationError::__construct + stringcontext + Uri\WhatWg\UrlValidationErrorTypetype + boolfailure + + + Constructs a Uri\WhatWg\UrlValidationError object. + + + + + &reftitle.parameters; + + + context + + + Context of the error. + + + + + type + + + A Uri\WhatWg\UrlValidationErrorType instance. + + + + + failure + + + Whether the error refers to a failure, or a soft-error. + + + + + + + From e080e9c7189200ca25836cf0cd6bd4334db0d0e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A1t=C3=A9=20Kocsis?= Date: Tue, 17 Mar 2026 17:20:00 +0100 Subject: [PATCH 2/5] Address review comments --- reference/uri/rfc3986/uri/construct.xml | 2 +- reference/uri/rfc3986/uri/debuginfo.xml | 1 - reference/uri/rfc3986/uri/equals.xml | 13 +++++-------- reference/uri/rfc3986/uri/getfragment.xml | 6 +----- reference/uri/rfc3986/uri/gethost.xml | 6 +----- reference/uri/rfc3986/uri/getpassword.xml | 6 +----- reference/uri/rfc3986/uri/getpath.xml | 6 +----- reference/uri/rfc3986/uri/getport.xml | 6 +----- reference/uri/rfc3986/uri/getquery.xml | 6 +----- reference/uri/rfc3986/uri/getrawfragment.xml | 6 +----- reference/uri/rfc3986/uri/getrawhost.xml | 6 +----- reference/uri/rfc3986/uri/getrawpassword.xml | 6 +----- reference/uri/rfc3986/uri/getrawpath.xml | 6 +----- reference/uri/rfc3986/uri/getrawquery.xml | 6 +----- reference/uri/rfc3986/uri/getrawscheme.xml | 6 +----- reference/uri/rfc3986/uri/getrawuserinfo.xml | 5 +---- reference/uri/rfc3986/uri/getrawusername.xml | 6 +----- reference/uri/rfc3986/uri/getscheme.xml | 6 +----- reference/uri/rfc3986/uri/getuserinfo.xml | 8 ++------ reference/uri/rfc3986/uri/getusername.xml | 8 ++------ reference/uri/rfc3986/uri/parse.xml | 10 +++------- reference/uri/rfc3986/uri/resolve.xml | 15 ++++++--------- reference/uri/rfc3986/uri/serialize.xml | 2 -- reference/uri/rfc3986/uri/torawstring.xml | 6 +----- reference/uri/rfc3986/uri/tostring.xml | 6 +----- reference/uri/rfc3986/uri/unserialize.xml | 2 -- reference/uri/rfc3986/uri/withfragment.xml | 6 +----- reference/uri/rfc3986/uri/withhost.xml | 6 +----- reference/uri/rfc3986/uri/withpath.xml | 6 +----- reference/uri/rfc3986/uri/withport.xml | 6 +----- reference/uri/rfc3986/uri/withquery.xml | 6 +----- reference/uri/rfc3986/uri/withscheme.xml | 6 +----- reference/uri/rfc3986/uri/withuserinfo.xml | 10 +++------- reference/uri/whatwg/url/construct.xml | 4 ++-- reference/uri/whatwg/url/debuginfo.xml | 5 +---- reference/uri/whatwg/url/equals.xml | 12 +++++------- reference/uri/whatwg/url/getasciihost.xml | 11 ++++------- reference/uri/whatwg/url/getfragment.xml | 10 +++------- reference/uri/whatwg/url/getpassword.xml | 10 +++------- reference/uri/whatwg/url/getpath.xml | 10 +++------- reference/uri/whatwg/url/getport.xml | 10 +++------- reference/uri/whatwg/url/getquery.xml | 8 ++------ reference/uri/whatwg/url/getscheme.xml | 8 ++------ reference/uri/whatwg/url/getunicodehost.xml | 10 +++------- reference/uri/whatwg/url/getusername.xml | 8 ++------ reference/uri/whatwg/url/parse.xml | 12 ++++-------- reference/uri/whatwg/url/resolve.xml | 14 ++++++-------- reference/uri/whatwg/url/serialize.xml | 3 +-- reference/uri/whatwg/url/toasciistring.xml | 8 ++------ reference/uri/whatwg/url/tounicodestring.xml | 10 +++------- reference/uri/whatwg/url/unserialize.xml | 3 +-- reference/uri/whatwg/url/withfragment.xml | 8 ++------ reference/uri/whatwg/url/withhost.xml | 8 ++------ reference/uri/whatwg/url/withpassword.xml | 8 ++------ reference/uri/whatwg/url/withpath.xml | 8 ++------ reference/uri/whatwg/url/withport.xml | 8 ++------ reference/uri/whatwg/url/withquery.xml | 8 ++------ reference/uri/whatwg/url/withscheme.xml | 8 ++------ reference/uri/whatwg/url/withusername.xml | 9 ++------- .../uri/whatwg/urlvalidationerror/construct.xml | 2 +- 60 files changed, 112 insertions(+), 319 deletions(-) diff --git a/reference/uri/rfc3986/uri/construct.xml b/reference/uri/rfc3986/uri/construct.xml index 7d679fe34415..845468c7261e 100644 --- a/reference/uri/rfc3986/uri/construct.xml +++ b/reference/uri/rfc3986/uri/construct.xml @@ -53,10 +53,10 @@ &reftitle.seealso; Uri\Rfc3986\Uri::parse + Uri\Rfc3986\Uri::resolve Uri\WhatWg\Url::__construct - + + If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. + +'> + toString(); +} else { + echo "Invalid URI" } ?> ]]> diff --git a/reference/uri/rfc3986/uri/resolve.xml b/reference/uri/rfc3986/uri/resolve.xml index 94a940417b61..f62f89d3703a 100644 --- a/reference/uri/rfc3986/uri/resolve.xml +++ b/reference/uri/rfc3986/uri/resolve.xml @@ -54,7 +54,7 @@ $uri = new \Uri\Rfc3986\Uri("https://example.com"); $uri = $uri->resolve("/foo"); -echo $uri->toString(); +echo $uri->toRawString(); ?> ]]> diff --git a/reference/uri/rfc3986/uri/torawstring.xml b/reference/uri/rfc3986/uri/torawstring.xml index 2f303b49d440..b8ccbe91d6d2 100644 --- a/reference/uri/rfc3986/uri/torawstring.xml +++ b/reference/uri/rfc3986/uri/torawstring.xml @@ -37,7 +37,7 @@ toString(); +echo $uri->toRawString(); ?> ]]> diff --git a/reference/uri/rfc3986/uri/unserialize.xml b/reference/uri/rfc3986/uri/unserialize.xml index 4cda9f2a14d7..74f5b986ec7a 100644 --- a/reference/uri/rfc3986/uri/unserialize.xml +++ b/reference/uri/rfc3986/uri/unserialize.xml @@ -11,7 +11,6 @@ public voidUri\Rfc3986\Uri::__unserialize arraydata - &warn.undocumented.func; Deserializes a data parameter into a Uri\Rfc3986\Uri object. diff --git a/reference/uri/whatwg/invalidurlexception/construct.xml b/reference/uri/whatwg/invalidurlexception/construct.xml index 5d8ccd9cbb4b..7677dc3317f0 100644 --- a/reference/uri/whatwg/invalidurlexception/construct.xml +++ b/reference/uri/whatwg/invalidurlexception/construct.xml @@ -14,7 +14,6 @@ intcode0 Throwablenullprevious&null; - &warn.undocumented.func; Constructs a Uri\WhatWg\InvalidUrlException object. diff --git a/reference/uri/whatwg/url/construct.xml b/reference/uri/whatwg/url/construct.xml index c40f15e903c9..3eb638ca6930 100644 --- a/reference/uri/whatwg/url/construct.xml +++ b/reference/uri/whatwg/url/construct.xml @@ -25,7 +25,7 @@ uri - URI to parse. + A valid URL string to parse (e.g. /foo or (e.g. https://example.com/foo). @@ -54,9 +54,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/debuginfo.xml b/reference/uri/whatwg/url/debuginfo.xml index 31d3785c8509..b97a98f8e41d 100644 --- a/reference/uri/whatwg/url/debuginfo.xml +++ b/reference/uri/whatwg/url/debuginfo.xml @@ -11,7 +11,6 @@ public arrayUri\WhatWg\Url::__debugInfo - &warn.undocumented.func; Returns the internal state of the URL. diff --git a/reference/uri/whatwg/url/equals.xml b/reference/uri/whatwg/url/equals.xml index 204393d95850..16cde9b657c4 100644 --- a/reference/uri/whatwg/url/equals.xml +++ b/reference/uri/whatwg/url/equals.xml @@ -12,7 +12,6 @@ Uri\WhatWg\Urlurl Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment - &warn.undocumented.func; Checks if two URLs are equivalent. diff --git a/reference/uri/whatwg/url/parse.xml b/reference/uri/whatwg/url/parse.xml index 60609eb805f0..4c3dd96ba909 100644 --- a/reference/uri/whatwg/url/parse.xml +++ b/reference/uri/whatwg/url/parse.xml @@ -25,7 +25,7 @@ uri - URI to parse. + A valid URL string to parse (e.g. /foo or (e.g. https://example.com/foo). @@ -68,10 +68,10 @@ toAsciiString(); } else { - echo "Valid URL " . $uri->toAsciiString(); + echo "Invalid URL" } ?> ]]> diff --git a/reference/uri/whatwg/url/resolve.xml b/reference/uri/whatwg/url/resolve.xml index 9fc094fbbe57..4132ecd7a782 100644 --- a/reference/uri/whatwg/url/resolve.xml +++ b/reference/uri/whatwg/url/resolve.xml @@ -12,9 +12,8 @@ stringuri arraysoftErrors&null; - &warn.undocumented.func; - Resolves a URL - which may potentially be a relative-URL string - with the current object as the base URL. + Resolves a valid URL string - which may potentially be a relative-URL string - with the current object as the base URL. @@ -25,7 +24,8 @@ uri - A URL or a relative-url string to apply on the current object. + A valid URL string (e.g. /foo or (e.g. https://example.com/foo) to apply on + the current object. @@ -50,9 +50,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/toasciistring.xml b/reference/uri/whatwg/url/toasciistring.xml index 82d3b6530728..f53c6f5b2016 100644 --- a/reference/uri/whatwg/url/toasciistring.xml +++ b/reference/uri/whatwg/url/toasciistring.xml @@ -11,9 +11,9 @@ public stringUri\WhatWg\Url::toAsciiString - &warn.undocumented.func; - Recomposes the URL as an ASCII &string;. + Recomposes the URL as an ASCII &string;, using punycode transcription instead of Unicode characters in the + host component. diff --git a/reference/uri/whatwg/url/tounicodestring.xml b/reference/uri/whatwg/url/tounicodestring.xml index 65c27f45ea2a..c45b34fd134a 100644 --- a/reference/uri/whatwg/url/tounicodestring.xml +++ b/reference/uri/whatwg/url/tounicodestring.xml @@ -11,9 +11,8 @@ public stringUri\WhatWg\Url::toUnicodeString - &warn.undocumented.func; - Recomposes the URL as a Unicode &string;. + Recomposes the URL as a &string;, where the host component may contain Unicode characters. @@ -38,7 +37,7 @@ toAsciiString(); +echo $url->toUnicodeString(); ?> ]]> diff --git a/reference/uri/whatwg/url/withfragment.xml b/reference/uri/whatwg/url/withfragment.xml index e78513a184ef..c20aad294c73 100644 --- a/reference/uri/whatwg/url/withfragment.xml +++ b/reference/uri/whatwg/url/withfragment.xml @@ -39,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/withhost.xml b/reference/uri/whatwg/url/withhost.xml index 1972e32bdaa6..1282e4858ad9 100644 --- a/reference/uri/whatwg/url/withhost.xml +++ b/reference/uri/whatwg/url/withhost.xml @@ -39,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; @@ -54,7 +52,7 @@ $url = new \Uri\WhatWg\Url("https://example.com"); $url = $url->withHost("example.net"); -echo $url->getHost(); +echo $url->getAsciiHost(); ?> ]]> diff --git a/reference/uri/whatwg/url/withpassword.xml b/reference/uri/whatwg/url/withpassword.xml index 7632f85c430a..ee1bf46124ae 100644 --- a/reference/uri/whatwg/url/withpassword.xml +++ b/reference/uri/whatwg/url/withpassword.xml @@ -11,7 +11,6 @@ public staticUri\WhatWg\Url::withPassword #[\SensitiveParameter]stringnullpassword - &warn.undocumented.func; Creates a new URL and modifies its password component. @@ -40,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/withpath.xml b/reference/uri/whatwg/url/withpath.xml index ac9715499be4..660148ca2aec 100644 --- a/reference/uri/whatwg/url/withpath.xml +++ b/reference/uri/whatwg/url/withpath.xml @@ -39,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; @@ -52,7 +50,7 @@ with("/baz"); +$url = $url->withPath("/baz"); echo $url->get(); ?> diff --git a/reference/uri/whatwg/url/withport.xml b/reference/uri/whatwg/url/withport.xml index e7ec124d0956..400eabac1e06 100644 --- a/reference/uri/whatwg/url/withport.xml +++ b/reference/uri/whatwg/url/withport.xml @@ -39,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/withquery.xml b/reference/uri/whatwg/url/withquery.xml index a4058a3fd128..627719c7abb5 100644 --- a/reference/uri/whatwg/url/withquery.xml +++ b/reference/uri/whatwg/url/withquery.xml @@ -39,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/withscheme.xml b/reference/uri/whatwg/url/withscheme.xml index 395b16545597..4abce98b77d1 100644 --- a/reference/uri/whatwg/url/withscheme.xml +++ b/reference/uri/whatwg/url/withscheme.xml @@ -39,9 +39,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException; diff --git a/reference/uri/whatwg/url/withusername.xml b/reference/uri/whatwg/url/withusername.xml index 1270b9988cfc..6d1c840d6b0f 100644 --- a/reference/uri/whatwg/url/withusername.xml +++ b/reference/uri/whatwg/url/withusername.xml @@ -40,9 +40,7 @@ &reftitle.errors; - - If the resulting URL is invalid, a Uri\WhatWg\InvalidUrlException is thrown. - + &uri.errors.invalidUrlException;