zqhong / route

A fast router for PHP

Route - A fast route implemented by php

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

• README English
• README 简体中文

---

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