Package Data | |
---|---|
Maintainer Username: | dmavrin |
Maintainer Contact: | max@lanin.me (Maxim Lanin) |
Package Create Date: | 2017-03-06 |
Package Last Update: | 2017-04-18 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-20 03:02:56 |
Package Statistics | |
---|---|
Total Downloads: | 60 |
Monthly Downloads: | 0 |
Daily Downloads: | 0 |
Total Stars: | 0 |
Total Watchers: | 1 |
Total Forks: | 0 |
Total Open Issues: | 0 |
All in one solution for exception for JSON REST APIs on Laravel and Lumen.
The goal of this package is to provide you with a set of most common exceptions that may be needed while developing JSON REST API. It also:
PHP 5.4+ or HHVM 3.3+, Composer and Laravel 5.1+ are required.
To get the latest version of Laravel Laravel-API-Debugger, simply add the following line to the require block of your composer.json
file.
For Laravel 5.1
"lanin/laravel-api-exceptions": "^0.1.0"
For Laravel 5.3
"lanin/laravel-api-exceptions": "^0.3.0"
You'll then need to run composer install
or composer update
to download it and have the autoloader updated.
Once Laravel-API-Exceptions is installed, you need to register the service provider. Open up config/app.php
and add the following to the providers key.
Lanin\Laravel\ApiExceptions\ApiExceptionsServiceProvider::class,
Every ApiException can be thrown as a normal exception and they will be automatically serialized to JSON with corresponding HTTP status, if user wants json:
{
"error_id": "not_found",
"error_message": "Requested object not found."
}
This object will be also populated with trace info, when APP_DEBUG
is true.
Also it can have meta
attribute when there is additional info. For example for validation errors:
{
"error_id": "validation_failed",
"error_message": "Validation failed.",
"error_meta": {
"errors": {
"tags": [{
"rule": "max.array",
"message": "The tags may not have more than 10 items.",
"parameters": ["10"]
}]
}
}
}
For ValidationApiException
, meta attribute has errors
object that contains validations errors.
Every attribute of this object is a name of a request parameter to validate to and value is an array of errors with description.
Since version 0.3.0 for Laravel 5.3 package can also return html view of the error, if Accept
header not equals application/json
.
To change included views publish them via:
$ php artisan vendor:publish --tag=laravel-api-exceptions
Extend your default exceptions handler with:
\Lanin\Laravel\ApiExceptions\LaravelExceptionHandler
for Laravel\Lanin\Laravel\ApiExceptions\LumenExceptionHandler
for LumenAnd remove everything else. Example:
<?php
namespace App\Exceptions;
use Lanin\Laravel\ApiExceptions\LaravelExceptionHandler;
class Handler extends LaravelExceptionHandler
{
}
To use FormRequest extend all your Request classes with \Lanin\Laravel\ApiExceptions\Support\Request
.
It will automatically support validation errors and pass them to the output.
It also has a very handy helper method validatedOnly()
that returns from request only those items that are registered in rules method.
Please feel free to fork this package and contribute by submitting a pull request to enhance the functionalities.