A fast router for PHP
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Route - A fast route implemented by php

StyleCI Build Status Scrutinizer Code Quality

zqhong/route is inspred by nikic/FastRoute. But it is faster than FastRoute.


Install

$ composer require -vvv "zqhong/route:dev-master"

Example

<?php

use zqhong\route\Helpers\Arr;
use zqhong\route\RouteCollector;
use zqhong\route\RouteDispatcher;

require dirname(__DIR__) . "/vendor/autoload.php";

function getUser($uid)
{
    echo "Your uid: " . $uid;
}

/** @var RouteDispatcher $routeDispatcher */
$routeDispatcher = dispatcher(function (RouteCollector $r) {
    $r->addRoute('GET', '/user/{id:\d+}', 'getUser');
});

$httpMethod = 'GET';
$uri = '/user/1';
$routeInfo = $routeDispatcher->dispatch($httpMethod, $uri);

if (Arr::getValue($routeInfo, 'isFound')) {
    $handler = Arr::getValue($routeInfo, 'handler');
    $params = Arr::getValue($routeInfo, 'params');
    call_user_func_array($handler, $params);
} else {
    echo '404 NOT FOUND';
}

Using CURL send request:

// return 404 NOT FOUND
$ curl http://example.com/?r=ops

// return Your uid: 1
$ curl http://example.com/?=/user/1

Benchmark

Environment

  • OS:Ubuntu 16.04 LTS(Vultr 4Cores 8G memory)
  • PHP:7.0.4
  • Apache:2.4.18

Result

nikic_route(v1.2)
Requests per second:    3527.98 [#/sec] (mean)

symfony route(v3.2)
Requests per second:    5193.17 [#/sec] (mean)

zqhong route(dev-master)
Requests per second:    5923.56 [#/sec] (mean)

Benchmark test code and result in benchmark folder.


Document

How it works