# Routing

Pinatra's routing is simple and powerful, with 100% coverage testing and quality assurance.

# Getting start

We use one of the easiest routes to get the home page as an example:

get('/', function() {
  echo "GET /";
});

# Avaliable HTTP mothods

Pinatra supports GET POST PUT PATCH DELETE OPTIONS HEAD several routing methods, the usage is very simple:

get('/', function() {
  echo "GET /";
});

post('/', function() {
  echo "POST /";
});

put('/', function() {
  echo "PUT /";
});

patch('/', function() {
  echo "PATCH /";
});

delete('/', function() {
  echo "DELETE /";
});

options('/', function() {
  echo "OPTIONS /";
});

head('/', function() {
  header('custom-header: hello Pinatra!');
});

# Response Type

Pinatra routing supports both closures and controller@methods. as follows:

# Closure

get('/', function() {
  echo "GET /";
});

# Controller@method

get('/', 'HomeController@home');

This type of response requires a combination of namespaces, autoloading, etc. See Controller for details.

# Routing Parameter

{param} can be adapted to any URL legal string except / ? #.

# Multiple usage shows

# Single element matching

get('{a}', function($a) {
  echo "GET /".$a; // GET /foo
});

get('hi/{a}', function($a) {
  echo "GET /hi".$a; // GET /hi/foo
});

get('{a}/hi', function($a) {
  echo "GET /".$a.'/hi'; // GET /foo/hi
});

# Multi-element matching

get('{a}/{b}', function($a, $b) {
  echo "GET /".$a.'/'.$b; // GET /foo/bar
});

get('{a}/hi/{b}', function($a, $b) {
  echo "GET /".$a.'/hi/'.$b; // GET /foo/hi/bar
});

# Other features

1. The first / is optional and does not affect system functionality.

# get('/', $response) and get('', $response) have the same function

# get('/hi', $response) and get('hi', $response) have the same function