2017 © Pedro Peláez
 

library router

A fast router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

image

lloydzhou/router

A fast router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  • Thursday, October 22, 2015
  • by lloydzhou
  • Repository
  • 6 Watchers
  • 15 Stars
  • 117 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 1 Forks
  • 1 Open issues
  • 19 Versions
  • 2 % Grown

The README.md

router

Build Status Coverage Status Latest Stable Version Total Downloads Latest Unstable Version License
A barebones router for PHP.
It matches urls and executes PHP functions.
Automatic get variable based on handler function parameter list.
Suport to compile router callback handlers into plain array source code., (*1)

中文版., (*2)

Installation

composer require bephp/router

API Reference

group/prefix($prefix, $hook)

add group routers with same prefix. if not pass param $prefix just reset attribute prefix of router instance to empty string. will merge the $hook to this group., (*3)

match($method, $path, $callback, $hook)

create the router tree based on given $method and $path, the $callback and $hook will stored in the leaf node., (*4)

get/post/put/delete/head/options($path, $callback, $hook)

wrap the match method without $method parameter. also defined "post", "put", "delete", "head" and so on., (*5)

execute()

the enter point of the application. have 3 optional parameters, $params will be merged with request variable and passed into callback handler. can pass $method and $path when not deploy as web server, can using the 2 parameters to test this library., (*6)

error()

  1. if call this API with $error_code and $callback, just define the callback handler for the error code.
  2. if call this API with $error_code and other parameters, will trigger the error callback handler, the parameters will passed to the error handler.

hook()

  1. if call this API with $hook_name and $callback, just define the callback handler for the hook name.
  2. if call this API with $hook_name and other parameters, will trigger the hook handler, the parameters will passed to the hook handler.
  3. there's 2 spec hook: "before" and "after", this library will auto call "before" hook before execute the handler, and call "after" hook after execute the handler.
  4. the "after" hook will auto trigger with the return value of callback handler.
  5. the "before" hook, and other user define hooks will auto trigger with the current router object $router, and the merged params stored in $router->params. if these hook return false, will trigger 406 error handler.

Validate

using ctype functions to validate params in pathinfo
example:, (*7)

if defined router: "/hello/:name:a.json", and using URL: "/hello/lloyd.json" to resolve url.
will call function "ctype_alpha" to validate "lloyd".
validate command to map the ctype functions:, (*8)

A => ctype_alnum
a => ctype_alpha
d => ctype_digit
x => ctype_xdigit
l => ctype_lower
u => ctype_upper

Compile

the PHP request always match the callback handlers every time. but the request just match one callback. so we can compile the routed tree node into plain array, to save time., (*9)

DEV model

using CRouter instead of Router, will always compile the source code into target file., (*10)

$crouter = new CRouter("router.inc.php", true);

PRODUCTION model

just include the target source code, and execute it with parameters., (*11)

$router = include("router.inc.php");
$router->execute();

Performance

  1. using tree struct to stored callback handler on leaf node. Ensure that the time complexity of find callback function is O(log n). Tree Node
  2. using CRouter class, suport to compile router callback handlers into plain array source code. so can save time to create tree node to store callback by split pathinfo.

Benchmark

using "php-router-benchmark" to test router performance., (*12)

Worst-case matching

This benchmark matches the last route and unknown route. It generates a randomly prefixed and suffixed route in an attempt to thwart any optimization. 1,000 routes each with 9 arguments., (*13)

This benchmark consists of 10 tests. Each test is executed 1,000 times, the results pruned, and then averaged. Values that fall outside of 3 standard deviations of the mean are discarded., (*14)

Test Name Results Time + Interval Change
Router - unknown route (1000 routes) 993 0.0000232719 +0.0000000000 baseline
Router - last route (1000 routes) 981 0.0000955424 +0.0000722705 311% slower
FastRoute - unknown route (1000 routes) 990 0.0005051955 +0.0004819236 2071% slower
FastRoute - last route (1000 routes) 998 0.0005567203 +0.0005334484 2292% slower
Symfony2 Dumped - unknown route (1000 routes) 998 0.0006116139 +0.0005883420 2528% slower
Symfony2 Dumped - last route (1000 routes) 998 0.0007765370 +0.0007532651 3237% slower
Symfony2 - unknown route (1000 routes) 996 0.0028456177 +0.0028223458 12128% slower
Symfony2 - last route (1000 routes) 993 0.0030129542 +0.0029896823 12847% slower
Aura v2 - last route (1000 routes) 989 0.1707107230 +0.1706874511 733450% slower
Aura v2 - unknown route (1000 routes) 988 0.1798588730 +0.1798356011 772760% slower

Example

belong is one simple example, see the full examples in example.php., (*15)

(new Router())
->error(405, function($message){
    header('Location: /hello/world', true, 302);
})
->get('/hello/:name', function($name){
    echo "Hello $name !!!";
})

Start server

php -S 0.0.0.0:8888 example.php

Test

Url not match, trigger 405 error handler., (*16)

curl -vvv 127.0.0.1:8888
> GET / HTTP/1.1
> User-Agent: curl/7.35.0
> Host: 127.0.0.1:8888
> Accept: */*
> 
< HTTP/1.1 302 Found
< Host: 127.0.0.1:8888
< Connection: close
< X-Powered-By: PHP/5.5.9-1ubuntu4.12
< Location: /hello/world
< Content-type: text/html
< 
* Closing connection 0

Url match get current result., (*17)

curl -vvv 127.0.0.1:8888/hello/lloyd
* Connected to 127.0.0.1 (127.0.0.1) port 8888 (#0)
> GET /hello/lloyd HTTP/1.1
> User-Agent: curl/7.35.0
> Host: 127.0.0.1:8888
> Accept: */*
> 
< HTTP/1.1 200 OK
< Host: 127.0.0.1:8888
< Connection: close
< X-Powered-By: PHP/5.5.9-1ubuntu4.12
< Content-type: text/html
< 
* Closing connection 0
Hello lloyd !!!

Demo

there's one blog demo, work with ActiveRecord and MicroTpl., (*18)

The Versions

22/10 2015

dev-master

9999999-dev https://github.com/lloydzhou/router

A fast router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

micro library router fast

22/10 2015

v1.0.1

1.0.1.0 https://github.com/lloydzhou/router

A fast router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

micro library router fast

14/10 2015

v1.0.0

1.0.0.0 https://github.com/lloydzhou/router

A fast router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

micro library router fast

12/10 2015

v0.4.4

0.4.4.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

micro library router fast

11/10 2015

v0.4.3

0.4.3.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

10/10 2015

v0.4.2

0.4.2.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

08/10 2015

v0.4.1

0.4.1.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list. Suport to compile router callback handlers into plain array source code.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

08/10 2015

v0.4.0

0.4.0.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

08/10 2015

dev-feature-compile

dev-feature-compile https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

07/10 2015

v0.3.3

0.3.3.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

06/10 2015

v0.3.2

0.3.2.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

02/10 2015

v0.3.1

0.3.1.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

30/09 2015

v0.3.0

0.3.0.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

29/09 2015

v0.2.3

0.2.3.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions. automatic get variable based on handler function parameter list.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

28/09 2015

v0.2.2

0.2.2.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

27/09 2015

v0.2.1

0.2.1.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

26/09 2015

v0.2.0

0.2.0.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

micro library router

26/09 2015

v0.1.0

0.1.0.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

router

26/09 2015

v0.0.1

0.0.1.0 https://github.com/lloydzhou/router

A barebones router for PHP. It matches urls and executes PHP functions.

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

router