README

FyreRouter

FyreRouter is a free, open-source URL routing library for PHP.

Installation
Methods
Routes
Router Middleware

Installation

Using Composer

composer require fyre/router

In PHP:

use Fyre\Router\Router;

Methods

Add Placeholer

Add a placeholder.

$placeholder is a string representing the placeholder.
$pattern is a string representing the regular expression.

Router::addPlaceholder($placeholder, $pattern);

Clear

Clear all routes and aliases.

Router::clear();

Connect

Connect a route.

$path is a string representing the route path, and can include placeholders or regular expressions (that will be passed to the destination).
$destination can be either a string representing the destination, an array containing the class name and method or a Closure.
$options is an array containing configuration options.
- as is a string representing the route alias, and will default to null.
- middleware is an array of middleware to be applied to the route, and will default to [].
- method is an array of strings representing the matching methods, and will default to [].
- redirect is a boolean indicating whether the route is a redirect, and will default to false.

Router::connect($path, $destination, $options);

You can generate the following helper methods to connect specific routes.

Router::delete($path, $destination, $options);
Router::get($path, $destination, $options);
Router::patch($path, $destination, $options);
Router::post($path, $destination, $options);
Router::put($path, $destination, $options);
Router::redirect($path, $destination, $options);

See the Routes section for supported destination formats.

Get Base Uri

Get the base uri.

$baseUri = Router::getBaseUri();

Get Placeholders

Get the placeholders.

$placeholders = Router::getPlaceholders();

Get Request

Get the server request.

$request = Router::getRequest();

This method will return a ServerRequest.

Get Route

Get the loaded route.

$route = Router::getRoute();

This method will return a Route.

Group

Create a group of routes.

$options is an array containing the group options.
- prefix is a string representing the route group path prefix, and will default to null.
- as is a string representing the route group alias prefix, and will default to null.
- middleware is an array of middleware to be applied to the route group, and will default to [].
$callback is a Closure where routes can be defined using the prefix.

Router::group($options, $callback);

Load Route

Load a route.

$request is a ServerRequest.

Router::loadRoute($request);

Set Base Uri

Set the base uri.

$baseUri is a string representing the base uri.

Router::getBaseUri($baseUri);

Set Request

Set the server request.

$request is a ServerRequest.

Router::setRequest($request);

Url

Generate a URL for a named route.

$name is a string representing the route alias.
$arguments is an array containing the route arguments.
- ? is an array containing route query parameters.
- # is a string representing the fragment component of the URI.
$options is an array containing the route options.
- fullBase is a boolean indicating whether to use the full base URI and will default to false.

$url = Router::url($name, $arguments, $options)

Routes

All routes extend the Fyre\Router\Route class, and include the following methods.

Check Method

Check if the route matches a test method.

$method is a string representing the method to test.

$checkMethod = $route->checkMethod($method);

Check Path

Check if the route matches a test path.

$path is a string representing the path to test.

$checkPath = $route->checkPath($path);

Get Arguments

Get the route arguments.

$arguments = $route->getArguments();

Get Destination

Get the route destination.

$destination = $route->getDestination();

Get Middleware

Get the route middleware.

$middleware = $route->getMiddleware();

Get Path

Get the route path.

$path = $route->getPath();

Process

Process the route.

$request is a ServerRequest.
$response is a ClientResponse.

$response = $route->process($request, $response);

This method will return a ClientResponse.

Set Arguments From Path

Set the route arguments from a path.

$path is a string representing the path.

$newRoute = $route->setArgumentsFromPath($path);

Set Methods

$methods is an array containing the route methods.

$newRoute = $route->setMethods($methods);

Set Middleware

$middleware is an array containing the route middleware.

$newRoute = $route->setMiddleware($middleware);

Closure Routes

use Fyre\Router\Routes\ClosureRoute;

$destination is a Closure.
$path is a string representing the route path, and will default to "".

$route = new ClosureRoute($destination, $path);

The $destination should be expressed in the following format:

$destination = function(...$args) {
    return $response;
};

Controller Routes

use Fyre\Router\Routes\ControllerRoute;

$destination is an array containing the controller class name and method.
$path is a string representing the route path, and will default to "".

$route = new ControllerRoute($destination, $path);

The $destination can be expressed in the following formats:

$destination = [MyClass::class]; // defaults to index method
$destination = [MyClass::class, 'method'];

Get Action

Get the route controller action.

$action = $route->getAction();

Get Controller

Get the route controller class name.

$controller = $route->getController();

Redirect Routes

use Fyre\Router\Routes\RedirectRoute;

$destination is a string representing the destination.
$path is a string representing the route path, and will default to "".

$route = new RedirectRoute($destination, $path);