Download the PHP package corviz/router without Composer
On this page you can find all versions of the php package corviz/router. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download corviz/router
More information about corviz/router
Files in corviz/router
Package router
Short Description Routing system based on regular expressions for PHP 8.1+ with native Middleware support
License MIT
Informations about the package router
Router
Routing system based on regular expressions for PHP 8.1+ with native Middleware support
How to install
Router facade (singleton)
This is the most common use scenario. That is why we provide a ready-to-use facade.
First, you have to declare you application routes:
Then, execute and output the results.
Note: Router::dispatch() returns the value that was returned by controllers (a string in this example).
Controller classes
If you use classes as controllers, use an array as the second parameter in the route declaration.
Example controller class
Route for the controller above.
Supported methods
The supported methods for route declarations are: get
,post
,put
,patch
,delete
,options
,head
or any
Each represents one HTTP method, except for any
, which will attend to all of them
Middlewares
Middlewares are responsible for request pre and post processing.
We will accept callables or classes that extends Corviz\Router\Middleware
as middlewares for your application
To assign a Middleware do as follows:
Or if you want to assign multiple middlewares at once:
Grouping
To group multiple routes, you must first use the prefix
method, then just use group
with a callable
carrying those sub-routes. For example:
This will create the following routes:
- user/list
- user/(\d+)
- user/new
- user/(\d+)/update
- user/(\d+)/delete
Middleware for groups
You can assign middlewares for multiple routes at once by using the middleware
method between prefix
and group
Determine the current path and method manually
The 'dispatch()' method reads 'REQUEST_METHOD' and 'REQUEST_URI' indexes from $_SERVER superglobal to determine which route will be executed.
However, you may want to inform it manually. If so, just feed it as follows:
Multiple routers
If you have to work with multiple routers for whatever reason, all you have to do is the class Dispatcher, instead of the router facade
Then, register and execute the routes as usual: