phrity net uri

Введение

Реализация интерфейсов PSR-7 UriInterface и PSR-17 UriFactoryInterface.

Ничего особенного. Просто работаю. Потому что мне нужна реализация URI, не привязанная к обмену сообщениями HTTP. И некоторые доп. Разрешить все допустимые схемы.

Установка

Установить с помощью Composer;

 composer require phrity/net-uri

Методы класса Uri

Реализует PSR-7 UriInterface и предоставляет некоторые дополнительные методы и опции. Дополнительная информация здесь.

 use Phrity  Net  Uri ;
$ uri = new Uri ( ' http://example.com/path/to/file.html?query1=1#fragment ' );

// PSR-7 getters
$ uri -> getScheme ();
$ uri -> getHost ();
$ uri -> getPort ();
$ uri -> getPath ();
$ uri -> getQuery ();
$ uri -> getFragment ();
$ uri -> getAuthority ();
$ uri -> getUserInfo ();

// PSR-7 setters
$ uri -> withScheme ( ' https ' );
$ uri -> withHost ( ' example2.com ' );
$ uri -> withPort ( 8080 );
$ uri -> withPath ( ' /path/to/another/file.html ' );
$ uri -> withQuery ( ' query2=2 ' );
$ uri -> withFragment ( ' another-fragment ' );
$ uri -> withUserInfo ( ' username ' , ' password ' );

// Additional methods
$ uri -> toString ();
$ uri -> __toString ();
$ uri -> jsonSerialize ();
$ uri -> getQueryItems ();
$ uri -> getQueryItem ( ' query1 ' );
$ uri -> withQueryItems ([ ' query1 ' => ' 1 ' , ' query2 ' => ' 2 ' ]);
$ uri -> withQueryItem ( ' query1 ' , ' 1 ' );
$ uri -> getComponents ();
$ uri -> withComponents ([ ' scheme ' => ' https ' , ' host ' => ' example2.com ' ]);

Методы класса UriFactory

Реализует PSR-17 UriFactoryInterface и предоставляет некоторые дополнительные методы и параметры. Дополнительная информация здесь.

 use Phrity  Net  UriFactory ;
$ factory = new UriFactory ();
$ factory -> createUri ( ' http://example.com/path/to/file.html ' );
$ factory -> createUriFromInterface ( new GuzzleHttp  Psr7  Uri ( ' http://example.com/path/to/file.html ' ));

Модификаторы

По умолчанию он будет вести себя так, как указано стандартами PSR. Чтобы изменить поведение, доступны некоторые модификаторы. Их можно добавить в качестве последнего аргумента во все методы get и with , а также метод toString .

• REQUIRE_PORT — попытка показать порт, даже если он установлен по умолчанию.
• ABSOLUTE_PATH — путь будет использовать абсолютную форму, т.е. начиная с /
• NORMALIZE_PATH — попытается нормализовать путь.
• IDN_ENCODE / IDN_DECODE — кодировать или декодировать формат IDN для хоста, отличного от ASCII.
• URI_DECODE / URI_ENCODE / URI_ENCODE_3986 — кодирование или декодирование компонентов URI.

Примеры

 $ uri = new Uri ( ' http://example.com ' );
$ uri -> getPort (Uri:: REQUIRE_PORT ); // => 80
$ uri -> toString (Uri:: REQUIRE_PORT ); // => 'http://example.com:80'

$ uri = new Uri ( ' a/./path/../to//something ' );
$ uri -> getPath (Uri:: ABSOLUTE_PATH | Uri:: NORMALIZE_PATH ); // => '/a/to/something'
$ uri -> toString (Uri:: ABSOLUTE_PATH | Uri:: NORMALIZE_PATH ); // => '/a/to/something'

$ clone = $ uri -> withPath ( ' path/./somewhere/else/.. ' , Uri:: ABSOLUTE_PATH | Uri:: NORMALIZE_PATH );
$ clone -> getPath (); // => '/path/somewhere'

$ uri = new Uri ( ' https://ηßöø必Дあ.com ' );
$ uri -> getHost (Uri:: IDN_ENCODE ); // => 'xn--zca0cg32z7rau82strvd.com' 

Версии

Версия	PHP
2.1	^8.0	Параметры кодирования/декодирования URI
2.0	^8.0	Помощники запросов с методами ([]) и getComponents(), кодирование/декодирование IDN
1.3	^7.4|^8.0
1.2	^7.4|^8.0	модификатор IDNA
1.1	^7.4|^8.0	Требовать порт, Абсолютный путь, Нормализовать модификаторы пути
1.0	^7.4|^8.0	Начальная версия