A library / framework agnostic PSR-7 UriInterface factory.
There are several PSR-7 libraries on packagist but each one has its own factory for creating an UriInterface object from a string.
bentools/uri-factory has no explicit dependency and automatically picks up your favorite library for creating UriInterface instances.
Supported libraries so far:
guzzlehttp/psr7league/urinyholm/psr7ringcentral/psr7
On any URL string:
use function BenTools\UriFactory\Helper\uri;
$uri = uri('http://www.example.net'); // Will convert to a Psr\Http\Message\UriInterface instanceOn current location:
use function BenTools\UriFactory\Helper\current_location;
$uri = current_location(); // Will convert the current location to a Psr\Http\Message\UriInterface instanceYou can specify which library to use, by using the corresponding adapter:
use BenTools\UriFactory\Adapter\GuzzleAdapter;
use BenTools\UriFactory\Adapter\LeagueUriAdapter;
use function BenTools\UriFactory\Helper\current_location;
use function BenTools\UriFactory\Helper\uri;
$uri = uri('http://www.example.net', GuzzleAdapter::factory());
$uri = uri('http://www.example.net', LeagueUriAdapter::factory());
$uri = current_location(GuzzleAdapter::factory());
$uri = current_location(LeagueUriAdapter::factory());This library ships with an URL canonicalizer.
It is not a perfect one since your PSR-7 library may behave differently regarding special chars, but it should work most of the time.
The canonicalize() function accepts any PSR-7 UriInterface object and will return a canonicalized one.
require_once __DIR__ . '/vendor/autoload.php';
use function BenTools\UriFactory\Helper\canonicalize;
use function BenTools\UriFactory\Helper\uri;
$url = 'http://example.org../foo/../bar/?#baz';
echo canonicalize(uri($url)); // http://example.org/bar/PHP 8.0+ is required.
composer require bentools/uri-factory
./vendor/bin/phpunit
If you want bentools/uri-factory to support more PSR-7 libraries, feel free to submit a PR.
MIT.