bentools/uri-factory

PSR-7 URI factory

, _(*1)

Uri Factory

A library / framework agnostic PSR-7 UriInterface factory., _(*2)

There are several PSR-7 libraries on packagist but each one has its own factory for creating an UriInterface object from a string., _(*3)

bentools/uri-factory has no explicit dependency and automatically picks up your favorite library for creating UriInterface instances., _(*4)

Supported libraries so far:, _(*5)

• guzzlehttp/psr7
• league/uri
• nyholm/psr7
• ringcentral/psr7

Usage

On any URL string:, _(*6)

use function BenTools\UriFactory\Helper\uri;
$uri = uri('http://www.example.net'); // Will convert to a Psr\Http\Message\UriInterface instance

On current location:, _(*7)

use function BenTools\UriFactory\Helper\current_location;
$uri = current_location(); // Will convert the current location to a Psr\Http\Message\UriInterface instance

You can specify which library to use, by using the corresponding adapter:, _(*8)

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());

Canonicalizer

This library ships with an URL canonicalizer., _(*9)

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., _(*10)

The canonicalize() function accepts any PSR-7 UriInterface object and will return a canonicalized one., _(*11)

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/

Installation

PHP 8.0+ is required., _(*12)

composer require bentools/uri-factory, _(*13)

Tests

./vendor/bin/phpunit, _(*14)

Contribute

If you want bentools/uri-factory to support more PSR-7 libraries, feel free to submit a PR., _(*15)

License

MIT., _(*16)