franzose/gimme-url

URL generator for the PHP League Route.

v1.0 2019-08-13 14:10 UTC

Requires

• league/route: ^4.3

Requires (Dev)

• mockery/mockery: ^1.2
• phpunit/phpunit: ^8.2

MIT

• Jan Iwanow

• route
• url
• router
• dispatcher
• uri
• url-generation
• psr-7
• psr7
• psr-15
• psr15
• url-generator

README

Gimme URL is a missing URL generator for the League Route library. It's capable to generate relative and absolute paths to named routes.

Installation

Use Composer to install Gimme URL:

composer install franzose/gimme-url

Setup and usage

URL generator requires you to provide Router and RequestContext instances. The latter gathers information from a Psr\Http\Message\ServerRequestInterface instance and is used to build absolute paths to named routes.

<?php

use GimmeUrl\RequestContext;
use GimmeUrl\Router;
use GimmeUrl\UrlGenerator;
use Zend\Diactoros\ServerRequestFactory;

$router = new Router();
$router->get('/foo/{bar}', function () {
    //
})->setName('foo_route');

// Let's say the request is secure and is made at example.com on 8080 port
$request = ServerRequestFactory::fromGlobals($_SERVER, $_GET, $_POST, $_COOKIE, $_FILES);
$context = RequestContext::fromRequest($request);
$generator = new UrlGenerator($router, $context);

// Then you'll get this
$generator->relative('foo_route', ['bar' => '123']); // '/foo/123'
$generator->relative('foo_route', ['bar' => '123', 'qux' => 'doo']); // '/foo/123?qux=doo'
$generator->absolute('foo_route', ['bar' => '456']); // 'https://example.com:8080/foo/456'
$generator->absolute('foo_route', ['bar' => '456', 'qux' => 'doo']); // 'https://example.com:8080/foo/456?qux=doo'