HTTP Responses

Of course, all routes and controllers should return some kind of response to be sent back to the user's browser. Lumen provides several different ways to return responses. The most basic response is simply returning a string from a route or controller:

The given string will automatically be converted into an HTTP response by the framework.

Response Objects

However, for most routes and controller actions, you will be returning a full instance. Returning a full Response instance allows you to customize the response's HTTP status code and headers. A Response instance inherits from the Symfony\Component\HttpFoundation\Response class, providing a variety of methods for building HTTP responses:

  1. use Illuminate\Http\Response;
  3. $router->get('home', function () {
  4.     return (new Response($content, $status))
  5.                   ->header('Content-Type', $value);
  6. });

For convenience, you may also use the response helper:

  1. $router->get('home', function () {
  2.     return response($content, $status)
  3.                   ->header('Content-Type', $value);
  4. });

Attaching Headers To Responses

Keep in mind that most response methods are chainable, allowing for the fluent building of responses. For example, you may use the header method to add a series of headers to the response before sending it back to the user:

  1. return response($content)
  3.             ->header('X-Header-Two', 'Header Value');

The response helper may be used to conveniently generate other types of response instances. When the response helper is called without arguments, an implementation of the Laravel\Lumen\Http\ResponseFactory class is returned. This class provides several helpful methods for generating responses.

JSON Responses

The json method will automatically set the Content-Type header to application/json, as well as convert the given array into JSON using the json_encode PHP function:

  1. return response()->json(['name' => 'Abigail', 'state' => 'CA']);

You can optionally provide a status code and an array of additional headers:

  1. return response()->json(['error' => 'Unauthorized'], 401, ['X-Header-One' => 'Header Value']);

If you would like to create a JSONP response, you may use the json method in addition to setCallback:

  1. return response()
  2.             ->json(['name' => 'Abigail', 'state' => 'CA'])
  3.             ->setCallback($request->input('callback'));

File Downloads

Note: Symfony HttpFoundation, which manages file downloads, requires the file being downloaded to have an ASCII file name.

Redirect responses are instances of the Illuminate\Http\RedirectResponse class, and contain the proper headers needed to redirect the user to another URL. There are several ways to generate a RedirectResponse instance. The simplest method is to use the global redirect helper method:

  1. $router->get('dashboard', function () {
  2.     return redirect('home/dashboard');
  3. });

Redirecting To Named Routes

When you call the redirect helper with no parameters, an instance of Laravel\Lumen\Http\Redirector is returned, allowing you to call any method on the Redirector instance. For example, to generate a RedirectResponse to a named route, you may use the route method:

  1. return redirect()->route('login');

If your route has parameters, you may pass them as the second argument to the route method:

  1. // For a route with the following URI: profile/{id}
  3. return redirect()->route('profile', ['id' => 1]);

If you are redirecting to a route with an "ID" parameter that is being populated from an Eloquent model, you may simply pass the model itself. The ID will be extracted automatically: