PHP: полный мануал с примерами, функциями и ООП

PHP 8.5.0+ · uri

getScheme(): ?string

Проверить протокол ссылки каталога до дальнейшей обработки.

Запись getScheme(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('HTTPS://Shop.Example/p');
$value = $address->getScheme();
echo $value, "\n";

https

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('//shop.example/p');
echo $u->getScheme() === null ? "Нужна базовая схема\n" : "Схема есть\n";

Нужна базовая схема

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawScheme.

• PHP: Uri\Rfc3986\Uri::getScheme
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawScheme(): ?string

Показать, как автор исходной ссылки записал схему.

Запись getRawScheme(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('HTTPS://shop.example/p');
$value = $address->getRawScheme();
echo $value, "\n";

HTTPS

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('HtTpS://shop.example/p');
echo $u->getRawScheme(), ' -> ', $u->getScheme(), "\n";

HtTpS -> https

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getScheme.

• PHP: Uri\Rfc3986\Uri::getRawScheme
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getHost(): ?string

Выделить нормализованное имя узла ссылки, не спутать его с пользователем.

Запись getHost(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://trusted.example@Shop.Example/p');
$value = $address->getHost();
echo $value, "\n";

shop.example

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('mailto:sales@shop.example');
echo $u->getHost() === null ? "Host отсутствует\n" : $u->getHost();
echo $u->getPath(), "\n";

Host отсутствует
sales@shop.example

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawHost.

• PHP: Uri\Rfc3986\Uri::getHost
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawHost(): ?string

Сопоставить введённое написание домена с нормализованным.

Запись getRawHost(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://Sh%6fp.Example/p');
$value = $address->getRawHost();
echo $value, "\n";

Sh%6fp.Example

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://[2001:DB8::1]/');
echo $u->getRawHost(), "\n", $u->getHost(), "\n";

[2001:DB8::1]
[2001:db8::1]

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getHost.

• PHP: Uri\Rfc3986\Uri::getRawHost
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getPath(): string

Получить маршрут карточки после устранения навигационных сегментов.

Запись getPath(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/catalog/../%7ecard');
$value = $address->getPath();
echo $value, "\n";

/~card

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/items/a%2fb');
echo $u->getPath(), "\n";
echo $u->getPath() === '/items/a/b' ? "два сегмента\n" : "кодированный разделитель сохранён\n";

/items/a%2Fb
кодированный разделитель сохранён

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawPath.

• PHP: Uri\Rfc3986\Uri::getPath
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawPath(): string

Разобрать, почему две входные ссылки выглядят по-разному.

Запись getRawPath(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/catalog/../%7ecard');
$value = $address->getRawPath();
echo $value, "\n";

/catalog/../%7ecard

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/a/../price%20list');
echo $u->getRawPath(), "\n", $u->getPath(), "\n";

/a/../price%20list
/price%20list

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getPath.

• PHP: Uri\Rfc3986\Uri::getRawPath
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getQuery(): ?string

Отделить параметры поиска от маршрута и якоря.

Запись getQuery(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/find?q=%7etool&part=a%2fb#top');
$value = $address->getQuery();
echo $value, "\n";

q=~tool&part=a%2Fb

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

foreach (['https://shop.example/p', 'https://shop.example/p?', 'https://shop.example/p?0'] as $s) {
    $q = (new Uri($s))->getQuery();
    echo $q === null ? 'отсутствует' : ($q === '' ? 'пустой' : $q), "\n";
}

отсутствует
пустой
0

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawQuery.

• PHP: Uri\Rfc3986\Uri::getQuery
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawQuery(): ?string

Сохранить написание query для проверки подписанного адреса.

Запись getRawQuery(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/find?q=%7etool&part=a%2fb');
$value = $address->getRawQuery();
echo $value, "\n";

q=%7etool&part=a%2fb

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/find?q=a+b&q=a%20b');
echo $u->getRawQuery(), "\n";
echo $u->getQuery(), "\n";

q=a+b&q=a%20b
q=a+b&q=a%20b

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getQuery.

• PHP: Uri\Rfc3986\Uri::getRawQuery
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getFragment(): ?string

Получить имя раздела для локальной навигации справочника.

Запись getFragment(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/help#%64elivery');
$value = $address->getFragment();
echo $value, "\n";

delivery

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/help#part%2f2');
echo $u->getFragment(), "\n";
echo $u->withFragment(null)->toString(), "\n";

part%2F2
https://shop.example/help

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawFragment.

• PHP: Uri\Rfc3986\Uri::getFragment
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawFragment(): ?string

Показать исходное кодирование якоря из импортированной ссылки.

Запись getRawFragment(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/help#%64elivery');
$value = $address->getRawFragment();
echo $value, "\n";

%64elivery

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/help#part%2f2');
echo $u->getRawFragment(), ' -> ', $u->getFragment(), "\n";

part%2f2 -> part%2F2

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getFragment.

• PHP: Uri\Rfc3986\Uri::getRawFragment
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getUsername(): ?string

Распознать встроенные учётные данные перед показом ссылки.

Запись getUsername(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://%61nna:demo@shop.example/p');
$value = $address->getUsername();
echo $value, "\n";

anna

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

foreach (['https://shop.example/', 'https://:demo@shop.example/'] as $s) {
    $name = (new Uri($s))->getUsername();
    echo $name === null ? 'userinfo отсутствует' : ($name === '' ? 'имя пустое' : $name), "\n";
}

userinfo отсутствует
имя пустое

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawUsername.

• PHP: Uri\Rfc3986\Uri::getUsername
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawUsername(): ?string

Разобрать исходную запись логина в диагностическом стенде.

Запись getRawUsername(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://%61nna:demo@shop.example/');
$value = $address->getRawUsername();
echo $value, "\n";

%61nna

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://team%3Awest:demo@shop.example/');
echo $u->getRawUsername(), "\n", $u->getUsername(), "\n";

team%3Awest
team%3Awest

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getUsername.

• PHP: Uri\Rfc3986\Uri::getRawUsername
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getPassword(): ?string

Проверить наличие пароля в импортированной ссылке без его публикации.

Запись getPassword(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://anna:d%65mo@shop.example/');
$value = $address->getPassword();
echo $value, "\n";

demo

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

foreach (['https://shop.example/', 'https://anna@shop.example/'] as $s) {
    $password = (new Uri($s))->getPassword();
    echo $password === null ? 'userinfo отсутствует' : ($password === '' ? 'пароль пустой' : 'пароль задан'), "\n";
}

userinfo отсутствует
пароль пустой

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawPassword.

• PHP: Uri\Rfc3986\Uri::getPassword
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawPassword(): ?string

Проверить кодирование тестового пароля, не меняя его структуру.

Запись getRawPassword(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://anna:d%65mo@shop.example/');
$value = $address->getRawPassword();
echo $value, "\n";

d%65mo

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://anna:demo%3Awest@shop.example/');
echo $u->getRawPassword(), "\n", $u->getPassword(), "\n";

demo%3Awest
demo%3Awest

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getPassword.

• PHP: Uri\Rfc3986\Uri::getRawPassword
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getUserInfo(): ?string

Удалить весь блок учётных данных, не перепутав его с host.

Запись getUserInfo(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://%61nna:d%65mo@shop.example/');
$value = $address->getUserInfo();
echo $value, "\n";

anna:demo

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://anna:demo@shop.example/p');
echo $u->getUserInfo() !== null ? "Нужна очистка\n" : "Без userinfo\n";
echo $u->withUserInfo(null)->toString(), "\n";

Нужна очистка
https://shop.example/p

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getRawUserInfo.

• PHP: Uri\Rfc3986\Uri::getUserInfo
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getRawUserInfo(): ?string

Сопоставить исходный и нормализованный блок учётных данных на фиктивной строке.

Запись getRawUserInfo(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://%61nna:d%65mo@shop.example/');
$value = $address->getRawUserInfo();
echo $value, "\n";

%61nna:d%65mo

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://team%3Awest:demo@shop.example/');
echo $u->getRawUserInfo(), "\n", $u->getUsername(), "\n";

team%3Awest:demo
team%3Awest

Raw-компоненты не предназначены для обхода валидации. Для полного архива сохраняйте исходный текст отдельно; относительная база и последующие with-вызовы уже меняют адрес.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getUserInfo.

• PHP: Uri\Rfc3986\Uri::getRawUserInfo
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getPort(): ?int

Показать явно записанный порт учебного сервиса.

Запись getPort(): ?int описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example:08443/p');
$value = $address->getPort();
echo $value, "\n";

8443

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example:70000/');
$port = $u->getPort();
echo $port, "\n";
echo $port !== null && $port > 65535 ? "Не сетевой порт TCP/UDP\n" : "В диапазоне\n";

70000
Не сетевой порт TCP/UDP

Нормализация RFC: схема/host в нижний регистр; hex в %-последовательностях в верхний; percent-encoded unreserved ASCII раскодируются; в пути убираются сегменты «.» и «..». Зарезервированный %2F не превращается в разделитель /. Это не полная URL-декодировка и не проверка доступности сервера.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::getPort
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getScheme(): string

Определить схему готовой браузерной ссылки.

Запись getScheme(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('HTTPS://shop.example/p');
$value = $address->getScheme();
echo $value, "\n";

https

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('mailto:sales@shop.example');
echo $u->getScheme() === 'https' ? "Веб-ссылка\n" : "Другая схема\n";

Другая схема

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getScheme
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getAsciiHost(): ?string

Получить форму международного домена для машинного сравнения.

Запись getAsciiHost(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://пример.рф/catalog');
$value = $address->getAsciiHost();
echo $value, "\n";

xn--e1afmkfd.xn--p1ai

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('http://0x7f.1/');
echo $u->getAsciiHost(), "\n";
echo (new Url('mailto:sales@shop.example'))->getAsciiHost() === null ? "Нет host\n" : "Есть host\n";

127.0.0.1
Нет host

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getAsciiHost
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getUnicodeHost(): ?string

Показать человеку международный домен, сохранив машинную форму рядом.

Запись getUnicodeHost(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://xn--e1afmkfd.xn--p1ai/p');
$value = $address->getUnicodeHost();
echo $value, "\n";

пример.рф

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://пример.рф/p');
echo $u->getUnicodeHost(), "\n", $u->getAsciiHost(), "\n";

пример.рф
xn--e1afmkfd.xn--p1ai

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getUnicodeHost
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getPath(): string

Выделить маршрут карточки после браузерного разбора.

Запись getPath(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://shop.example/a/../price%20list');
$value = $address->getPath();
echo $value, "\n";

/price%20list

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/%7ecard/a%2fb');
echo $u->getPath(), "\n";
echo (new Url('https://shop.example'))->getPath(), "\n";

/%7ecard/a%2fb
/

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getPath
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getQuery(): ?string

Извлечь строку поисковых параметров без смешения с якорем.

Запись getQuery(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://shop.example/find?q=%7etool&part=a%2fb#top');
$value = $address->getQuery();
echo $value, "\n";

q=%7etool&part=a%2fb

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

foreach (['https://shop.example/p', 'https://shop.example/p?', 'https://shop.example/p?0'] as $s) {
    $q = (new Url($s))->getQuery();
    echo $q === null ? 'отсутствует' : ($q === '' ? 'пустой' : $q), "\n";
}

отсутствует
пустой
0

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getQuery
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getFragment(): ?string

Получить браузерный якорь для карточки раздела.

Запись getFragment(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://shop.example/help#part%202');
$value = $address->getFragment();
echo $value, "\n";

part%202

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/help#%64elivery');
echo $u->getFragment(), "\n";
echo $u->withFragment(null)->toAsciiString(), "\n";

%64elivery
https://shop.example/help

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getFragment
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getUsername(): ?string

Определить, что ссылка содержит встроенное имя пользователя.

Запись getUsername(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://%61nna:demo@shop.example/');
$value = $address->getUsername();
echo $value, "\n";

%61nna

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

foreach (['https://@shop.example/', 'https://:demo@shop.example/'] as $s) {
    $name = (new Url($s))->getUsername();
    echo $name === null ? 'credentials отсутствуют' : ($name === '' ? 'имя пустое' : 'имя задано'), "\n";
}

credentials отсутствуют
имя пустое

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getUsername
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getPassword(): ?string

Отметить пароль в импортируемой ссылке и скрыть его в отчёте.

Запись getPassword(): ?string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://anna:d%65mo@shop.example/');
$value = $address->getPassword();
echo $value, "\n";

d%65mo

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

foreach (['https://shop.example/', 'https://anna@shop.example/'] as $s) {
    $password = (new Url($s))->getPassword();
    echo $password === null ? 'нет credentials' : ($password === '' ? 'пароль пустой' : 'пароль скрыт'), "\n";
}

нет credentials
пароль пустой

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getPassword
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

getPort(): ?int

Различить стандартный и явно нестандартный порт веб-сервиса.

Запись getPort(): ?int описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://shop.example:8443/p');
$value = $address->getPort();
echo $value, "\n";

8443

Теперь проверим границу, важную при обработке импортированных ссылок. В следующем примере === сравнивает значение вместе с типом; foreach, если используется, проходит по небольшому списку адресов.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

foreach (['https://shop.example:443/', 'http://shop.example:80/', 'https://shop.example:8443/'] as $s) {
    $u = new Url($s);
    echo $u->getPort() === null ? 'стандартный/не указан' : $u->getPort(), "\n";
}

стандартный/не указан
стандартный/не указан
8443

Это компоненты WHATWG URL, а не необработанный ввод. Канонизация уже произошла при создании. Возвращённую строку нельзя автоматически считать безопасной для HTML, shell или исходящего HTTP-запроса.

Практика: замените адрес на ссылку вашего учебного каталога без учётных данных, предскажите значение этого компонента и проверьте его. Не обращайтесь к сети: сравните только строки.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::getPort
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__construct(string $uri, ?Uri\Rfc3986\Uri $baseUrl = null)

Разобрать ссылку один раз и затем работать с её компонентами.

Запись __construct(string $uri, ?Uri\Rfc3986\Uri $baseUrl = null) описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$address = new Uri('https://shop.example/help/delivery');
echo $address->getHost(), "\n";

shop.example

Относительная ссылка имеет смысл в контексте другой страницы. Последний сегмент базового URL без завершающего / считается именем ресурса. Следующий вызов не читает ни файл, ни сайт.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$base = new Uri('https://shop.example/catalog/tools/list');
$card = new Uri('../drill', $base);
echo $card->toString(), "\n";
echo $base->toString(), "\n";

https://shop.example/catalog/drill
https://shop.example/catalog/tools/list

Повторно вызывать __construct на готовом readonly объекте нельзя: Error. Создайте другой объект или используйте with-метод. Ошибка PHP-типа даёт TypeError, а не null. Перед первым вызовом на старом PHP проверьте class_exists; библиотека присутствует с PHP 8.5.0.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::parse, Uri\Rfc3986\Uri::resolve.

• PHP: Uri\Rfc3986\Uri::__construct
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

static parse(string $uri, ?Uri\Rfc3986\Uri $baseUrl = null): ?static

Проверить массовый импорт ссылок, где неправильная запись ожидаема.

Запись static parse(string $uri, ?Uri\Rfc3986\Uri $baseUrl = null): ?static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$candidate = Uri::parse('https://shop.example/help');
if ($candidate !== null) {
    echo $candidate->toString(), "\n";
} else {
    echo "Исправьте адрес\n";
}

https://shop.example/help

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

foreach (['https://shop.example/%ZZ', '../help'] as $text) {
    $u = Uri::parse($text);
    echo $u === null ? 'ошибка синтаксиса' : $u->toString(), "\n";
}

ошибка синтаксиса
../help

Следующий шаг: решите заранее, допустимы ли относительные ссылки и автоматические исправления. Не заменяйте null исходной непроверенной строкой, если дальше ожидается проверенный объект.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::__construct.

• PHP: Uri\Rfc3986\Uri::parse
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

resolve(string $uri): static

Восстановить полную ссылку из относительной записи HTML или конфигурации.

Запись resolve(string $uri): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$page = new Uri('https://shop.example/help/start');
$delivery = $page->resolve('delivery');
echo $delivery->toString(), "\n";

https://shop.example/help/delivery

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$base = new Uri('https://shop.example/help/');
foreach (['delivery', '/catalog', '//cdn.example/image.png'] as $text) {
    echo $base->resolve($text)->toString(), "\n";
}

https://shop.example/help/delivery
https://shop.example/catalog
https://cdn.example/image.png

База должна быть абсолютной. Относительный объект Uri допустим как значение, но вызов resolve у такого объекта даёт Uri\InvalidUriException. Не путайте нормализацию . и .. с существованием каталогов на диске.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::__construct, Uri\Rfc3986\Uri::withPath.

• PHP: Uri\Rfc3986\Uri::resolve
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

equals(Uri\Rfc3986\Uri $uri, Uri\UriComparisonMode $comparisonMode = Uri\UriComparisonMode::ExcludeFragment): bool

Убрать дубликаты ссылок по явно выбранному правилу fragment.

Запись equals(Uri\Rfc3986\Uri $uri, Uri\UriComparisonMode $comparisonMode = Uri\UriComparisonMode::ExcludeFragment): bool описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$a = new Uri('https://shop.example/help#payment');
$b = new Uri('https://shop.example/help#delivery');
echo $a->equals($b) ? "Один ресурс\n" : "Разные адреса\n";
echo $a->equals($b, \Uri\UriComparisonMode::IncludeFragment) ? "Один якорь\n" : "Разные якоря\n";

Один ресурс
Разные якоря

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$a = new Uri('https://shop.example:443/');
$b = new Uri('https://shop.example/');
echo $a->equals($b) ? "эквивалентны\n" : "различаются\n";

различаются

equals сравнивает нормализованные сериализации выбранного класса, с учётом режима fragment. Это не === (тождество объектов), не DNS, не сравнение содержимого сайта. Порядок query-пар не сортируется; HTTP-сервер может придавать ему значение.

Перед первым запуском: как устроен вызов и что он проверяет.

• PHP: Uri\Rfc3986\Uri::equals
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

toString(): string

Подготовить разобранный адрес к хранению или отображению в нужной форме.

Запись toString(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('HTTPS://Shop.Example/a/../%7ecard');
echo $u->toString(), "\n";

https://shop.example/~card

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://[2001:DB8::1]/');
echo $u->toString(), "\n";

https://[2001:0db8:0000:0000:0000:0000:0000:0001]/

У этих классов нет __toString: используйте явный метод вместо echo $u или (string) $u. Полученная строка может содержать credentials, query-токены и персональные данные. Полный var_dump/журнал допустим только на фиктивных тестовых адресах.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::toRawString.

• PHP: Uri\Rfc3986\Uri::toString
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

toRawString(): string

Подготовить разобранный адрес к хранению или отображению в нужной форме.

Запись toRawString(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('HTTPS://Shop.Example/a/../%7ecard');
echo $u->toRawString(), "\n";

HTTPS://Shop.Example/a/../%7ecard

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://[2001:DB8::1]/');
echo $u->toRawString(), "\n";

https://[2001:0db8:0000:0000:0000:0000:0000:0001]/

У этих классов нет __toString: используйте явный метод вместо echo $u или (string) $u. Полученная строка может содержать credentials, query-токены и персональные данные. Полный var_dump/журнал допустим только на фиктивных тестовых адресах.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::toRawString
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__debugInfo(): array

Разобрать локальную ошибку, не отдавая полный URI пользователю.

Запись __debugInfo(): array описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example:8443/p?q=1#top');
$state = $u->__debugInfo();
echo $state['host'], "\n", $state['port'], "\n";

shop.example
8443

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://anna:demo@shop.example/p?token=demo');
$state = $u->__debugInfo();
echo $state['scheme'], '://', $state['host'], "\n";
echo array_key_exists('password', $state) ? "Полный dump содержит поле пароля\n" : "Нет поля\n";

https://shop.example
Полный dump содержит поле пароля

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getScheme.

• PHP: Uri\Rfc3986\Uri::__debugInfo
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__serialize(): array

Поддержать локальное сохранение объекта стандартным механизмом PHP.

Запись __serialize(): array описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/help');
$data = $u->__serialize();
echo is_array($data) ? "Массив состояния\n" : "Другой тип\n";
echo $u->toString(), "\n";

Массив состояния
https://shop.example/help

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/help#delivery');
$bytes = serialize($u);
$copy = unserialize($bytes, ['allowed_classes' => [Uri::class]]);
echo $copy instanceof Uri && $copy->equals($u, \Uri\UriComparisonMode::IncludeFragment) ? "Адрес восстановлен\n" : "Ошибка\n";
echo $copy === $u ? "Тот же объект\n" : "Другой объект\n";

Адрес восстановлен
Другой объект

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::__unserialize.

• PHP: Uri\Rfc3986\Uri::__serialize
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__unserialize(array $data): void

Понять восстановление состояния и корректно обработать его отказ.

Запись __unserialize(array $data): void описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$saved = serialize(new Uri('https://shop.example/help'));
$restored = unserialize($saved, ['allowed_classes' => [Uri::class]]);
if ($restored instanceof Uri) {
    echo $restored->toString(), "\n";
}

https://shop.example/help

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/help');
try {
    $u->__unserialize($u->__serialize());
} catch (Throwable $e) {
    echo $e::class, "\n";
    echo $e->getPrevious() instanceof Error ? "Предыдущая причина: Error\n" : "Другая причина\n";
}
echo $u->toString(), "\n";

Exception
Предыдущая причина: Error
https://shop.example/help

Текущая страница PHP.net описывает Error для повторного вызова и InvalidUriException для неправильного URI. Tagged PHP 8.5.11 в этом hook оборачивает readonly Error в Exception, а неправильную структуру/URI отклоняет обычным Exception. Это версионное расхождение явно отделено от правил parse/конструктора. При неверном типе $data возникает TypeError. Не собирайте сериализованные payload из внешнего ввода.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::__serialize, Uri\Rfc3986\Uri::parse.

• PHP: Uri\Rfc3986\Uri::__unserialize
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__construct(string $uri, ?Uri\WhatWg\Url $baseUrl = null, &$softErrors = null)

Разобрать ссылку один раз и затем работать с её компонентами.

Запись __construct(string $uri, ?Uri\WhatWg\Url $baseUrl = null, &$softErrors = null) описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$address = new Url('https://shop.example/help/delivery');
echo $address->getAsciiHost(), "
";

shop.example

Относительная ссылка имеет смысл в контексте другой страницы. Последний сегмент базового URL без завершающего / считается именем ресурса. Следующий вызов не читает ни файл, ни сайт.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$base = new Url('https://shop.example/catalog/tools/list');
$card = new Url('../drill', $base);
echo $card->toAsciiString(), "\n";
echo $base->toAsciiString(), "\n";

https://shop.example/catalog/drill
https://shop.example/catalog/tools/list

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$warnings = [];
$u = new Url('https:shop.example', null, $warnings);
echo $u->toAsciiString(), "\n";
echo $warnings[0]->type->name, ':', $warnings[0]->failure ? 'hard' : 'soft', "\n";

https://shop.example/
SpecialSchemeMissingFollowingSolidus:soft

Повторно вызывать __construct на готовом readonly объекте нельзя: Error. Создайте другой объект или используйте with-метод. Ошибка PHP-типа даёт TypeError, а не null. Перед первым вызовом на старом PHP проверьте class_exists; библиотека присутствует с PHP 8.5.0.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::parse, Uri\WhatWg\Url::resolve.

• PHP: Uri\WhatWg\Url::__construct
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

static parse(string $uri, ?Uri\WhatWg\Url $baseUrl = null, &$errors = null): ?static

Проверить массовый импорт ссылок, где неправильная запись ожидаема.

Запись static parse(string $uri, ?Uri\WhatWg\Url $baseUrl = null, &$errors = null): ?static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$candidate = Url::parse('https://shop.example/help');
if ($candidate !== null) {
    echo $candidate->toAsciiString(), "\n";
} else {
    echo "Исправьте адрес\n";
}

https://shop.example/help

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$errors = [];
$candidate = Url::parse('https://shop.example:70000/', null, $errors);
echo $candidate === null ? "Адрес отклонён\n" : "Адрес принят\n";
echo $errors[0]->type->name, ':', $errors[0]->failure ? 'hard' : 'soft', "\n";

Адрес отклонён
PortOutOfRange:hard

Следующий шаг: решите заранее, допустимы ли относительные ссылки и автоматические исправления. Не заменяйте null исходной непроверенной строкой, если дальше ожидается проверенный объект.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::__construct.

• PHP: Uri\WhatWg\Url::parse
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

resolve(string $uri, &$softErrors = null): static

Восстановить полную ссылку из относительной записи HTML или конфигурации.

Запись resolve(string $uri, &$softErrors = null): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$page = new Url('https://shop.example/help/start');
$delivery = $page->resolve('delivery');
echo $delivery->toAsciiString(), "\n";

https://shop.example/help/delivery

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$base = new Url('https://shop.example/help/');
foreach (['delivery', '/catalog', '//cdn.example/image.png'] as $text) {
    echo $base->resolve($text)->toAsciiString(), "\n";
}

https://shop.example/help/delivery
https://shop.example/catalog
https://cdn.example/image.png

Вторая необязательная &$softErrors работает как третий аргумент конструктора: успешный результат со списком исправлений, а при исключении диагностика находится в errors самого исключения. Opaque-база mailto не умеет разрешать обычный дочерний путь; fragment-ссылка имеет отдельные правила WHATWG.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::__construct, Uri\WhatWg\Url::withPath.

• PHP: Uri\WhatWg\Url::resolve
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

equals(Uri\WhatWg\Url $url, Uri\UriComparisonMode $comparisonMode = Uri\UriComparisonMode::ExcludeFragment): bool

Убрать дубликаты ссылок по явно выбранному правилу fragment.

Запись equals(Uri\WhatWg\Url $url, Uri\UriComparisonMode $comparisonMode = Uri\UriComparisonMode::ExcludeFragment): bool описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$a = new Url('https://shop.example/help#payment');
$b = new Url('https://shop.example/help#delivery');
echo $a->equals($b) ? "Один ресурс\n" : "Разные адреса\n";
echo $a->equals($b, \Uri\UriComparisonMode::IncludeFragment) ? "Один якорь\n" : "Разные якоря\n";

Один ресурс
Разные якоря

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$a = new Url('https://shop.example:443/');
$b = new Url('https://shop.example/');
echo $a->equals($b) ? "эквивалентны\n" : "различаются\n";

эквивалентны

equals сравнивает нормализованные сериализации выбранного класса, с учётом режима fragment. Это не === (тождество объектов), не DNS, не сравнение содержимого сайта. Порядок query-пар не сортируется; HTTP-сервер может придавать ему значение.

Перед первым запуском: как устроен вызов и что он проверяет.

• PHP: Uri\WhatWg\Url::equals
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

toAsciiString(): string

Подготовить разобранный адрес к хранению или отображению в нужной форме.

Запись toAsciiString(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://пример.рф/price%20list?q=%7e');
echo $u->toAsciiString(), "\n";

https://xn--e1afmkfd.xn--p1ai/price%20list?q=%7e

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/catalog?size=M&color=blue');
echo htmlspecialchars($u->toAsciiString(), ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";

https://shop.example/catalog?size=M&color=blue

У этих классов нет __toString: используйте явный метод вместо echo $u или (string) $u. Полученная строка может содержать credentials, query-токены и персональные данные. Полный var_dump/журнал допустим только на фиктивных тестовых адресах.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toUnicodeString.

• PHP: Uri\WhatWg\Url::toAsciiString
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

toUnicodeString(): string

Подготовить разобранный адрес к хранению или отображению в нужной форме.

Запись toUnicodeString(): string описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://пример.рф/price%20list?q=%7e');
echo $u->toUnicodeString(), "\n";

https://пример.рф/price%20list?q=%7e

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/catalog?size=M&color=blue');
echo htmlspecialchars($u->toUnicodeString(), ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";

https://shop.example/catalog?size=M&color=blue

У этих классов нет __toString: используйте явный метод вместо echo $u или (string) $u. Полученная строка может содержать credentials, query-токены и персональные данные. Полный var_dump/журнал допустим только на фиктивных тестовых адресах.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::toUnicodeString
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__debugInfo(): array

Разобрать локальную ошибку, не отдавая полный URI пользователю.

Запись __debugInfo(): array описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example:8443/p?q=1#top');
$state = $u->__debugInfo();
echo $state['host'], "\n", $state['port'], "\n";

shop.example
8443

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://anna:demo@shop.example/p?token=demo');
$state = $u->__debugInfo();
echo $state['scheme'], '://', $state['host'], "\n";
echo array_key_exists('password', $state) ? "Полный dump содержит поле пароля\n" : "Нет поля\n";

https://shop.example
Полный dump содержит поле пароля

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getScheme.

• PHP: Uri\WhatWg\Url::__debugInfo
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__serialize(): array

Поддержать локальное сохранение объекта стандартным механизмом PHP.

Запись __serialize(): array описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/help');
$data = $u->__serialize();
echo is_array($data) ? "Массив состояния\n" : "Другой тип\n";
echo $u->toAsciiString(), "\n";

Массив состояния
https://shop.example/help

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/help#delivery');
$bytes = serialize($u);
$copy = unserialize($bytes, ['allowed_classes' => [Url::class]]);
echo $copy instanceof Url && $copy->equals($u, \Uri\UriComparisonMode::IncludeFragment) ? "Адрес восстановлен\n" : "Ошибка\n";
echo $copy === $u ? "Тот же объект\n" : "Другой объект\n";

Адрес восстановлен
Другой объект

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::__unserialize.

• PHP: Uri\WhatWg\Url::__serialize
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__unserialize(array $data): void

Понять восстановление состояния и корректно обработать его отказ.

Запись __unserialize(array $data): void описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$saved = serialize(new Url('https://shop.example/help'));
$restored = unserialize($saved, ['allowed_classes' => [Url::class]]);
if ($restored instanceof Url) {
    echo $restored->toAsciiString(), "\n";
}

https://shop.example/help

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/help');
try {
    $u->__unserialize($u->__serialize());
} catch (Throwable $e) {
    echo $e::class, "\n";
    echo $e->getPrevious() instanceof Error ? "Предыдущая причина: Error\n" : "Другая причина\n";
}
echo $u->toAsciiString(), "\n";

Exception
Предыдущая причина: Error
https://shop.example/help

Текущая страница PHP.net описывает Error для повторного вызова и InvalidUriException для неправильного URI. Tagged PHP 8.5.11 в этом hook оборачивает readonly Error в Exception, а неправильную структуру/URI отклоняет обычным Exception. Это версионное расхождение явно отделено от правил parse/конструктора. При неверном типе $data возникает TypeError. Не собирайте сериализованные payload из внешнего ввода.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::__serialize, Uri\WhatWg\Url::parse.

• PHP: Uri\WhatWg\Url::__unserialize
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withScheme(?string $scheme): static

Перевести подготовленную ссылку каталога на другую схему.

Запись withScheme(?string $scheme): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('http://shop.example/p');
$changed = $original->withScheme('https');
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://shop.example/p
http://shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/p');
echo $u->withScheme(null)->toString(), "\n";
try { $u->withScheme(''); } catch (\Uri\InvalidUriException $e) { echo "Пустая схема отклонена\n"; }

//shop.example/p
Пустая схема отклонена

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getScheme, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withScheme
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withHost(?string $host): static

Подготовить ссылку на зеркальный каталог.

Запись withHost(?string $host): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('https://shop.example/p');
$changed = $original->withHost('cdn.example');
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://cdn.example/p
https://shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example:8443/p');
try { $u->withHost(null); } catch (\Uri\InvalidUriException $e) { echo "Сначала удалите порт\n"; }
echo $u->withPort(null)->withHost(null)->toString(), "\n";

Сначала удалите порт
https:/p

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getHost, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withHost
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withPath(string $path): static

Получить ссылку на файл прайс-листа, не меняя host.

Запись withPath(string $path): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('https://shop.example/old');
$changed = $original->withPath('/price%20list.csv');
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://shop.example/price%20list.csv
https://shop.example/old

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/old');
$file = 'drill set';
echo $u->withPath('/items/' . rawurlencode($file))->toString(), "\n";
try { $u->withPath('/one two'); } catch (\Uri\InvalidUriException $e) { echo "Пробел нужно кодировать\n"; }

https://shop.example/items/drill%20set
Пробел нужно кодировать

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getPath, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withPath
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withPort(?int $port): static

Настроить адрес тестового сервиса на отдельный порт.

Запись withPort(?int $port): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('https://shop.example/p');
$changed = $original->withPort(8443);
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://shop.example:8443/p
https://shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example:8443/p');
echo $u->withPort(null)->toString(), "\n";
try { $u->withPort(-1); } catch (\Uri\InvalidUriException $e) { echo "Отрицательный порт отклонён\n"; }

https://shop.example/p
Отрицательный порт отклонён

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getPort, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withPort
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withQuery(?string $query): static

Построить ссылку на отфильтрованный каталог.

Запись withQuery(?string $query): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('https://shop.example/catalog');
$changed = $original->withQuery('category=tools&page=2');
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://shop.example/catalog?category=tools&page=2
https://shop.example/catalog

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/find?q=old');
$query = http_build_query(['q' => 'drill set', 'page' => 2], '', '&', PHP_QUERY_RFC3986);
echo $u->withQuery($query)->toString(), "\n";
echo $u->withQuery('')->toString(), "\n";
echo $u->withQuery(null)->toString(), "\n";

https://shop.example/find?q=drill%20set&page=2
https://shop.example/find?
https://shop.example/find

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getQuery, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withQuery
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withFragment(?string $fragment): static

Дать ссылку на раздел доставки внутри справки.

Запись withFragment(?string $fragment): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('https://shop.example/help');
$changed = $original->withFragment('delivery');
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://shop.example/help#delivery
https://shop.example/help

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$u = new Uri('https://shop.example/help#delivery');
echo $u->withFragment('')->toString(), "\n";
echo $u->withFragment(null)->toString(), "\n";
try { $u->withFragment('#payment'); } catch (\Uri\InvalidUriException $e) { echo "Передайте имя без решётки\n"; }

https://shop.example/help#
https://shop.example/help
Передайте имя без решётки

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getFragment, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withFragment
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withUserInfo(#[\SensitiveParameter] ?string $userinfo): static

Убрать встроенные учётные данные из учебной ссылки.

Запись withUserInfo(#[\SensitiveParameter] ?string $userinfo): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$original = new Uri('https://anna:demo@shop.example/p');
$changed = $original->withUserInfo(null);
echo $changed->toString(), "\n";
echo $original->toString(), "\n";

https://shop.example/p
https://anna:demo@shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\Rfc3986\Uri as Uri;

$base = new Uri('https://shop.example/p');
$testName = 'team:west';
$u = $base->withUserInfo(rawurlencode($testName) . ':demo');
echo $u->getUsername(), "\n";
echo $u->withUserInfo(null)->toString(), "\n";

team%3Awest
https://shop.example/p

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\Rfc3986\Uri::getUserInfo, Uri\Rfc3986\Uri::toString.

• PHP: Uri\Rfc3986\Uri::withUserInfo
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withScheme(string $scheme): static

Обновить браузерную ссылку с HTTP на HTTPS.

Запись withScheme(string $scheme): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('http://shop.example/p');
$changed = $original->withScheme('https');
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://shop.example/p
http://shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/p');
$changed = $u->withScheme('mailto');
echo $changed->getScheme(), "\n";
echo $changed === $u ? "Тот же объект\n" : "Новый объект без такой смены\n";

https
Новый объект без такой смены

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getScheme, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withScheme
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withHost(?string $host): static

Заменить домен каталога на международное имя.

Запись withHost(?string $host): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://shop.example/p');
$changed = $original->withHost('пример.рф');
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://xn--e1afmkfd.xn--p1ai/p
https://shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/p');
echo $u->withHost('cdn.example/ignored')->toAsciiString(), "\n";
try { $u->withHost(null); } catch (\Uri\WhatWg\InvalidUrlException $e) { echo "HTTPS требует host\n"; }

https://cdn.example/p
HTTPS требует host

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getAsciiHost, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withHost
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withPath(string $path): static

Собрать ссылку на документ с пробелом в имени.

Запись withPath(string $path): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://shop.example/old');
$changed = $original->withPath('/price list.csv');
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://shop.example/price%20list.csv
https://shop.example/old

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/old');
echo $u->withPath('/items/a?b#c')->toAsciiString(), "\n";
echo $u->withPath('/a/%2e%2e/b')->toAsciiString(), "\n";

https://shop.example/items/a%3Fb%23c
https://shop.example/b

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getPath, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withPath
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withPort(?int $port): static

Выбрать порт отдельного учебного HTTPS-сервиса.

Запись withPort(?int $port): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://shop.example/p');
$changed = $original->withPort(8443);
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://shop.example:8443/p
https://shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example:8443/p');
echo $u->withPort(443)->toAsciiString(), "\n";
try { $u->withPort(70000); } catch (\Uri\WhatWg\InvalidUrlException $e) { echo "Порт вне диапазона\n"; }

https://shop.example/p
Порт вне диапазона

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getPort, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withPort
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withQuery(?string $query): static

Добавить фильтр к готовой ссылке каталога.

Запись withQuery(?string $query): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://shop.example/catalog');
$changed = $original->withQuery('category=tools&page=2');
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://shop.example/catalog?category=tools&page=2
https://shop.example/catalog

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/find?q=old');
$query = http_build_query(['q' => 'drill set'], '', '&', PHP_QUERY_RFC3986);
echo $u->withQuery($query)->toAsciiString(), "\n";
echo $u->withQuery('')->toAsciiString(), "\n";
echo $u->withQuery('?')->toAsciiString(), "\n";

https://shop.example/find?q=drill%20set
https://shop.example/find
https://shop.example/find?

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getQuery, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withQuery
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withFragment(?string $fragment): static

Создать ссылку на конкретную часть справки.

Запись withFragment(?string $fragment): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://shop.example/help');
$changed = $original->withFragment('delivery');
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://shop.example/help#delivery
https://shop.example/help

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/help#delivery');
echo $u->withFragment('part two')->toAsciiString(), "\n";
echo $u->withFragment('')->toAsciiString(), "\n";
echo $u->withFragment('#')->toAsciiString(), "\n";

https://shop.example/help#part%20two
https://shop.example/help
https://shop.example/help#

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getFragment, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withFragment
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withUsername(?string $username): static

Удалить имя из ссылки со встроенными credentials.

Запись withUsername(?string $username): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://anna@shop.example/p');
$changed = $original->withUsername(null);
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://shop.example/p
https://anna@shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://shop.example/p');
$withName = $u->withUsername('team:west');
echo $withName->getUsername(), "\n";
echo $withName->withUsername(null)->toAsciiString(), "\n";

team%3Awest
https://shop.example/p

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getUsername, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withUsername
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

withPassword(#[\SensitiveParameter] ?string $password): static

Удалить пароль из фиктивной учебной ссылки.

Запись withPassword(#[\SensitiveParameter] ?string $password): static описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$original = new Url('https://anna:demo@shop.example/p');
$changed = $original->withPassword(null);
echo $changed->toAsciiString(), "\n";
echo $original->toAsciiString(), "\n";

https://anna@shop.example/p
https://anna:demo@shop.example/p

Теперь изменим требование и проверим конкретную границу этого компонента. try выполняет попытку, catch перехватывает только указанный отказ; создание/изменение строки не отправляет запрос.

<?php
declare(strict_types=1);

use Uri\WhatWg\Url as Url;

$u = new Url('https://anna@shop.example/p');
$test = $u->withPassword('demo:west');
echo $test->getPassword(), "\n";
echo $test->withUsername(null)->withPassword(null)->toAsciiString(), "\n";

demo%3Awest
https://shop.example/p

Операция заменяет этот компонент, не обещая бизнес-корректность всего адреса. После сборки проверьте схему, host, port, credentials и нужные ограничения пути. Измеряйте стоимость на своих данных: последовательные with-вызовы создают отдельные объекты; не нужна цепочка ради самой цепочки.

Практика: предскажите результат повторного вызова с тем же аргументом и сравните строки. Даже если строки совпали, новый объект и исходный объект не обязаны быть тождественны по ===.

Перед первым запуском: как устроен вызов и что он проверяет.

Следующий шаг: Uri\WhatWg\Url::getPassword, Uri\WhatWg\Url::toAsciiString.

• PHP: Uri\WhatWg\Url::withPassword
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__construct(string $context, Uri\WhatWg\UrlValidationErrorType $type, bool $failure)

Создать запись для адаптера или теста отображения ошибок.

Запись __construct(string $context, Uri\WhatWg\UrlValidationErrorType $type, bool $failure) описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

$item = new Uri\WhatWg\UrlValidationError(
    ':70000', Uri\WhatWg\UrlValidationErrorType::PortOutOfRange, true
);
echo $item->type->name, "\n";
echo $item->failure ? "Нужна правка\n" : "Можно рассмотреть исправление\n";

PortOutOfRange
Нужна правка

<?php
declare(strict_types=1);

$item = new Uri\WhatWg\UrlValidationError('sample', Uri\WhatWg\UrlValidationErrorType::InvalidUrlUnit, false);
try { $item->failure = true; } catch (Error $e) { echo "Запись readonly\n"; }
echo $item->failure ? "hard\n" : "soft\n";

Запись readonly
soft

Перед первым запуском: как устроен вызов и что он проверяет.

• PHP: Uri\WhatWg\UrlValidationError::__construct
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation

PHP 8.5.0+ · uri

__construct(string $message = "", array $errors = [], int $code = 0, ?Throwable $previous = null)

Передать отказ URL вместе со структурированной причиной вызывающему коду.

Запись __construct(string $message = "", array $errors = [], int $code = 0, ?Throwable $previous = null) описывает договор PHP 8.5+. $ перед именем обозначает параметр, ? перед типом допускает null; null означает отсутствие, а пустая строка — отдельное значение. static в возвращаемом типе означает объект того же класса. Вызов без аргументов всё равно заканчивается скобками ().

<?php
declare(strict_types=1);

$item = new Uri\WhatWg\UrlValidationError(':70000', Uri\WhatWg\UrlValidationErrorType::PortOutOfRange, true);
$error = new Uri\WhatWg\InvalidUrlException('Ссылка карточки17 отклонена', [$item], 17);
echo $error->getMessage(), "\n";
echo $error->errors[0]->type->name, "\n";

Ссылка карточки17 отклонена
PortOutOfRange

<?php
declare(strict_types=1);

$cause = new RuntimeException('Фиктивная причина импорта');
$error = new Uri\WhatWg\InvalidUrlException('Адрес отклонён', [], 0, $cause);
echo $error->getPrevious() === $cause ? "Причина сохранена\n" : "Нет причины\n";
try { new Uri\WhatWg\InvalidUrlException('bad', ['message']); }
catch (ValueError $e) { echo "Нужен список UrlValidationError\n"; }

Причина сохранена
Нужен список UrlValidationError

Перед первым запуском: как устроен вызов и что он проверяет.

• PHP: Uri\WhatWg\InvalidUrlException::__construct
• PHP 8.5.11: API and lifecycle
• PHP 8.5.11: parser implementation