Controller Responses

This page has a few basic examples of how to return responses from a controller action. These examples are using the Router class to define routes, but the same principles apply to any controller action.

Returning a string

The simplest way to return a response from a controller action is to return a string. This will be sent to the client as a plain text response.

Router::get('/', function(){
    return 'Hello World!';
});

Returning a JSON response

If you want to return a JSON response, you can return an array or object from the controller action. This will be automatically converted to a JSON response.

Router::get('/json', function(){
    return ['message' => 'Hello World!'];
});

Alternatively, you can return a Response object with the JSON content type set.

use Hazaar\Controller\Response\Json;
Router::get('/json', function(){
    return new Json(['message' => 'Hello World!']);
});

Returning an image

If you want to return an image, you can return a Response object with the image content type set.

use Hazaar\Controller\Response\Image;
Router::get('/image', function(){
    return new Image('path/to/image.jpg');
});

Returning a file

If you want to return a file, you can return a Response object with the file content type set.

use Hazaar\Controller\Response\File;
Router::get('/file', function(){
    return new File('path/to/file.txt');
});

Built-in HTTP Responses

Hazaar has a number of built-in response classes that you can use to return different types of HTTP responses. More of these will be added in the future, but for now there are a few basic ones.

Available built-in response classes:

• Hazaar\Controller\Response\HTTP\OK - 200 OK
• Hazaar\Controller\Response\HTTP\NoContent - 204 No Content
• Hazaar\Controller\Response\HTTP\Redirect - 301 Moved Permanently
• Hazaar\Controller\Response\HTTP\BadRequest - 400 Bad Request
• Hazaar\Controller\Response\HTTP\Unauthorized - 401 Unauthorized
• Hazaar\Controller\Response\HTTP\Forbidden - 403 Forbidden
• Hazaar\Controller\Response\HTTP\NotFound - 404 Not Found
• Hazaar\Controller\Response\HTTP\RateLimitExceeded - 429 Too Many Requests

Redirecting to another URL

If you want to redirect the client to another URL, you can return a Response object with the redirect status code set.

use Hazaar\Controller\Response\HTTP\Redirect;
Router::get('/redirect', function(){
    return new Redirect('https://hazaar.io');
});