Route - 快速，灵活的PHP路由，能够快速轻松地构建RESTful Web应用程序

Route v1.2.6

Route - Fast, flexible routing for PHP, enabling you to quickly and easily build RESTful web applications.

Installation

You can download it and using it without any changes.

OR use Composer.

It's recommended that you use Composer to install Route.

$ composer require nezamy/route

Route requires PHP 5.4.0 or newer.

Usage

Only if using composer create index.php in root.

Create an index.php file with the following contents:

request = System\Request::instance();$app->route = System\Route::instance($app->request);$route = $app->route;$route->any('/', function() { echo 'Hello World';});$route->end();

If using apache make sure the .htaccess file has exists beside index.php

How it works

Routing is done by matching a URL pattern with a callback function.

index.php

$route->any('/', function() { echo 'Hello World';});$route->any('/about', function() { echo 'About';});

The callback can be any object that is callable. So you can use a regular function:

function pages() { echo 'Page Content';}$route->get('/', 'pages');

Or a class method:

class home{ function pages() { echo 'Home page Content'; }}$route->get('/', ['home', 'pages']);// OR$home = new home;$route->get('/', [$home, 'pages']);// OR$route->get('/', 'home@pages');

Method Routing

$route->any('/', function() { // Any method requests});$route->get('/', function() { // Only GET requests});$route->post('/', function() { // Only POST requests});$route->put('/', function() { // Only PUT requests});$route->patch('/', function() { // Only PATCH requests});$route->delete('/', function() { // Only DELETE requests});// You can use multiple methods. Just add _ between method names$route->get_post('/', function() { // Only GET and POST requests});

Multiple Routing (All in one)

$route->get(['/', 'index', 'home'], function() { // Will match 3 page in one});

Parameters

// This example will match any page name$route->get('/?', function($page) { echo "you are in $page";});// This example will match anything after post/ - limited to 1 argument$route->get('/post/?', function($id) { // Will match anything like post/hello or post/5 ... // But not match /post/5/title echo "post id $id";});// more than parameters$route->get('/post/?/?', function($id, $title) { echo "post id $id and title $title";});

For “unlimited” optional parameters, you can do this:

// This example will match anything after blog/ - unlimited arguments$route->get('/blog/*', function() { // [$this] instanceof ArrayObject so you can get all args by getArrayCopy() pre($this->getArrayCopy()); pre($this[1]); pre($this[2]);});

Named Parameters

You can specify named parameters in your routes which will be passed along to your callback function.

$route->get('/{username}/{page}', function($username, $page) { echo "Username $username and Page $page
"; // OR echo "Username {$this['username']} and Page {$this['page']}";});

Regular Expressions

You can validate the args by regular expressions.

// Validate args by regular expressions uses :(your pattern here)$route->get('/{username}:([0-9a-z_.-]+)/post/{id}:([0-9]+)',function($username, $id){ echo "author $username post id $id";});// You can add named regex pattern in routes$route->addPattern([ 'username' => '/([0-9a-z_.-]+)', 'id' => '/([0-9]+)']);// Now you can use named regex$route->get('/{username}:username/post/{id}:id', function($username, $id) { echo "author $username post id $id";});

Some named regex patterns already registered in routes

[ 'int' => '/([0-9]+)', 'multiInt' => '/([0-9,]+)', 'title' => '/([a-z_-]+)', 'key' => '/([a-z0-9_]+)', 'multiKey' => '/([a-z0-9_,]+)', 'isoCode2' => '/([a-z]{2})', 'isoCode3' => '/([a-z]{3})', 'multiIsoCode2' => '/([a-z,]{2,})', 'multiIsoCode3' => '/([a-z,]{3,})']

Optional parameters

You can specify named parameters that are optional for matching by adding (?)

$route->get('/post/{title}?:title/{date}?',function($title, $date) { if ($title) { echo "

$title

Posts List

Groups

$route->group('/admin', function(){ // /admin/ $this->get('/', function() { echo 'welcome to admin panel'; }); // /admin/settings $this->get('/settings', function() { echo 'list of settings'; }); // nested group $this->group('/users', function() { // /admin/users $this->get('/', function() { echo 'list of users'; }); // /admin/users/add $this->get('/add', function() { echo 'add new user'; }); }); // Anything else $this->any('/*', function() { pre("Page ( {$this->app->request->path} ) Not Found", 6); });});

Groups with parameters

$route->group('/{lang}?:isoCode2', function($lang){ $default = $lang; if (!in_array($lang, ['ar', 'en'])) { $default = 'en'; } $this->get('/', function($lang) use($default) { echo "lang in request is $lang
"; echo "include page_{$default}.php"; }); $this->get('/page/{name}/', function($lang, $name) { pre(func_get_args()); pre($this->app->request->args); });});

Middleware

$route->use(function (){ $req = app('request'); pre('Do something before all routes', 3);});$route->before('/', function (){ pre('Do something before all routes', 4);});$route->before('/*!admin', function (){ pre('Do something before all routes except admin', 4);});$route->before('/admin|home', function (){ pre('Do something before admin and home only ', 4);});$route->after('/admin|home', function (){ pre('Do something after admin and home only ', 4);});

Full examples here

Support me

https://paypal.me/nezamy

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。