The Slim Framework’s router is built on top of the nikic/fastroute component, and it is remarkably fast and stable.
You can define application routes using proxy methods on the \Slim\App instance. The Slim Framework provides methods for the most popular HTTP methods.
You can add a route that handles only GET HTTP requests with the Slim
application’s get() method. It accepts two arguments:
$app = new \Slim\App();
$app->get('/books/{id}', function ($request, $response, $args) {
// Show book identified by $args['id']
// ...
return $response;
});
You can add a route that handles only POST HTTP requests with the Slim
application’s post() method. It accepts two arguments:
$app = new \Slim\App();
$app->post('/books', function ($request, $response, $args) {
// Create new book
// ...
return $response;
});
You can add a route that handles only PUT HTTP requests with the Slim
application’s put() method. It accepts two arguments:
$app = new \Slim\App();
$app->put('/books/{id}', function ($request, $response, $args) {
// Update book identified by $args['id']
// ...
return $response;
});
You can add a route that handles only DELETE HTTP requests with the Slim
application’s delete() method. It accepts two arguments:
$app = new \Slim\App();
$app->delete('/books/{id}', function ($request, $response, $args) {
// Delete book identified by $args['id']
// ...
return $response;
});
You can add a route that handles only OPTIONS HTTP requests with the Slim
application’s options() method. It accepts two arguments:
$app = new \Slim\App();
$app->options('/books/{id}', function ($request, $response, $args) {
// Return response headers
// ...
return $response;
});
You can add a route that handles only PATCH HTTP requests with the Slim
application’s patch() method. It accepts two arguments:
$app = new \Slim\App();
$app->patch('/books/{id}', function ($request, $response, $args) {
// Apply changes to book identified by $args['id']
// ...
return $response;
});
You can add a route that handles all HTTP request methods with the Slim application’s any() method. It accepts two arguments:
$app = new \Slim\App();
$app->any('/books/[{id}]', function ($request, $response, $args) {
// Apply changes to books or book identified by $args['id'] if specified.
// To check which method is used: $request->getMethod();
// ...
return $response;
});
Note that the second parameter is a callback. You could specify a Class (which need a __invoke() implementation) instead of a Closure. You can then do the mapping somewhere else:
$app->any('/user', 'MyRestfulController');
You can add a route that handles multiple HTTP request methods with the Slim application’s map() method. It accepts three arguments:
$app = new \Slim\App();
$app->map(['GET', 'POST'], '/books', function ($request, $response, $args) {
// Create new book or list all books
// ...
return $response;
});
Each routing method described above accepts a callback routine as its final argument. This argument can be any PHP callable, and by default it accepts three arguments.
Psr\Http\Message\ServerRequestInterface object that represents the current HTTP request.Psr\Http\Message\ResponseInterface object that represents the current HTTP response.There are two ways you can write content to the HTTP response. First, you can simply echo() content from the route callback. This content will be appended to the current HTTP response object. Second, you can return a Psr\Http\Message\ResponseInterface object.
If you use a Closure instance as the route callback, the closure’s state is bound to the Container instance. This means you will have access to the DI container instance inside of the Closure via the $this keyword:
$app = new \Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
// Use app HTTP cookie service
$this->get('cookies')->set('name', [
'value' => $args['name'],
'expires' => '7 days'
]);
return $response;
});
You can add a route that redirects GET HTTP requests to a different URL with
the Slim application’s redirect() method. It accepts three arguments:
string or a
Psr\Http\Message\UriInterface302 if unset)$app = new \Slim\App();
$app->redirect('/books', '/library', 301);
redirect() routes respond with the status code requested and a Location
header set to the second argument.
The route callback signature is determined by a route strategy. By default, Slim expects route callbacks to accept the request, response, and an array of route placeholder arguments. This is called the RequestResponse strategy. However, you can change the expected route callback signature by simply using a different strategy. As an example, Slim provides an alternative strategy called RequestResponseArgs that accepts request and response, plus each route placeholder as a separate argument. Here is an example of using this alternative strategy; simply replace the foundHandler dependency provided by the default \Slim\Container:
$c = new \Slim\Container();
$c['foundHandler'] = function() {
return new \Slim\Handlers\Strategies\RequestResponseArgs();
};
$app = new \Slim\App($c);
$app->get('/hello/{name}', function ($request, $response, $name) {
$response->getBody()->write($name);
return $response;
});
You can provide your own route strategy by implementing the \Slim\Interfaces\InvocationStrategyInterface.
Each routing method described above accepts a URL pattern that is matched against the current HTTP request URI. Route patterns may use named placeholders to dynamically match HTTP request URI segments.
A route pattern placeholder starts with a {, followed by the placeholder name, ending with a }. This is an example placeholder named name:
$app = new \Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
$response->getBody()->write("Hello, " . $args['name']);
return $response;
});
To make a section optional, simply wrap in square brackets:
$app->get('/users[/{id}]', function ($request, $response, $args) {
// responds to both `/users` and `/users/123`
// but not to `/users/`
return $response;
});
Multiple optional parameters are supported by nesting:
$app->get('/news[/{year}[/{month}]]', function ($request, $response, $args) {
// responds to `/news`, `/news/2016` and `/news/2016/03`
return $response;
});
For “Unlimited” optional parameters, you can do this:
$app->get('/news[/{params:.*}]', function ($request, $response, $args) {
$params = explode('/', $args['params']);
// $params is an array of all the optional segments
return $response;
});
In this example, a URI of /news/2016/03/20 would result in the $params array
containing three elements: ['2016', '03', '20'].
By default, the placeholders are written inside {} and can accept any
values. However, placeholders can also require the HTTP request URI to match a particular regular expression. If the current HTTP request URI does not match a placeholder regular expression, the route is not invoked. This is an example placeholder named id that requires one or more digits.
$app = new \Slim\App();
$app->get('/users/{id:[0-9]+}', function ($request, $response, $args) {
// Find user identified by $args['id']
// ...
return $response;
});
Application routes can be assigned a name. This is useful if you want to programmatically generate a URL to a specific route with the router’s pathFor() method. Each routing method described above returns a \Slim\Route object, and this object exposes a setName() method.
$app = new \Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
$response->getBody()->write("Hello, " . $args['name']);
// ...
return $response;
})->setName('hello');
You can generate a URL for this named route with the application router’s pathFor() method.
echo $app->getContainer()->get('router')->pathFor('hello', [
'name' => 'Josh'
]);
// Outputs "/hello/Josh"
The router’s pathFor() method accepts two arguments:
To help organize routes into logical groups, the \Slim\App also provides a group() method. Each group’s route pattern is prepended to the routes or groups contained within it, and any placeholder arguments in the group pattern are ultimately made available to the nested routes:
$app = new \Slim\App();
$app->group('/users/{id:[0-9]+}', function (App $app) {
$app->map(['GET', 'DELETE', 'PATCH', 'PUT'], '', function ($request, $response, $args) {
// Find, delete, patch or replace user identified by $args['id']
})->setName('user');
$app->get('/reset-password', function ($request, $response, $args) {
// Route for /users/{id:[0-9]+}/reset-password
// Reset the password for user identified by $args['id']
})->setName('user-password-reset');
});
The group pattern can be empty, enabling the logical grouping of routes that do not share a common pattern.
$app->group('', function(App $app) {
$app->get('/billing', function ($request, $response, $args) {
// Route for /billing
});
$this->get('/invoice/{id:[0-9]+}', function ($request, $response, $args) {
// Route for /invoice/{id:[0-9]+}
});
})->add(new SharedMiddleware());
Note inside the group closure, $this can be used instead of $app. Slim binds the closure to the application instance for you, just like it is the case with route callback binds with container instance.
$this is bound to the instance of Slim\App$this is bound to the instance of Slim\ContainerYou can also attach middleware to any route or route group. Learn more.
It’s possible to enable router cache by setting valid filename in default Slim settings. Learn more.
You are not limited to defining a function for your routes. In Slim there are a few different ways to define your route action functions.
In addition to a function, you may use:
container_key:methodClass:methodcontainer_keyThis functionality is enabled by Slim’s Callable Resolver Class. It translates a string entry into a function call. Example:
$app->get('/', '\HomeController:home');
Alternatively, you can take advantage of PHP’s ::class operator which works well with IDE lookup systems and produces the same result:
$app->get('/', \HomeController::class . ':home');
In this code above we are defining a / route and telling Slim to execute the home() method on the HomeController class.
Slim first looks for an entry of HomeController in the container, if it’s found it will use that instance otherwise it will call it’s constructor with the container as the first argument. Once an instance of the class is created it will then call the specified method using whatever Strategy you have defined.
Create a controller with the home action method. The constructor should accept
the dependencies that are required. For example:
class HomeController
{
protected $view;
public function __construct(\Slim\Views\Twig $view) {
$this->view = $view;
}
public function home($request, $response, $args) {
// your code here
// use $this->view to render the HTML
return $response;
}
}
Create a factory in the container that instantiates the controller with the dependencies:
$container = $app->getContainer();
$container['HomeController'] = function($c) {
$view = $c->get("view"); // retrieve the 'view' from the container
return new HomeController($view);
};
This allows you to leverage the container for dependency injection and so you can inject specific dependencies into the controller.
Alternatively, if the class does not have an entry in the container, then Slim will pass the container’s instance to the constructor. You can construct controllers with many actions instead of an invokable class which only handles one action.
use Psr\Container\ContainerInterface;
class HomeController
{
protected $container;
// constructor receives container instance
public function __construct(ContainerInterface $container) {
$this->container = $container;
}
public function home($request, $response, $args) {
// your code
// to access items in the container... $this->container->get('');
return $response;
}
public function contact($request, $response, $args) {
// your code
// to access items in the container... $this->container->get('');
return $response;
}
}
You can use your controller methods like so.
$app->get('/', \HomeController::class . ':home');
$app->get('/contact', \HomeController::class . ':contact');
You do not have to specify a method in your route callable and can just set it to be an invokable class such as:
use Psr\Container\ContainerInterface;
class HomeAction
{
protected $container;
public function __construct(ContainerInterface $container) {
$this->container = $container;
}
public function __invoke($request, $response, $args) {
// your code
// to access items in the container... $this->container->get('');
return $response;
}
}
You can use this class like so.
$app->get('/', \HomeAction::class);
Again, as with controllers, if you register the class name with the container, then you can create a factory and inject just the specific dependencies that you require into your action class.