diff --git a/reference/uri/book.xml b/reference/uri/book.xml new file mode 100644 index 0000000000..e1ff837883 --- /dev/null +++ b/reference/uri/book.xml @@ -0,0 +1,54 @@ + + + + + URI + Модуль работы с URI + + + &reftitle.intro; + + Раздел описывает функции для работы с URI-идентификаторами (англ. Uniform Resource Identifiers, сокр. URI). + Унифицированный идентификатор ресурса — строка символов для идентификации ресурса. + В веб-технологиях URI идентифицируют интернет-ресурсы. + + + Расширение обрабатывает идентификаторы по спецификациям + стандартов RFC 3986, Uniform Resource Identifier (URI): Generic Syntax + и WHATWG URL Standard. + + + + &reference.uri.uri.rfc3986.uri; + + &reference.uri.uri.whatwg.url; + + &reference.uri.uri.uricomparisonmode; + + &reference.uri.uri.uriexception; + &reference.uri.uri.urierror; + &reference.uri.uri.invaliduriexception; + &reference.uri.uri.whatwg.invalidurlexception; + &reference.uri.uri.whatwg.urlvalidationerror; + &reference.uri.uri.whatwg.urlvalidationerrortype; + + diff --git a/reference/uri/uri.invaliduriexception.xml b/reference/uri/uri.invaliduriexception.xml new file mode 100644 index 0000000000..4d8e2e81cb --- /dev/null +++ b/reference/uri/uri.invaliduriexception.xml @@ -0,0 +1,67 @@ + + + + Исключение Uri\InvalidUriException + Uri\InvalidUriException + + +
+ &reftitle.intro; + + Исключение выбрасывается при передаче недопустимого URI или если результат операции оказался бы недопустимым. + +
+ +
+ &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 0000000000..6d0d4b53ca --- /dev/null +++ b/reference/uri/uri.rfc3986.uri.xml @@ -0,0 +1,61 @@ + + + + Класс Uri\Rfc3986\Uri + Uri\Rfc3986\Uri + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + Uri\Rfc3986 + + + + final + readonly + Uri + + + &Methods; + + + + + + + + +
+ + + &reference.uri.uri.rfc3986.entities.uri; + + + diff --git a/reference/uri/uri.uricomparisonmode.xml b/reference/uri/uri.uricomparisonmode.xml new file mode 100644 index 0000000000..cebbf6e9b4 --- /dev/null +++ b/reference/uri/uri.uricomparisonmode.xml @@ -0,0 +1,56 @@ + + + + Перечисление Uri\UriComparisonMode + Uri\UriComparisonMode + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.enumsynopsis; + + + Uri + + + UriComparisonMode + + + IncludeFragment + Компонент fragment учитывается при сравнении. + + + + ExcludeFragment + Компонент fragment не учитывается при сравнении. + + + +
+ + + diff --git a/reference/uri/uri.urierror.xml b/reference/uri/uri.urierror.xml new file mode 100644 index 0000000000..b1bd913955 --- /dev/null +++ b/reference/uri/uri.urierror.xml @@ -0,0 +1,67 @@ + + + + Ошибка Uri\UriError + Uri\UriError + + +
+ &reftitle.intro; + + Подтип Error и базовый класс для ошибок, которые возникают при обработке URI-идентификаторов. + +
+ +
+ &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 0000000000..fb4da6abcc --- /dev/null +++ b/reference/uri/uri.uriexception.xml @@ -0,0 +1,67 @@ + + + + Исключение Uri\UriException + Uri\UriException + + +
+ &reftitle.intro; + + Подтип Exception и базовый класс для исключений, которые выбрасываются при обработке URI-идентификаторов. + +
+ +
+ &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 0000000000..c54441f128 --- /dev/null +++ b/reference/uri/uri.whatwg.invalidurlexception.xml @@ -0,0 +1,96 @@ + + + + Исключение Uri\WhatWg\InvalidUrlException + Uri\WhatWg\InvalidUrlException + + +
+ &reftitle.intro; + + Исключение выбрасывается при передаче недопустимого URL-адреса + или если бы операция вернула адрес, который не соответствует стандарту + WHATWG URL Standard. + +
+ +
+ &reftitle.classsynopsis; + + + Uri\WhatWg + + + + InvalidUrlException + + + + extends + Uri\InvalidUriException + + + &Properties; + + public + readonly + array + errors + + + &InheritedProperties; + + + + + &Methods; + + + + + &InheritedMethods; + + + + + +
+ +
+ &reftitle.properties; + + + errors + + + Массив (&array;) объектов Uri\WhatWg\UrlValidationError. + + + + +
+ + + &reference.uri.uri.whatwg.entities.invalidurlexception; + + + diff --git a/reference/uri/uri.whatwg.url.xml b/reference/uri/uri.whatwg.url.xml new file mode 100644 index 0000000000..0ab62487a5 --- /dev/null +++ b/reference/uri/uri.whatwg.url.xml @@ -0,0 +1,61 @@ + + + + Класс Uri\WhatWg\Url + Uri\WhatWg\Url + + +
+ &reftitle.intro; + + +
+ +
+ &reftitle.classsynopsis; + + + Uri\WhatWg + + + + final + readonly + Url + + + &Methods; + + + + + + + + +
+ + + &reference.uri.uri.whatwg.entities.url; + + + diff --git a/reference/uri/uri.whatwg.urlvalidationerror.xml b/reference/uri/uri.whatwg.urlvalidationerror.xml new file mode 100644 index 0000000000..ae1a28f714 --- /dev/null +++ b/reference/uri/uri.whatwg.urlvalidationerror.xml @@ -0,0 +1,108 @@ + + + + Класс Uri\WhatWg\UrlValidationError + Uri\WhatWg\UrlValidationError + + +
+ &reftitle.intro; + + Объект содержит подробную информацию об ошибке, которую парсер обнаружил + в URL-адресе при вызове методов класса Uri\WhatWg\Url. + +
+ +
+ &reftitle.classsynopsis; + + + Uri\WhatWg + + + + final + readonly + UrlValidationError + + + &Properties; + + public + string + context + + + public + Uri\WhatWg\UrlValidationErrorType + type + + + public + bool + failure + + + &Methods; + + + + + +
+ +
+ &reftitle.properties; + + + context + + + Место, в котором парсер обнаружил ошибку при разборе URL-адреса. + + + + + type + + + Тип ошибки. + + + + + failure + + + Значение &true; указывает на неисправимую ошибку, из-за которой парсер отклонил URL-адрес как недопустимый. + Значение &false; указывает на мягкую ошибку, которую парсер автоматически исправил при разборе. + + + + +
+ + + &reference.uri.uri.whatwg.entities.urlvalidationerror; + + + diff --git a/reference/uri/uri.whatwg.urlvalidationerrortype.xml b/reference/uri/uri.whatwg.urlvalidationerrortype.xml new file mode 100644 index 0000000000..d8b72443cb --- /dev/null +++ b/reference/uri/uri.whatwg.urlvalidationerrortype.xml @@ -0,0 +1,204 @@ + + + + Перечисление Uri\WhatWg\UrlValidationErrorType + Uri\WhatWg\UrlValidationErrorType + + +
+ &reftitle.intro; + + Перечисление содержит возможные ошибки проверки URL-адреса, которые определяет стандарт WHATWG URL Standard. + +
+ +
+ &reftitle.enumsynopsis; + + + Uri\WhatWg + + + UrlValidationErrorType + + + DomainToAscii + Ошибка при преобразовании доменного имени в ASCII-строку. + + + + DomainToUnicode + Ошибка при преобразовании доменного имени в Unicode-строку. + + + + DomainInvalidCodePoint + Хост во входных данных содержит кодовую точку, которую стандарт запрещает указывать в доменах. + + + + HostInvalidCodePoint + Непрозрачный хост нестандартного URL-адреса содержит запрещённую кодовую точку. + + + + Ipv4EmptyPart + IPv4-адрес заканчивается точкой. Символ . соответствует кодовой точке U+002E. + + + + Ipv4TooManyParts + IPv4-адрес состоит не из четырёх частей. + + + + Ipv4NonNumericPart + IPv4-адрес содержит нечисловую часть. + + + + Ipv4NonDecimalPart + IPv4-адрес содержит числа в шестнадцатеричной или восьмеричной записи. + + + + Ipv4OutOfRangePart + Октет IPv4-адреса превысил значение 255. + + + + Ipv6Unclosed + IPv6-адрес не содержит закрывающей квадратной скобки. Символ ] соответствует кодовой точке U+005D. + + + + Ipv6InvalidCompression + IPv6-адрес начинается с неправильного сжатия. + + + + Ipv6TooManyPieces + IPv6-адрес содержит больше восьми частей. + + + + Ipv6MultipleCompression + IPv6-адрес содержит больше одного сжатия. + + + + Ipv6InvalidCodePoint + + IPv6-адрес неожиданного закончился, или содержит символ, который не соответствует ни шестнадцатеричной цифре в кодировке ASCII, + ни символу двоеточия. Символ : соответствует кодовой точке U+003A. + + + + + Ipv6TooFewPieces + Несжатый IPv6-адрес содержит меньше восьми частей. + + + + Ipv4InIpv6TooManyPieces + IPv6-адрес с IPv4-синтаксисом содержит больше шести частей. + + + + Ipv4InIpv6InvalidCodePoint + IPv4-часть IPv6-адреса содержит символ с недопустимой кодовой точкой. + + + + Ipv4InIpv6OutOfRangePart + Октет в IPv4-части IPv6-адреса превысил значение 255. + + + + Ipv4InIpv6TooFewParts + IPv4-часть IPv6-адреса содержит меньше четырёх частей. + + + + InvalidUrlUnit + URL-адрес содержит символ, который соответствует кодовой точке за пределами допустимого диапазона. + + + + SpecialSchemeMissingFollowingSolidus + После схемы во входных данных не идут символы //. + + + + MissingSchemeNonRelativeUrl + + Входные данные не содержат схему, поскольку не начинаются с ASCII-буквы, не указан базовый URL-адрес + или базовый адрес невозможно интерпретировать как базовый URL, поскольку адрес содержит непрозрачный путь. + + + + + InvalidReverseSoldius + + После стандартной схемы URL-адреса вместо символа / с кодовой точкой U+002F + идёт символ \ с кодовой точкой U+005C. + + + + + InvalidCredentials + Входные данные включают учётные данные. + + + + HostMissing + Входные данные содержат стандартную схему, но не содержат хост. + + + + PortOutOfRange + Порт во входных данных превысил допустимый предел. + + + + PortInvalid + Входные данные содержат недопустимый порт. + + + + FileInvalidWindowsDriveLetter + + Входная строка с относительным URL-адресом начинается с буквы диска Windows + а схема базового адреса — со слова file. + + + + + FileInvalidWindowsDriveLetterHost + Хост URL-адреса со схемой file: содержит букву диска Windows. + + + +
+ + + diff --git a/reference/uri/uri/rfc3986/uri/construct.xml b/reference/uri/uri/rfc3986/uri/construct.xml new file mode 100644 index 0000000000..eeb091609a --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/construct.xml @@ -0,0 +1,80 @@ + + + + + Uri\Rfc3986\Uri::__construct + Инициализирует новый экземпляр класса Uri + + + + &reftitle.description; + + public Uri\Rfc3986\Uri::__construct + stringuri + Uri\Rfc3986\UrinullbaseUrl&null; + + + Метод инициализирует объект Uri\Rfc3986\Uri. + + + + + &reftitle.parameters; + + + uri + + + URI для разбора. + + + + + baseUrl + + + Базовый URL-адрес. При передаче объекта строка (&string;), которую передали в конструктор аргумента baseUrl, + интерпретируется как базовый адрес, а строка uri разбирается как остальная часть URI, + только если в параметр uri передали строку с относительным URL-адресом. + Метод проигнорирует аргумент baseUrl, + если в этот параметр передали &null; или в параметр uri передали не относительный URL-адрес. + + + + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::parse + Uri\Rfc3986\Uri::resolve + Uri\WhatWg\Url::__construct + + + + diff --git a/reference/uri/uri/rfc3986/uri/debuginfo.xml b/reference/uri/uri/rfc3986/uri/debuginfo.xml new file mode 100644 index 0000000000..09b9fa8f27 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/debuginfo.xml @@ -0,0 +1,58 @@ + + + + + Uri\Rfc3986\Uri::__debugInfo + Возвращает внутреннее состояние объекта URI + + + + &reftitle.description; + + public arrayUri\Rfc3986\Uri::__debugInfo + + + + Метод возвращает внутреннее состояние объекта URI. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает массив (&array;) с информацией о внутреннем состоянии URI. + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__debugInfo + + + + diff --git a/reference/uri/uri/rfc3986/uri/equals.xml b/reference/uri/uri/rfc3986/uri/equals.xml new file mode 100644 index 0000000000..bbc8733ccc --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/equals.xml @@ -0,0 +1,101 @@ + + + + + Uri\Rfc3986\Uri::equals + Проверяет, эквивалентны ли два URI + + + + &reftitle.description; + + public boolUri\Rfc3986\Uri::equals + Uri\Rfc3986\Uriuri + Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment + + + Метод проверяет эквивалентность двух URI. + + + + + &reftitle.parameters; + + + uri + + + Объект URI, с которым требуется сравнить текущий объект URI. + + + + + comparisonMode + + + Параметр определяет, учитывать ли компонент «фрагмент» при сравнении. + При передаче варианта Uri\UriComparisonMode::IncludeFragment фрагмент сравнивается, + а с вариантом Uri\UriComparisonMode::ExcludeFragment — игнорируется. По умолчанию фрагмент исключается из сравнения. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает &true;, если два URI эквивалентны, иначе возвращается &false;. + + + + + &reftitle.examples; + + Пример сравнения идентификаторов методом <methodname>Uri\Rfc3986\Uri::equals</methodname> + +equals($uri2)); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::equals + + + + diff --git a/reference/uri/uri/rfc3986/uri/getfragment.xml b/reference/uri/uri/rfc3986/uri/getfragment.xml new file mode 100644 index 0000000000..03681c89b6 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getfragment.xml @@ -0,0 +1,83 @@ + + + + + Uri\Rfc3986\Uri::getFragment + Получает нормализованный компонент «фрагмент» + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getFragment + + + + Метод возвращает нормализованный фрагмент — часть URI после символа #. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованный фрагмент в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения фрагмента методом <methodname>Uri\Rfc3986\Uri::getFragment</methodname> + +getFragment(); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawFragment + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + diff --git a/reference/uri/uri/rfc3986/uri/gethost.xml b/reference/uri/uri/rfc3986/uri/gethost.xml new file mode 100644 index 0000000000..3f89f4e28f --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/gethost.xml @@ -0,0 +1,83 @@ + + + + + Uri\Rfc3986\Uri::getHost + Получает нормализованный хост + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getHost + + + + Метод возвращает нормализованный хост. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованный хост в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения хоста методом <methodname>Uri\Rfc3986\Uri::getHost</methodname> + +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/uri/rfc3986/uri/getpassword.xml b/reference/uri/uri/rfc3986/uri/getpassword.xml new file mode 100644 index 0000000000..f8f20d4e2d --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getpassword.xml @@ -0,0 +1,87 @@ + + + + + Uri\Rfc3986\Uri::getPassword + Получает нормализованный пароль + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getPassword + + + + Метод возвращает из компонента с информацией о пользователе нормализованный пароль: + часть после первого символа :. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованный пароль в виде строки (&string;), если компонент с информацией о пользователе содержит символ :. + Метод вернёт пустую строку, если компонент с информацией о пользователе не содержит символа :, + или &null;, если объект URI не содержит компонента с информацией о пользователе. + + + + + &reftitle.examples; + + Пример получения пароля методом <methodname>Uri\Rfc3986\Uri::getPassword</methodname> + +getPassword(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withPassword + Uri\WhatWg\Url::getPassword + + + + diff --git a/reference/uri/uri/rfc3986/uri/getpath.xml b/reference/uri/uri/rfc3986/uri/getpath.xml new file mode 100644 index 0000000000..c9a7fb8ba9 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getpath.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getPath + Получает нормализованный путь + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::getPath + + + + Метод возвращает нормализованный путь. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованный путь в виде строки (&string;). + + + + + &reftitle.examples; + + Пример получения пути методом <methodname>Uri\Rfc3986\Uri::getPath</methodname> + +getPath(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawPath + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + diff --git a/reference/uri/uri/rfc3986/uri/getport.xml b/reference/uri/uri/rfc3986/uri/getport.xml new file mode 100644 index 0000000000..66e1db20b2 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getport.xml @@ -0,0 +1,81 @@ + + + + + Uri\Rfc3986\Uri::getPort + Получает порт + + + + &reftitle.description; + + public intnullUri\Rfc3986\Uri::getPort + + + + Метод возвращает порт. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает порт в виде целого числа (&integer; ), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения порта методом <methodname>Uri\Rfc3986\Uri::getPort</methodname> + +getPort(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::withPort + Uri\WhatWg\Url::getPort + + + + diff --git a/reference/uri/uri/rfc3986/uri/getquery.xml b/reference/uri/uri/rfc3986/uri/getquery.xml new file mode 100644 index 0000000000..ddc79e7eef --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getquery.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getQuery + Получает нормализованные аргументы запроса + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getQuery + + + + Метод возвращает нормализованные аргументы запроса. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованные аргументы запроса в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения аргументов запроса методом <methodname>Uri\Rfc3986\Uri::getQuery</methodname> + +getQuery(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawfragment.xml b/reference/uri/uri/rfc3986/uri/getrawfragment.xml new file mode 100644 index 0000000000..fffd592071 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawfragment.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getRawFragment + Получает сырой компонент «фрагмент» + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawFragment + + + + Метод возвращает фрагмент в сыром, ненормализованном виде. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырой фрагмент в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения фрагмента методом <methodname>Uri\Rfc3986\Uri::getRawFragment</methodname> + +getRawFragment(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getFragment + Uri\Rfc3986\Uri::withFragment + Uri\WhatWg\Url::getFragment + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawhost.xml b/reference/uri/uri/rfc3986/uri/getrawhost.xml new file mode 100644 index 0000000000..c7fc02d17e --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawhost.xml @@ -0,0 +1,83 @@ + + + + + Uri\Rfc3986\Uri::getRawHost + Получает сырой хост + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawHost + + + + Метод возвращает сырой, ненормализованный хост. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырой хост в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения хоста методом <methodname>Uri\Rfc3986\Uri::getRawHost</methodname> + +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/uri/rfc3986/uri/getrawpassword.xml b/reference/uri/uri/rfc3986/uri/getrawpassword.xml new file mode 100644 index 0000000000..843d2b976d --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawpassword.xml @@ -0,0 +1,85 @@ + + + + + Uri\Rfc3986\Uri::getRawPassword + Получает сырой пароль + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawPassword + + + + Метод возвращает из компонента с информацией о пользователе сырой, ненормализованный пароль: + часть после первого символа :. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырой, ненормализованный пароль в виде строки (&string;), если компонент с информацией о пользователе содержит символ :. + Метод вернёт пустую строку, если компонент с информацией о пользователе не содержит символа :, + или &null;, если объект URI не содержит компонента с информацией о пользователе. + + + + + &reftitle.examples; + + Пример получения пароля методом <methodname>Uri\Rfc3986\Uri::getRawPassword</methodname> + +getRawPassword(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getPassword + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawpath.xml b/reference/uri/uri/rfc3986/uri/getrawpath.xml new file mode 100644 index 0000000000..ce5f2905b8 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawpath.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getRawPath + Получает сырой путь + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::getRawPath + + + + Метод возвращает сырой, ненормализованный путь. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырой путь в виде строки (&string;). + + + + + &reftitle.examples; + + Пример получения пути методом <methodname>Uri\Rfc3986\Uri::getRawPath</methodname> + +getRawPath(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPath + Uri\Rfc3986\Uri::withPath + Uri\WhatWg\Url::getPath + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawquery.xml b/reference/uri/uri/rfc3986/uri/getrawquery.xml new file mode 100644 index 0000000000..134ddd4272 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawquery.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getRawQuery + Получает сырые аргументы запроса + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawQuery + + + + Метод возвращает сырые, ненормализованные аргументы запроса. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырые, ненормализованные аргументы запроса в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения сырых аргументов запроса методом <methodname>Uri\Rfc3986\Uri::getRawQuery</methodname> + +getRawQuery(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getQuery + Uri\Rfc3986\Uri::withQuery + Uri\WhatWg\Url::getQuery + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawscheme.xml b/reference/uri/uri/rfc3986/uri/getrawscheme.xml new file mode 100644 index 0000000000..837bc56411 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawscheme.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getRawScheme + Получает сырую схему + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawScheme + + + + Метод возвращает сырую, ненормализованную схему. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырую схему в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения схемы методом <methodname>Uri\Rfc3986\Uri::getRawScheme</methodname> + +getRawScheme(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getScheme + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + diff --git a/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml b/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml new file mode 100644 index 0000000000..efc59a8bcc --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawuserinfo.xml @@ -0,0 +1,86 @@ + + + + + Uri\Rfc3986\Uri::getRawUserInfo + Получает сырой компонент с информацией о пользователе + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawUserInfo + + + + Метод возвращает сырой, ненормализованный компонент с именем пользователя и паролем. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырой компонент с информацией о пользователе в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения компонента с информацией о пользователе методом <methodname>Uri\Rfc3986\Uri::getRawUserInfo</methodname> + +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/uri/rfc3986/uri/getrawusername.xml b/reference/uri/uri/rfc3986/uri/getrawusername.xml new file mode 100644 index 0000000000..932f11c6b5 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getrawusername.xml @@ -0,0 +1,84 @@ + + + + + Uri\Rfc3986\Uri::getRawUsername + Получает сырое имя пользователя + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getRawUsername + + + + Метод возвращает из компонента с информацией о пользователе сырое, ненормализованное имя пользователя: + часть перед первым символом :. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сырое имя пользователя в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения имени пользователя методом <methodname>Uri\Rfc3986\Uri::getRawUsername</methodname> + +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/uri/rfc3986/uri/getscheme.xml b/reference/uri/uri/rfc3986/uri/getscheme.xml new file mode 100644 index 0000000000..825fc4926d --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getscheme.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::getScheme + Получает нормализованную схему + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getScheme + + + + Метод возвращает нормализованную схему. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованную схему в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения схемы методом <methodname>Uri\Rfc3986\Uri::getScheme</methodname> + +getScheme(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::withScheme + Uri\WhatWg\Url::getScheme + + + + diff --git a/reference/uri/uri/rfc3986/uri/getuserinfo.xml b/reference/uri/uri/rfc3986/uri/getuserinfo.xml new file mode 100644 index 0000000000..95cd37d3ee --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getuserinfo.xml @@ -0,0 +1,87 @@ + + + + + Uri\Rfc3986\Uri::getUserInfo + Получает нормализованный компонент с информацией о пользователе + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getUserInfo + + + + Метод возвращает нормализованный компонент с именем пользователя и паролем. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованный компонент с информацией о пользователе в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения компонента с информацией о пользователе методом <methodname>Uri\Rfc3986\Uri::getUserInfo</methodname> + +getUserInfo(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getPassword + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + + + + diff --git a/reference/uri/uri/rfc3986/uri/getusername.xml b/reference/uri/uri/rfc3986/uri/getusername.xml new file mode 100644 index 0000000000..ad4927ad28 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/getusername.xml @@ -0,0 +1,85 @@ + + + + + Uri\Rfc3986\Uri::getUsername + Получает нормализованное имя пользователя + + + + &reftitle.description; + + public stringnullUri\Rfc3986\Uri::getUsername + + + + Метод возвращает из компонента с информацией о пользователе нормализованное имя пользователя: + часть перед первым символом :. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает нормализованное имя пользователя в виде строки (&string;), если объект URI содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения имени пользователя методом <methodname>Uri\Rfc3986\Uri::getUsername</methodname> + +getUsername(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::withUserInfo + Uri\WhatWg\Url::getUsername + + + + diff --git a/reference/uri/uri/rfc3986/uri/parse.xml b/reference/uri/uri/rfc3986/uri/parse.xml new file mode 100644 index 0000000000..16fa626e2e --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/parse.xml @@ -0,0 +1,108 @@ + + + + + Uri\Rfc3986\Uri::parse + Разбирает URI + + + + &reftitle.description; + + public static staticnullUri\Rfc3986\Uri::parse + stringuri + Uri\Rfc3986\UrinullbaseUrl&null; + + + Метод разбирает URI. + + + + + &reftitle.parameters; + + + uri + + + URI для разбора. + + + + + baseUrl + + + Базовый URL-адрес. При передаче объекта строка (&string;), которую передали в конструктор аргумента baseUrl, + интерпретируется как базовый адрес, а строка uri разбирается как остальная часть URI, + только если в параметр uri передали строку с относительным URL-адресом. + Метод проигнорирует аргумент baseUrl, + если в этот параметр передали &null; или в параметр uri передали не относительный URL-адрес. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает объект Uri\Rfc3986\Uri, если выполнился успешно, или &null;, если возникла ошибка. + + + + + &reftitle.examples; + + Пример разбора URI методом <methodname>Uri\Rfc3986\Uri::parse</methodname> + +toString(); +} else { + echo "Недопустимый URI"; +} +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__construct + Uri\Rfc3986\Uri::resolve + Uri\WhatWg\Url::parse + + + + diff --git a/reference/uri/uri/rfc3986/uri/resolve.xml b/reference/uri/uri/rfc3986/uri/resolve.xml new file mode 100644 index 0000000000..ee9cef84e8 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/resolve.xml @@ -0,0 +1,97 @@ + + + + + Uri\Rfc3986\Uri::resolve + Разрешает URI на основе текущего объекта в роли базового URI + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::resolve + stringuri + + + Разрешает строку с абсолютным или относительным URI, при этом текущий объект интерпретируется как базовый URI. + + + + + &reftitle.parameters; + + + uri + + + URI для разрешения на основе текущего объекта. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример разрешения URI методом <methodname>Uri\Rfc3986\Uri::resolve</methodname> + +resolve("/foo"); + +echo $uri->toRawString(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__construct + Uri\Rfc3986\Uri::parse + Uri\WhatWg\Url::resolve + + + + diff --git a/reference/uri/uri/rfc3986/uri/serialize.xml b/reference/uri/uri/rfc3986/uri/serialize.xml new file mode 100644 index 0000000000..4cd60be300 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/serialize.xml @@ -0,0 +1,59 @@ + + + + + Uri\Rfc3986\Uri::__serialize + Сериализует объект Uri + + + + &reftitle.description; + + public arrayUri\Rfc3986\Uri::__serialize + + + + Метод сериализует объект Uri\Rfc3986\Uri. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сериализованное в строку (&string;) представление объекта URI. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__unserialize + Uri\WhatWg\Url::__serialize + + + + diff --git a/reference/uri/uri/rfc3986/uri/torawstring.xml b/reference/uri/uri/rfc3986/uri/torawstring.xml new file mode 100644 index 0000000000..177b88e210 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/torawstring.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::toRawString + Пересобирает URI в сырую строку + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::toRawString + + + + Метод преобразовывает объект URI в сырую, ненормализованную строку (&string;). + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает пересобранный URI в виде сырой строки (&string;). + + + + + &reftitle.examples; + + Пример пересборки URI методом <methodname>Uri\Rfc3986\Uri::toRawString</methodname> + +toRawString(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toString + Uri\WhatWg\Url::toAsciiString + Uri\WhatWg\Url::toUnicodeString + + + + diff --git a/reference/uri/uri/rfc3986/uri/tostring.xml b/reference/uri/uri/rfc3986/uri/tostring.xml new file mode 100644 index 0000000000..c285902bd2 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/tostring.xml @@ -0,0 +1,82 @@ + + + + + Uri\Rfc3986\Uri::toString + Пересобирает URI в нормализованную строку + + + + &reftitle.description; + + public stringUri\Rfc3986\Uri::toString + + + + Метод преобразовывает объект URI в нормализованную строку (&string;). + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает пересобранный URI в виде нормализованной строки (&string;). + + + + + &reftitle.examples; + + Пример пересборки URI методом <methodname>Uri\Rfc3986\Uri::toString</methodname> + +toString(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::toRawString + Uri\WhatWg\Url::toAsciiString + Uri\WhatWg\Url::toUnicodeString + + + + diff --git a/reference/uri/uri/rfc3986/uri/unserialize.xml b/reference/uri/uri/rfc3986/uri/unserialize.xml new file mode 100644 index 0000000000..1361aeaeb0 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/unserialize.xml @@ -0,0 +1,78 @@ + + + + + Uri\Rfc3986\Uri::__unserialize + Десериализует массив из параметра data в объект Uri + + + + &reftitle.description; + + public voidUri\Rfc3986\Uri::__unserialize + arraydata + + + Метод восстанавливает объект Uri\Rfc3986\Uri из массива, который передаётся в параметр data при десериализации. + + + + + &reftitle.parameters; + + + data + + + Сериализованное в массив array представление объекта URI. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + При вызове метода __unserialize на объекте URI выбрасывается + ошибка Error. + + + &uri.errors.invalidUriException; + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__serialize + Uri\WhatWg\Url::__unserialize + + + + diff --git a/reference/uri/uri/rfc3986/uri/withfragment.xml b/reference/uri/uri/rfc3986/uri/withfragment.xml new file mode 100644 index 0000000000..bf08e4862c --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withfragment.xml @@ -0,0 +1,97 @@ + + + + + Uri\Rfc3986\Uri::withFragment + Копирует объект URI с новым компонентом «фрагмент» + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withFragment + stringnullfragment + + + Метод создаёт копию исходного объекта URI с новым фрагментом. + + + + + &reftitle.parameters; + + + fragment + + + Новый фрагмент. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новым фрагментом методом <methodname>Uri\Rfc3986\Uri::withFragment</methodname> + +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/uri/rfc3986/uri/withhost.xml b/reference/uri/uri/rfc3986/uri/withhost.xml new file mode 100644 index 0000000000..458fbeaa75 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withhost.xml @@ -0,0 +1,97 @@ + + + + + Uri\Rfc3986\Uri::withHost + Копирует объект URI с новым хостом + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withHost + stringnullhost + + + Метод создаёт копию исходного объекта URI с новым хостом. + + + + + &reftitle.parameters; + + + host + + + Новый хост. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новым хостом методом <methodname>Uri\Rfc3986\Uri::withHost</methodname> + +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/uri/rfc3986/uri/withpath.xml b/reference/uri/uri/rfc3986/uri/withpath.xml new file mode 100644 index 0000000000..1185b79073 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withpath.xml @@ -0,0 +1,97 @@ + + + + + Uri\Rfc3986\Uri::withPath + Копирует объект URI с новым путём + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withPath + stringpath + + + Метод создаёт копию исходного объекта URI с новым путём. + + + + + &reftitle.parameters; + + + path + + + Новый путь. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новым путём методом <methodname>Uri\Rfc3986\Uri::withPath</methodname> + +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/uri/rfc3986/uri/withport.xml b/reference/uri/uri/rfc3986/uri/withport.xml new file mode 100644 index 0000000000..f727c2bcfc --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withport.xml @@ -0,0 +1,96 @@ + + + + + Uri\Rfc3986\Uri::withPort + Копирует объект URI с новым портом + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withPort + intnullport + + + Метод создаёт копию исходного объекта URI с новым портом. + + + + + &reftitle.parameters; + + + port + + + Новый порт. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новым портом методом <methodname>Uri\Rfc3986\Uri::withPort</methodname> + +withPort(443); + +echo $uri->getPort(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getPort + Uri\WhatWg\Url::withPort + + + + diff --git a/reference/uri/uri/rfc3986/uri/withquery.xml b/reference/uri/uri/rfc3986/uri/withquery.xml new file mode 100644 index 0000000000..99ab79ac49 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withquery.xml @@ -0,0 +1,97 @@ + + + + + Uri\Rfc3986\Uri::withQuery + Копирует объект URI с новыми аргументами запроса + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withQuery + stringnullquery + + + Метод создаёт копию исходного объекта URI с новыми аргументами запроса. + + + + + &reftitle.parameters; + + + query + + + Новые аргументы запроса. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новыми аргументами запроса методом <methodname>Uri\Rfc3986\Uri::withQuery</methodname> + +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/uri/rfc3986/uri/withscheme.xml b/reference/uri/uri/rfc3986/uri/withscheme.xml new file mode 100644 index 0000000000..1cf32dee14 --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withscheme.xml @@ -0,0 +1,97 @@ + + + + + Uri\Rfc3986\Uri::withScheme + Копирует объект URI с новой схемой + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withScheme + stringnullscheme + + + Метод создаёт копию исходного объекта URI с новой схемой. + + + + + &reftitle.parameters; + + + scheme + + + Новая схема. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новой схемой методом <methodname>Uri\Rfc3986\Uri::withScheme</methodname> + +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/uri/rfc3986/uri/withuserinfo.xml b/reference/uri/uri/rfc3986/uri/withuserinfo.xml new file mode 100644 index 0000000000..e8a8fa590a --- /dev/null +++ b/reference/uri/uri/rfc3986/uri/withuserinfo.xml @@ -0,0 +1,102 @@ + + + + + Uri\Rfc3986\Uri::withUserInfo + Копирует объект URI с новым компонентом с информацией о пользователе + + + + &reftitle.description; + + public staticUri\Rfc3986\Uri::withUserInfo + #[\SensitiveParameter]stringnulluserinfo + + + Метод создаёт копию исходного объекта URI с новыми именем пользователя и паролем. + + + + + &reftitle.parameters; + + + userinfo + + + Новые имя пользователя и пароль. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\Rfc3986\Uri. + + + + + &reftitle.errors; + &uri.errors.invalidUriException; + + + + &reftitle.examples; + + Пример копирования объекта URI с новыми именем пользователя и паролем методом <methodname>Uri\Rfc3986\Uri::withUserInfo</methodname> + +withUserInfo("userinfo"); + +echo $uri->getUserInfo(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::getRawUserInfo + Uri\Rfc3986\Uri::getUserInfo + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getPassword + Uri\WhatWg\Url::withUsername + Uri\WhatWg\Url::withPassword + + + + diff --git a/reference/uri/uri/whatwg/invalidurlexception/construct.xml b/reference/uri/uri/whatwg/invalidurlexception/construct.xml new file mode 100644 index 0000000000..9c63c82466 --- /dev/null +++ b/reference/uri/uri/whatwg/invalidurlexception/construct.xml @@ -0,0 +1,80 @@ + + + + + Uri\WhatWg\InvalidUrlException::__construct + Инициализирует новый экземпляр класса InvalidUrlException + + + + &reftitle.description; + + public Uri\WhatWg\InvalidUrlException::__construct + stringmessage"" + arrayerrors[] + intcode0 + Throwablenullprevious&null; + + + Метод инициализирует объект исключения Uri\WhatWg\InvalidUrlException. + + + + + &reftitle.parameters; + + + message + + + Сообщение исключения. + + + + + errors + + + Массив (&array;) объектов Uri\WhatWg\UrlValidationError. + + + + + code + + + Код исключения. + + + + + previous + + + Предыдущее исключение для передачи по цепочке. + + + + + + + diff --git a/reference/uri/uri/whatwg/url/construct.xml b/reference/uri/uri/whatwg/url/construct.xml new file mode 100644 index 0000000000..89626c28ce --- /dev/null +++ b/reference/uri/uri/whatwg/url/construct.xml @@ -0,0 +1,90 @@ + + + + + Uri\WhatWg\Url::__construct + Инициализирует новый объект URL-адреса + + + + &reftitle.description; + + public Uri\WhatWg\Url::__construct + stringuri + Uri\WhatWg\UrlnullbaseUrl&null; + arraysoftErrors&null; + + + Метод инициализирует объект Uri\WhatWg\Url. + + + + + &reftitle.parameters; + + + uri + + + Строка с допустимым URL-адресом для разбора, например: /foo или https://example.com/foo. + + + + + baseUrl + + + Базовый URL-адрес. При передаче объекта строка (&string;), которую передали в конструктор аргумента baseUrl, + интерпретируется как базовый адрес, а строка uri разбирается как остальная часть URI, + только если в параметр uri передали строку с относительным URL-адресом. + Метод проигнорирует аргумент baseUrl, + если в этот параметр передали &null; или в параметр uri передали не относительный URL-адрес. + + + + + softErrors + + + Переменная, которую метод по ссылке заполнит массивом (&array;) экземпляров Uri\WhatWg\UrlValidationError + с расширенной информацией о некритичных ошибках, которые возникли при разборе. + + + + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.seealso; + + Uri\WhatWg\Url::parse + Uri\WhatWg\Url::resolve + Uri\Rfc3986\Uri::__construct + + + + diff --git a/reference/uri/uri/whatwg/url/debuginfo.xml b/reference/uri/uri/whatwg/url/debuginfo.xml new file mode 100644 index 0000000000..22d80697a6 --- /dev/null +++ b/reference/uri/uri/whatwg/url/debuginfo.xml @@ -0,0 +1,58 @@ + + + + + Uri\WhatWg\Url::__debugInfo + Возвращает внутреннее состояние объекта URL-адреса + + + + &reftitle.description; + + public arrayUri\WhatWg\Url::__debugInfo + + + + Метод возвращает внутреннее состояние объекта URL-адреса. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает массив (&array;) с информацией о внутреннем состоянии объекта URL-адреса. + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::__debugInfo + + + + diff --git a/reference/uri/uri/whatwg/url/equals.xml b/reference/uri/uri/whatwg/url/equals.xml new file mode 100644 index 0000000000..830e1bc9e7 --- /dev/null +++ b/reference/uri/uri/whatwg/url/equals.xml @@ -0,0 +1,101 @@ + + + + + Uri\WhatWg\Url::equals + Проверяет, эквивалентны ли два URL-адреса + + + + &reftitle.description; + + public boolUri\WhatWg\Url::equals + Uri\WhatWg\Urlurl + Uri\UriComparisonModecomparisonModeUri\UriComparisonMode::ExcludeFragment + + + Метод проверяет эквивалентность двух URL-адресов. + + + + + &reftitle.parameters; + + + url + + + Объект URL-адреса, с которым требуется сравнить текущий объект URL-адреса. + + + + + comparisonMode + + + Параметр определяет, учитывать ли компонент «фрагмент» при сравнении. + При передаче варианта Uri\UriComparisonMode::IncludeFragment фрагмент сравнивается, + а с вариантом Uri\UriComparisonMode::ExcludeFragment — игнорируется. По умолчанию фрагмент исключается из сравнения. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает &true;, если два URL-адреса эквивалентны, иначе возвращается &false;. + + + + + &reftitle.examples; + + Пример сравнения адресов методом <methodname>Uri\WhatWg\Url::equals</methodname> + +equals($url2)); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\Rfc3986\Uri::equals + + + + diff --git a/reference/uri/uri/whatwg/url/getasciihost.xml b/reference/uri/uri/whatwg/url/getasciihost.xml new file mode 100644 index 0000000000..964aa3f9e2 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getasciihost.xml @@ -0,0 +1,83 @@ + + + + + Uri\WhatWg\Url::getAsciiHost + Возвращает ASCII-представление хоста + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getAsciiHost + + + + Метод возвращает хост в виде строки (&string;). Хост, который включает многобайтовые символы Юникода, преобразуется в формат Punycode. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает хост в виде строки (&string;), которая состоит только из набора символов ASCII, если объект адреса содержит хост, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения ASCII-представления хоста методом <methodname>Uri\WhatWg\Url::getAsciiHost</methodname> + +getAsciiHost(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getUnicodeHost + Uri\WhatWg\Url::withHost + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::getHost + + + + diff --git a/reference/uri/uri/whatwg/url/getfragment.xml b/reference/uri/uri/whatwg/url/getfragment.xml new file mode 100644 index 0000000000..158eaec7d8 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getfragment.xml @@ -0,0 +1,82 @@ + + + + + Uri\WhatWg\Url::getFragment + Получает компонент «фрагмент» + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getFragment + + + + Метод возвращает фрагмент — часть URL-адреса после символа #. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает фрагмент в виде строки (&string;), если объект URL-адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения фрагмента методом <methodname>Uri\WhatWg\Url::getFragment</methodname> + +getFragment(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withFragment + Uri\Rfc3986\Uri::getRawFragment + Uri\Rfc3986\Uri::getFragment + + + + diff --git a/reference/uri/uri/whatwg/url/getpassword.xml b/reference/uri/uri/whatwg/url/getpassword.xml new file mode 100644 index 0000000000..7cc08592e5 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getpassword.xml @@ -0,0 +1,82 @@ + + + + + Uri\WhatWg\Url::getPassword + Получает пароль + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getPassword + + + + Метод возвращает пароль. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает пароль в виде строки (&string;), если объект URL-адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения пароля методом <methodname>Uri\WhatWg\Url::getPassword</methodname> + +getPassword(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withPassword + Uri\Rfc3986\Uri::getRawPassword + Uri\Rfc3986\Uri::getPassword + + + + diff --git a/reference/uri/uri/whatwg/url/getpath.xml b/reference/uri/uri/whatwg/url/getpath.xml new file mode 100644 index 0000000000..d0b66932cf --- /dev/null +++ b/reference/uri/uri/whatwg/url/getpath.xml @@ -0,0 +1,82 @@ + + + + + Uri\WhatWg\Url::getPath + Получает путь + + + + &reftitle.description; + + public stringUri\WhatWg\Url::getPath + + + + Метод возвращает путь. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает путь в виде строки (&string;). + + + + + &reftitle.examples; + + Пример получения пути методом <methodname>Uri\WhatWg\Url::getPath</methodname> + +getPath(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withPath + Uri\Rfc3986\Uri::getRawPath + Uri\Rfc3986\Uri::getPath + + + + diff --git a/reference/uri/uri/whatwg/url/getport.xml b/reference/uri/uri/whatwg/url/getport.xml new file mode 100644 index 0000000000..af2d04f190 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getport.xml @@ -0,0 +1,81 @@ + + + + + Uri\WhatWg\Url::getPort + Получает порт + + + + &reftitle.description; + + public intnullUri\WhatWg\Url::getPort + + + + Метод возвращает порт. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает порт в виде целого числа (&integer;), если объект URL-адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения порта методом <methodname>Uri\WhatWg\Url::getPort</methodname> + +getPort(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withPort + Uri\Rfc3986\Uri::getPort + + + + diff --git a/reference/uri/uri/whatwg/url/getquery.xml b/reference/uri/uri/whatwg/url/getquery.xml new file mode 100644 index 0000000000..92eb20aea9 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getquery.xml @@ -0,0 +1,82 @@ + + + + + Uri\WhatWg\Url::getQuery + Получает компонент URL-адреса с аргументами запроса + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getQuery + + + + Метод возвращает аргументы запроса. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает аргументы запроса в виде строки (&string;), если объект URL-адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения аргументов запроса методом <methodname>Uri\WhatWg\Url::getQuery</methodname> + +getQuery(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withQuery + Uri\Rfc3986\Uri::getRawQuery + Uri\Rfc3986\Uri::getQuery + + + + diff --git a/reference/uri/uri/whatwg/url/getscheme.xml b/reference/uri/uri/whatwg/url/getscheme.xml new file mode 100644 index 0000000000..3c4e41ce73 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getscheme.xml @@ -0,0 +1,82 @@ + + + + + Uri\WhatWg\Url::getScheme + Получает схему + + + + &reftitle.description; + + public stringUri\WhatWg\Url::getScheme + + + + Метод возвращает схему. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает схему в виде строки (&string;), если объект URL-адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения схемы методом <methodname>Uri\WhatWg\Url::getScheme</methodname> + +getScheme(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withScheme + Uri\Rfc3986\Uri::getRawScheme + Uri\Rfc3986\Uri::getScheme + + + + diff --git a/reference/uri/uri/whatwg/url/getunicodehost.xml b/reference/uri/uri/whatwg/url/getunicodehost.xml new file mode 100644 index 0000000000..e4e552dc25 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getunicodehost.xml @@ -0,0 +1,83 @@ + + + + + Uri\WhatWg\Url::getUnicodeHost + Возвращает Юникод-представление хоста + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getUnicodeHost + + + + Метод возвращает Юникод-представление хоста в виде строки (&string;). Хост в формате Punycode преобразовывается в последовательность многобайтовых символов Юникода. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает хост в виде Юникод-строки (&string;), если объект адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения Юникод-представления хоста методом <methodname>Uri\WhatWg\Url::getUnicodeHost</methodname> + +getUnicodeHost(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::withHost + Uri\Rfc3986\Uri::getRawHost + Uri\Rfc3986\Uri::getHost + + + + diff --git a/reference/uri/uri/whatwg/url/getusername.xml b/reference/uri/uri/whatwg/url/getusername.xml new file mode 100644 index 0000000000..a924edd132 --- /dev/null +++ b/reference/uri/uri/whatwg/url/getusername.xml @@ -0,0 +1,82 @@ + + + + + Uri\WhatWg\Url::getUsername + Получает имя пользователя + + + + &reftitle.description; + + public stringnullUri\WhatWg\Url::getUsername + + + + Метод возвращает имя пользователя. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает имя пользователя в виде строки (&string;), если объект URL-адреса содержит такой компонент, иначе возвращается &null;. + + + + + &reftitle.examples; + + Пример получения имени пользователя методом <methodname>Uri\WhatWg\Url::getUsername</methodname> + +getUsername(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::withUsername + Uri\Rfc3986\Uri::getRawUsername + Uri\Rfc3986\Uri::getUsername + + + + diff --git a/reference/uri/uri/whatwg/url/parse.xml b/reference/uri/uri/whatwg/url/parse.xml new file mode 100644 index 0000000000..51881881b1 --- /dev/null +++ b/reference/uri/uri/whatwg/url/parse.xml @@ -0,0 +1,118 @@ + + + + + Uri\WhatWg\Url::parse + Разбирает URL-адрес + + + + &reftitle.description; + + public static staticnullUri\WhatWg\Url::parse + stringuri + Uri\WhatWg\UrlnullbaseUrl&null; + arrayerrors&null; + + + Метод разбирает URL-адрес. + + + + + &reftitle.parameters; + + + uri + + + Допустимая строка URL-адреса для разбора, например: /foo или https://example.com/foo. + + + + + baseUrl + + + Базовый URL-адрес. При передаче объекта строка (&string;), которую передали в конструктор аргумента baseUrl, + интерпретируется как базовый адрес, а строка uri разбирается как остальная часть URI, + только если в параметр uri передали строку с относительным URL-адресом. + Метод проигнорирует аргумент baseUrl, + если в этот параметр передали &null; или в параметр uri передали не относительный URL-адрес. + + + + + errors + + + Переменная, которую метод по ссылке заполнит массивом (&array;) экземпляров Uri\WhatWg\UrlValidationError + с расширенной информацией о некритичных ошибках, которые возникли при разборе. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает объект Uri\WhatWg\Url, если выполнился успешно, или &null;, если возникла ошибка. + + + + + &reftitle.examples; + + Пример разбора URL-адреса методом <methodname>Uri\WhatWg\Url::parse</methodname> + +toAsciiString(); +} else { + echo "Недопустимый URL-адрес"; +} +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__construct + Uri\WhatWg\Url::resolve + Uri\Rfc3986\Uri::parse + + + + diff --git a/reference/uri/uri/whatwg/url/resolve.xml b/reference/uri/uri/whatwg/url/resolve.xml new file mode 100644 index 0000000000..f8a1bc6102 --- /dev/null +++ b/reference/uri/uri/whatwg/url/resolve.xml @@ -0,0 +1,108 @@ + + + + + Uri\WhatWg\Url::resolve + Разрешает URL-адрес на основе текущего объекта в роли базового URL + + + + &reftitle.description; + + public staticUri\WhatWg\Url::resolve + stringuri + arraysoftErrors&null; + + + Разрешает строку с допустимым абсолютным или относительным URL-адресом, при этом текущий объект интерпретируется как базовый URL. + + + + + &reftitle.parameters; + + + uri + + + Строка с допустимым URL-адресом наподобие /foo или https://example.com/foo + для разрешения с текущим объектом. + + + + + softErrors + + + Переменная, которую метод по ссылке заполнит массивом (&array;) экземпляров Uri\WhatWg\UrlValidationError + с расширенной информацией о некритичных ошибках, которые возникли при разборе. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример разрешения URL-адреса методом <methodname>Uri\WhatWg\Url::resolve</methodname> + +resolve("/foo"); + +echo $url->toAsciiString(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__construct + Uri\WhatWg\Url::parse + Uri\Rfc3986\Uri::resolve + + + + diff --git a/reference/uri/uri/whatwg/url/serialize.xml b/reference/uri/uri/whatwg/url/serialize.xml new file mode 100644 index 0000000000..5dcd10d45a --- /dev/null +++ b/reference/uri/uri/whatwg/url/serialize.xml @@ -0,0 +1,59 @@ + + + + + Uri\WhatWg\Url::__serialize + Сериализует объект Url + + + + &reftitle.description; + + public arrayUri\WhatWg\Url::__serialize + + + + Метод сериализует объект Uri\WhatWg\Url. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает сериализованное в массив (&array;) представление объекта URL-адреса. + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__unserialize + Uri\Rfc3986\Uri::__serialize + + + + diff --git a/reference/uri/uri/whatwg/url/toasciistring.xml b/reference/uri/uri/whatwg/url/toasciistring.xml new file mode 100644 index 0000000000..833e4e1298 --- /dev/null +++ b/reference/uri/uri/whatwg/url/toasciistring.xml @@ -0,0 +1,83 @@ + + + + + Uri\WhatWg\Url::toAsciiString + Пересобирает URL-адрес в ASCII-строку + + + + &reftitle.description; + + public stringUri\WhatWg\Url::toAsciiString + + + + Метод преобразовывает объект URL-адреса в ASCII-строку (&string;), при этом многобайтовые символы Юникода в хосте + транскрибируютcя в формат Punycode. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает пересобранный URL-адрес как ASCII-строку (&string;). + + + + + &reftitle.examples; + + Пример пересборки URL-адреса методом <methodname>Uri\WhatWg\Url::toAsciiString</methodname> + +toAsciiString(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::toUnicodeString + Uri\Rfc3986\Uri::toRawString + Uri\Rfc3986\Uri::toString + + + + diff --git a/reference/uri/uri/whatwg/url/tounicodestring.xml b/reference/uri/uri/whatwg/url/tounicodestring.xml new file mode 100644 index 0000000000..15ecfecaf4 --- /dev/null +++ b/reference/uri/uri/whatwg/url/tounicodestring.xml @@ -0,0 +1,83 @@ + + + + + Uri\WhatWg\Url::toUnicodeString + Пересобирает URL-адрес в Юникод-строку + + + + &reftitle.description; + + public stringUri\WhatWg\Url::toUnicodeString + + + + Метод преобразовывает объект URL-адреса в строку (&string;), при этом Punycode-представление хоста + транскрибируется в многобайтовые символы Юникода. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает пересобранный URL-адрес как Юникод-строку (&string;). + + + + + &reftitle.examples; + + Пример пересборки URL-адреса методом <methodname>Uri\WhatWg\Url::toUnicodeString</methodname> + +toUnicodeString(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::toAsciiString + Uri\Rfc3986\Uri::toRawString + Uri\Rfc3986\Uri::toString + + + + diff --git a/reference/uri/uri/whatwg/url/unserialize.xml b/reference/uri/uri/whatwg/url/unserialize.xml new file mode 100644 index 0000000000..e2bc261d96 --- /dev/null +++ b/reference/uri/uri/whatwg/url/unserialize.xml @@ -0,0 +1,78 @@ + + + + + Uri\WhatWg\Url::__unserialize + Десериализует массив из параметра data в объект Url + + + + &reftitle.description; + + public voidUri\WhatWg\Url::__unserialize + arraydata + + + Метод восстанавливает объект Uri\WhatWg\Url из массива, который передаётся в параметр data при десериализации. + + + + + &reftitle.parameters; + + + data + + + Сериализованное в массив array представление объекта URL-адреса. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + При вызове метода __unserialize на объекте URL-адреса выбрасывается + ошибка Error. + + + &uri.errors.invalidUriException; + + + + &reftitle.seealso; + + Uri\WhatWg\Url::__serialize + Uri\Rfc3986\Uri::__unserialize + + + + diff --git a/reference/uri/uri/whatwg/url/withfragment.xml b/reference/uri/uri/whatwg/url/withfragment.xml new file mode 100644 index 0000000000..7d3522efe7 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withfragment.xml @@ -0,0 +1,96 @@ + + + + + Uri\WhatWg\Url::withFragment + Копирует объект URL-адреса с новым компонентом «фрагмент» + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withFragment + stringnullfragment + + + Метод создаёт копию исходного объекта URL-адреса с новым фрагментом. + + + + + &reftitle.parameters; + + + fragment + + + Новый фрагмент. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новым фрагментом методом <methodname>Uri\WhatWg\Url::withFragment</methodname> + +withFragment("bar"); + +echo $url->getFragment(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getFragment + Uri\Rfc3986\Uri::withFragment + + + + diff --git a/reference/uri/uri/whatwg/url/withhost.xml b/reference/uri/uri/whatwg/url/withhost.xml new file mode 100644 index 0000000000..a3889271b5 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withhost.xml @@ -0,0 +1,97 @@ + + + + + Uri\WhatWg\Url::withHost + Копирует объект URL-адреса с новым хостом + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withHost + stringnullhost + + + Метод создаёт копию исходного объекта URL-адреса с новым хостом. + + + + + &reftitle.parameters; + + + host + + + Новый хост. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новым хостом методом <methodname>Uri\WhatWg\Url::withHost</methodname> + +withHost("example.net"); + +echo $url->getAsciiHost(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getAsciiHost + Uri\WhatWg\Url::getUnicodeHost + Uri\Rfc3986\Uri::withHost + + + + diff --git a/reference/uri/uri/whatwg/url/withpassword.xml b/reference/uri/uri/whatwg/url/withpassword.xml new file mode 100644 index 0000000000..16b280152a --- /dev/null +++ b/reference/uri/uri/whatwg/url/withpassword.xml @@ -0,0 +1,97 @@ + + + + + Uri\WhatWg\Url::withPassword + Копирует объект URL-адреса с новым паролем + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPassword + #[\SensitiveParameter]stringnullpassword + + + Метод создаёт копию исходного объекта URL-адреса с новым паролем. + + + + + &reftitle.parameters; + + + password + + + Новый пароль. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новым паролем методом <methodname>Uri\WhatWg\Url::withPassword</methodname> + +withPassword("pass"); + +echo $url->getPassword(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getPassword + Uri\WhatWg\Url::getUsername + Uri\Rfc3986\Uri::withUserInfo + + + + diff --git a/reference/uri/uri/whatwg/url/withpath.xml b/reference/uri/uri/whatwg/url/withpath.xml new file mode 100644 index 0000000000..7a396ff2fd --- /dev/null +++ b/reference/uri/uri/whatwg/url/withpath.xml @@ -0,0 +1,96 @@ + + + + + Uri\WhatWg\Url::withPath + Копирует объект URL-адреса с новым путём + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPath + stringpath + + + Метод создаёт копию исходного объекта URL-адреса с новым путём. + + + + + &reftitle.parameters; + + + path + + + Новый путь. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новым путём методом <methodname>Uri\WhatWg\Url::withPath</methodname> + +withPath("/baz"); + +echo $url->getPath(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getPath + Uri\Rfc3986\Uri::withPath + + + + diff --git a/reference/uri/uri/whatwg/url/withport.xml b/reference/uri/uri/whatwg/url/withport.xml new file mode 100644 index 0000000000..ef8fc40ccb --- /dev/null +++ b/reference/uri/uri/whatwg/url/withport.xml @@ -0,0 +1,96 @@ + + + + + Uri\WhatWg\Url::withPort + Копирует объект URL-адреса с новым портом + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withPort + intnullport + + + Метод создаёт копию исходного объекта URL-адреса с новым портом. + + + + + &reftitle.parameters; + + + port + + + Новый порт. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новым портом методом <methodname>Uri\WhatWg\Url::withPort</methodname> + +withPort(443); + +echo $url->getPort(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getPort + Uri\Rfc3986\Uri::withPort + + + + diff --git a/reference/uri/uri/whatwg/url/withquery.xml b/reference/uri/uri/whatwg/url/withquery.xml new file mode 100644 index 0000000000..f0e7a5c9ee --- /dev/null +++ b/reference/uri/uri/whatwg/url/withquery.xml @@ -0,0 +1,96 @@ + + + + + Uri\WhatWg\Url::withQuery + Копирует объект URL-адреса с новыми аргументами запроса + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withQuery + stringnullquery + + + Метод создаёт копию исходного объекта URL-адреса с новыми аргументами запроса. + + + + + &reftitle.parameters; + + + query + + + Новые аргументы запроса. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новыми аргументами запроса методом <methodname>Uri\WhatWg\Url::withQuery</methodname> + +withQuery("foo=baz"); + +echo $url->getQuery(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getQuery + Uri\Rfc3986\Uri::withQuery + + + + diff --git a/reference/uri/uri/whatwg/url/withscheme.xml b/reference/uri/uri/whatwg/url/withscheme.xml new file mode 100644 index 0000000000..721d1f4a64 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withscheme.xml @@ -0,0 +1,96 @@ + + + + + Uri\WhatWg\Url::withScheme + Копирует объект URL-адреса с новой схемой + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withScheme + stringscheme + + + Метод создаёт копию исходного объекта URL-адреса с новой схемой. + + + + + &reftitle.parameters; + + + scheme + + + Новая схема. + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новой схемой методом <methodname>Uri\WhatWg\Url::withScheme</methodname> + +withScheme("http"); + +echo $url->getScheme(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getScheme + Uri\Rfc3986\Uri::withScheme + + + + diff --git a/reference/uri/uri/whatwg/url/withusername.xml b/reference/uri/uri/whatwg/url/withusername.xml new file mode 100644 index 0000000000..3faa84ff94 --- /dev/null +++ b/reference/uri/uri/whatwg/url/withusername.xml @@ -0,0 +1,98 @@ + + + + + Uri\WhatWg\Url::withUsername + Копирует объект URL-адреса с новым именем пользователя + + + + &reftitle.description; + + public staticUri\WhatWg\Url::withUsername + stringnullusername + + + Метод создаёт копию исходного объекта URL-адреса с новым именем пользователя. + + + + + &reftitle.parameters; + + + username + + + Новое имя пользователя. + + + + + + + + + &reftitle.returnvalues; + + Метод возвращает новый объект Uri\WhatWg\Url. + + + + + &reftitle.errors; + &uri.errors.invalidUrlException; + + + + &reftitle.examples; + + Пример копирования объекта URL-адреса с новым именем пользователя методом <methodname>Uri\WhatWg\Url::withUsername</methodname> + +withUsername("usr"); + +echo $url->getUsername(); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + Uri\WhatWg\Url::getUsername + Uri\WhatWg\Url::getPassword + Uri\Rfc3986\Uri::withUserInfo + + + +