tembra / jsonapi-errors-php
A PHP implementation of JSON API Errors compliant format.
Requires
- php: >=5.4.0
- neomerx/json-api: =0.8.8
Suggests
- dingo/api: A RESTful API package for the Laravel and Lumen frameworks.
This package is not auto-updated.
Last update: 2024-10-26 20:26:27 UTC
README
Description
This framework agnostic package implements a simple and efficient way to throw or respond errors in JSON API specification version v1.0 as described in JSON API Errors. It also helps creating documentation for these errors on your application. It is based on 3rd party package neomerx/json-api
that fully implements the JSON API Format.
It greatly simplifies the error processing with high code quality.
Still framework agnostic, you can easily integrate it with Laravel/Lumen and Dingo API.
Milestone to v1.0
- Makes JSON API Errors as simple as calling a function
- Standardize the errors
- Provide most common error functions for HTTP Status Codes
- Throw an exception or return the JSON string
- Override JSON API Error Objects members
- Support for Localization
- Generate Documentation for Application Error Codes
- Build PHPUnit tests
Sample usage
Assuming you don't want a specific class to standardize the errors and also don't want the documentation or localization, you can use as simple as this:
echo MyJsonApiErrors::badRequest([ 827 => [ 'title' => 'Another Error', 'detail' => 'Detailed error description' ] ], false);
will output as string
{ "errors": [ { "status": "400", "code": "827", "title": "Another Error", "detail": "Detailed error description" } ] }
The first parameter is an associative array where key
is the error code
in JSON API compliant format and value
is another associative array where key/value
pairs are some others members that JSON API Error Objects may have.
The second parameter false
is to define whether a JsonApiException
should be thrown or only the JSON string should be returned.
For more advanced usage please check out the Wiki.
Questions?
Do not hesitate to contact me on tdt@mytdt.com.br or post an issue.
License
BSD 3-Clause. Please see License File for more information.