PHPackages                             phprtc/http-router - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. phprtc/http-router

ActiveLibrary[HTTP & Networking](/categories/http)

phprtc/http-router
==================

PHPRTC Http Router

0282PHP

Since Feb 13Pushed 4y agoCompare

[ Source](https://github.com/phprtc/http-router)[ Packagist](https://packagist.org/packages/phprtc/http-router)[ RSS](/packages/phprtc-http-router/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (1)Used By (2)

PHP RTC Http Router
===================

[](#php-rtc-http-router)

An elegant http router built on top of [FastRoute](https://github.com/nikic/FastRoute) to provide more easy of use.

Upgrade Guide
-------------

[](#upgrade-guide)

Check [ChangeLog](CHANGELOG.md) file

Installation
------------

[](#installation)

```
composer require phprtc/http-router
```

Usage
-----

[](#usage)

Simple example

```
use RTC\Http\Router\Route;
use RTC\Http\Router\Dispatcher;

require('vendor/autoload.php');

Route::get('/', function () {
    echo 'Hello world';
});

$method = $_SERVER['REQUEST_METHOD'];
$path = $_SERVER['REQUEST_URI'];

//create route dispatcher
$dispatcher = Dispatcher::collectRoutes()
    ->dispatch($method, $path);

//determine dispatch result
switch (true) {
    case $dispatcher->isFound():
        $controller = $dispatcher->getRoute()->getController();
        $controller($dispatcher->getUrlParameters());
        break;
    case $dispatcher->isNotFound():
        echo "Page not found";
        break;
    case $dispatcher->isMethodNotAllowed():
        echo "Request method not allowed";
        break;
}
```

#### Controller-like example

[](#controller-like-example)

```
use RTC\Http\Router\Route;

Route::get('/home', 'MainController@home');
```

#### Advance usage

[](#advance-usage)

```
use RTC\Http\Router\Route;

Route::prefix('user')->name('user.')
    ->namespace('User')
    ->middleware('UserMiddleware')
    ->group(function (){
        Route::get('profile', 'UserController@profile');
        Route::put('update', 'UserController@update');
    });
```

#### More Advance Usage

[](#more-advance-usage)

```
use RTC\Http\Router\Route;

Route::prefix('user')
    ->prepend('api')
    ->append('{token}')
    ->middleware('UserMiddleware')
    ->group(function (){
        Route::get('profile', 'UserController@profile');
        Route::put('update', 'UserController@update');
    });

// => /api/user/{token}
```

#### Defining route param types

[](#defining-route-param-types)

```
use RTC\Http\Router\Route;

// id => must be number
Route::get('users/{id}', 'Controller@index')->whereNumber('id');
// name => must be alphabetic
Route::get('users/{name}', 'Controller@profile')->whereAlpha('name');
// username => must be alphanumeric
Route::get('users/{username}', 'Controller@profile')->whereAlphaNumeric('username');

// Manually provide regular expression pattern to match parameter with
Route::get('/users/{id}', 'a')->where('id', '[0-9]+');
Route::get('/users/{user}/posts/{post}', 'Ctrl@method')->where([
    'user' => '[a-zA-Z]+',
    'post' => '[0-9]+'
]);
```

#### Route Fields

[](#route-fields)

Fields help to add more description to route or group of routes

```
use RTC\Http\Router\Route;

Route::prefix('user')
    ->middleware('User')
    ->addField('specie', 'human')
    ->group(function (){
        Route::get('type', 'admin')->addField('permissions', 'all');
        Route::get('g', fn() => print('Hello world'));
    });
```

#### Route::match()

[](#routematch)

```
use RTC\Http\Router\Route;
use RTC\Http\Router\Collector;
use RTC\Http\Router\Dispatcher;

require 'vendor/autoload.php';

$controller = fn() => print time();
Route::match(['get', 'post'], '/user', $controller)
    ->middleware('auth')
    ->namespace('App')
    ->name('home');

$collector = Collector::create()->collect();

$dispatchResult = Dispatcher::create($collector)
    ->dispatch('get', '/user/hello');

var_export($dispatchResult->getRoute());
```

#### Route::match() with named routes

[](#routematch-with-named-routes)

```
use RTC\Http\Router\Route;

Route::match(['get', 'post'], 'login', 'AuthController@login')->name('login.');

//Will generate below routes
Route::get('login', 'AuthController@login')->name('login.get');
Route::post('login', 'AuthController@login')->name('login.post');
```

#### Route::any()

[](#routeany)

```
use RTC\Http\Router\Route;
use RTC\Http\Router\Collector;
use RTC\Http\Router\Dispatcher;

$controller = fn() => print time();

Route::any(['/login', '/admin/login'], 'get', $controller);

$collector = Collector::create()->collect();

$dispatchResult1 = Dispatcher::create($collector)
    ->dispatch('get', '/login');

$dispatchResult2 = Dispatcher::create($collector)
    ->dispatch('get', '/admin/login');
```

#### Route::matchAny()

[](#routematchany)

```
use RTC\Http\Router\Route;

Route::matchAny(
    ['get', 'post'],
    ['/customer/login', '/admin/login'],
    'MainController@index'
);

//Which is equivalent to:
Route::get('/customer/login', 'MainController@index');
Route::post('/customer/login', 'MainController@index');
Route::get('/admin/login', 'MainController@index');
Route::post('/admin/login', 'MainController@index');
```

#### Route::resource()

[](#routeresource)

```
use RTC\Http\Router\Route;

Route::resource('photos', 'App\Http\Controller\PhotoController');
```

Code above will produce below routes
[![alt text](resource-http-verbs.png)](resource-http-verbs.png)

#### Crud::create()

[](#crudcreate)

```
use RTC\Http\Router\Crud;

Crud::create('/', 'Controller')->go();
```

Code above will produce below routes
[![alt text](crud-definition.png)](crud-definition.png)
**Why not use Route::resource()?**
Crud creator generates 6 routes, one of the routes which deletes all record in the endpoint.
With Crud creator you can choose which routes to create or not.

```
use RTC\Http\Router\Crud;

//Disabling route creation
Crud::create('/', 'Controller')
    ->disableIndexRoute()
    ->disableStoreRoute()
    ->disableDestroyAllRoute()
    ->disableShowRoute()
    ->disableUpdateRoute()
    ->disableDestroyRoute()
    ->go();

//Specifying custom route parameter name
Crud::create('/', 'Controller')->parameter('userId');

//Specify parameter type
Crud::create('/', 'Controller')->numericParameter();
Crud::create('/', 'Controller')->alphabeticParameter();
Crud::create('/', 'Controller')->alphaNumericParameter();
```

#### Routes as configuration

[](#routes-as-configuration)

```
//routes.php
use RTC\Http\Router\Route;

Route::get('/', 'MainController@index');
Route::get('/help', 'MainController@help');

//server.php
use RTC\Http\Router\Collector;

$collector = Collector::create()
    ->collectFile('routes.php')
    ->register();

$routes = $collector->getCollectedRoutes();
```

#### Caching

[](#caching)

Cache routes so that they don't have to be collected every time.

```
use RTC\Http\Router\Collector;

$collector = Collector::create()
    ->collectFile('routes.php')
    ->cache('path/to/save/cache.php', false)
    ->register();

$routes = $collector->getCollectedRoutes();
```

Caching routes with closure

```
use RTC\Http\Router\Route;
use RTC\Http\Router\Collector;

Route::get('/', function (){
    echo uniqid();
});

$collector = Collector::create()
    ->collect()
    ->cache('path/to/save/cache.php', true)
    ->register();

$routes = $collector->getCollectedRoutes();
```

**Note that you must specify that your routes contains closure**

#### Passing Default Data

[](#passing-default-data)

You can alternatively pass data to be prepended to all routes.
Cached routes must be cleared manually after setting/updating default route data.

```
use RTC\Http\Router\Collector;

$collector = Collector::create();
$collector->collectFile('api-routes.php', [
    'prefix' => 'api',
    'name' => 'api.',
    'namespace' => 'Api\\'
]);
$collector->register();
```

#### Changing Delimiter

[](#changing-delimiter)

For usage outside of web context, a function to change default delimiter which is "**/**" has been provided.

```
use RTC\Http\Router\Route;
use RTC\Http\Router\Collector;
use RTC\Http\Router\Dispatcher;

require 'vendor/autoload.php';

Route::prefix('hello')
    ->group(function () {
        Route::get('world', fn() => print('Hello World'));
    });

$collector = Collector::create()
    ->prefixDelimiter('.')
    ->collect()
    ->register();

$dispatchResult = Dispatcher::create($collector)
    ->dispatch('get', 'hello.world');

var_export($dispatchResult);
```

#### Finding route & generating route uri

[](#finding-route--generating-route-uri)

```
use RTC\Http\Router\Route;
use RTC\Http\Router\Collector;

Route::get('/users', 'Controller@method')->name('users.index');

$collector = Collector::create()->collect();
echo $collector->uri('users.index');  // => /users
$collector->route('users.index'); // => Instance of RTC\Http\Router\Route\RouteData
```

#### Note

[](#note)

- You must be careful when using **Collector::collect()** and **Collector::collectFile()** together, as collectFile method will clear previously collected routes before it starts collecting.
    Make sure that you call **Collector::collect()** first, before calling **Collector::collectFile()**.

Licence
-------

[](#licence)

*Route http verbs image is owned by [Riptutorial](https://riptutorial.com)*.

**QuickRoute** is **MIT** licenced.

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity27

Early-stage or recently created project

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f66f14772ab415264a8b0c71d38fae01fa567d48236b413f0d569ee9c6e95d76?d=identicon)[phprtc](/maintainers/phprtc)

### Embed Badge

![Health badge](/badges/phprtc-http-router/health.svg)

```
[![Health](https://phpackages.com/badges/phprtc-http-router/health.svg)](https://phpackages.com/packages/phprtc-http-router)
```

###  Alternatives

[friendsofsymfony/rest-bundle

This Bundle provides various tools to rapidly develop RESTful API's with Symfony

2.8k73.3M317](/packages/friendsofsymfony-rest-bundle)[php-http/discovery

Finds and installs PSR-7, PSR-17, PSR-18 and HTTPlug implementations

1.3k309.5M1.2k](/packages/php-http-discovery)[nyholm/psr7

A fast PHP7 implementation of PSR-7

1.3k235.4M2.4k](/packages/nyholm-psr7)[pusher/pusher-php-server

Library for interacting with the Pusher REST API

1.5k94.8M292](/packages/pusher-pusher-php-server)[spatie/crawler

Crawl all internal links found on a website

2.8k16.3M52](/packages/spatie-crawler)[react/http

Event-driven, streaming HTTP client and server implementation for ReactPHP

78126.4M414](/packages/react-http)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)