alsemany / route
Simple PHP router class.
Requires
- php: >=5.3.3
This package is not auto-updated.
Last update: 2024-05-20 06:14:13 UTC
README
forked from noahbuscher/Macaw
Route
Route is a simple, open source PHP router. It's super small (~150 LOC), fast, and has some great annotated source code. This class allows you to just throw it into your project and start using it immediately.
Install
Composer
If you have Composer
# composer require alsemany/route
Download From Releases
https://github.com/alsemany/route/releases Download Zip file or tar.gz
Examples
First, use
the Route namespace:
use \Alsemany\Route\Route;
Route is not an object, so you can just make direct operations to the class. Here's the Hello World:
Route::get('/', function() { echo 'Hello world!'; }); Route::dispatch();
Route also supports lambda URIs, such as:
Route::get('/(:any)', function($slug) { echo 'The slug is: ' . $slug; }); Route::dispatch();
You can also make requests for HTTP methods in Route, so you could also do:
Route::get('/', function() { echo 'I'm a GET request!'; }); Route::post('/', function() { echo 'I'm a POST request!'; }); Route::any('/', function() { echo 'I can be both a GET and a POST request!'; }); Route::dispatch();
Lastly, if there is no route defined for a certain location, you can make Route run a custom callback, like:
Route::catchall(function() { echo 'Catching All 404 Errors :: Not Found'; });
If you don't specify an error callback, Route will just echo 404
.
In order to let the server know the URI does not point to a real file, you may need to use one of the example configuration files.
Example passing to a controller instead of a closure
It's possible to pass the namespace path to a controller instead of the closure:For this demo lets say I have a folder called controllers with a demo.php
index.php:
require('vendor/autoload.php'); use Alsemany\Route\Route; Route::get('/', 'Controllers\demo@index'); Route::get('page', 'Controllers\demo@page'); Route::get('view/(:num)', 'Controllers\demo@view'); Route::dispatch();
demo.php:
<?php namespace controllers; class Demo { public function index() { echo 'home'; } public function page() { echo 'page'; } public function view($id) { echo $id; } }
This is with Route installed via composer.
composer.json:
{
"require": {
"alsemany/Route": "^0.1.0"
},
"autoload": {
"psr-4": {
"" : ""
}
}
}
.htaccess(Apache):
RewriteEngine On
RewriteBase /
# Allow any files or directories that exist to be displayed directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?$1 [QSA,L]
.htaccess(Nginx):
rewrite ^/(.*)/$ /$1 redirect;
if (!-e $request_filename){
rewrite ^(.*)$ /index.php break;
}