Download the PHP package mateodioev/http-router without Composer
On this page you can find all versions of the php package mateodioev/http-router. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mateodioev/http-router
More information about mateodioev/http-router
Files in mateodioev/http-router
Package http-router
Short Description Simple route in php with support for vars in url
License MIT
Informations about the package http-router
Simple HTTP router
:warning: This project was made for educational purposes only. It is not intended to be used in production environments.
Usage
Methods
You can use the Router::get
, Router::post
, Router::put
, Router::patch
and Router::delete
methods to register your endpoints.
$uri
is the path of the endpoint.$callback
is the function that will be executed when the endpoint is requested. Each callback (action) must return an instance of the Mateodioev\HttpRouter\Response class or an InvalidReturnException will be thrown.
Static files
You can map all static files in a directory with the static
method.
Example:
Now you can reach this uris
- /docs/index.php
- /docs/styles.css
Handling all HTTP methods
You can use the Router::all
method to handle all HTTP methods with one callback.
Path parameters
You can use path parameters in your endpoints. Path parameters are defined by a bracket followed by the name of the parameter.
/users/{id}
Note: You can make a parameter optional by adding a question mark after the name of the parameter.
/users/{id}?
Request data
You can get all data from the request with the following methods:
Request::method()
returns the HTTP method of the request.Request::uri()
returns the URI of the request.Request::uri()
returns the URL of the request.Request::param($name, $default = null)
returns the value of the parameter with the name$name
or null if the parameter is not present.Request::params()
return al the request URI parameters.Request::headers()
returns an array with all the headers of the request.Request::body()
returns the body of the request (from php://input).Request::data()
returns an array with all the data of the request. Use this when Content-Type is application/x-www-form-urlencoded or multipart/form-data.Request::files()
returns an array with all the files of the request.Request::query()
returns an array with all the query parameters from the uri.
TODO list:
- [ ] Add support for middlewares.
- [ ] Add support for custom error handlers.