Downloads
Stars
Version
Extensible and powerful API response package for Laravel.
You can install the package via composer:
composer require arinasystems/laravel-json-response
The package will automatically register its service provider.
You can optionally publish the config file with:
php artisan vendor:publish --tag="json-response:config"
use ArinaSystems\JsonResponse\Facades\JsonResponse;
/**
* Display a listing of products.
*
* @return \Illuminate\Http\Response
*/
public function index()
{
$products = Product::paginate(2);
return JsonResponse::json('ok', ['data' => ProductResource::collection($products)]);
}
With just one line of code, your API client will get this response:
{
"success": true,
"code": 200,
"http_code": 200,
"locale": "en",
"message": "ok",
"data": [
{
"id": "7OLgzrB1QVBQWMNZ3Rx08a24wAGEjqYVbeV",
"name": "Aquafina Plastic Water Gallon – 18.9 L",
"in_stock": true,
"in_cart": false
...
},
{
"id": "g3RbPoyMmPg9zr7qGZjW50Lp61aDlwnVOkE",
"name": "Aquafina Plastic Water Bottle – 1.5 L",
"in_stock": true,
"in_cart": true
...
}
],
"additional": null,
"links": {
"first": "http://example.com/api/customer/products?page=1",
"last": "http://example.com/api/customer/products?page=2",
"prev": null,
"next": "http://example.com/api/customer/products?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 2,
"path": "http://example.com/api/customer/products",
"per_page": "2",
"to": 2,
"total": 3
}
}
You can customize the response configuration from config/json-response.php
file.
<?php
return [
'attributes' => [
'success' => [
'builder' => \ArinaSystems\JsonResponse\Builders\SuccessAttributeBuilder::class,
'value' => true,
'on-response' => true,
'on-error' => true,
],
'code' => [
'builder' => null,
'value' => 200,
'on-response' => true,
'on-error' => true,
],
'http_code' => [
'builder' => null,
'value' => 200,
'on-response' => true,
'on-error' => true,
],
'locale' => [
'builder' => \ArinaSystems\JsonResponse\Builders\LocaleAttributeBuilder::class,
'value' => null,
'on-response' => true,
'on-error' => true,
],
'message' => [
'builder' => \ArinaSystems\JsonResponse\Builders\MessageAttributeBuilder::class,
'value' => null,
'on-response' => true,
'on-error' => true,
],
'data' => [
'builder' => \ArinaSystems\JsonResponse\Builders\DataAttributeBuilder::class,
'value' => null,
'on-response' => true,
'on-error' => false,
],
'headers' => [
'value' => [],
'on-response' => false,
'on-error' => false,
],
'exception' => [
'builder' => \ArinaSystems\JsonResponse\Builders\ExceptionAttributeBuilder::class,
'value' => null,
'on-response' => false,
'on-error' => true,
],
'errors' => [
'builder' => \ArinaSystems\JsonResponse\Builders\ErrorsAttributeBuilder::class,
'value' => [],
'on-response' => false,
'on-error' => true,
],
'debug' => [
'builder' => \ArinaSystems\JsonResponse\Builders\DebugAttributeBuilder::class,
'value' => null,
'on-response' => false,
'on-error' => true,
],
'additional' => [
'builder' => null,
'value' => null,
'on-response' => true,
'on-error' => true,
],
'links' => [
'builder' => null,
'value' => null,
'on-response' => true,
'on-error' => true,
],
'meta' => [
'builder' => null,
'value' => null,
'on-response' => true,
'on-error' => true,
],
],
'status' => [
'ok' => \ArinaSystems\JsonResponse\Status\OkStatus::class,
],
'transformers' => [
\Illuminate\Database\Eloquent\Model::class => \ArinaSystems\JsonResponse\Transformers\EloquentTransformer::class,
\Illuminate\Http\Resources\Json\JsonResource::class => \ArinaSystems\JsonResponse\Transformers\JsonResourceTransformer::class,
],
'encoding_options' => JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_AMP | JSON_HEX_QUOT | JSON_UNESCAPED_UNICODE,
'debug' => env('APP_DEBUG', false),
'message_translations' => true,
];
The first section in the configuration file allows you to set up the normal response and error response attributes. Each attribute array contains four options:
In transformers array define the preset statuses in the "Status" array. The key defines the status name, and the value is the name of the case class.
Specify the data transformer for the given object type as a key and the transformer class as the value.
Set the json encoding options in 'encoding_options'.
Enable/Disable the debugging mode in 'debug' option.
Enable/Disable the locale response message in 'message_translations' option.
composer test
Please see CHANGELOG for more information what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.