codebot / laravel-response-builder
Simple package for Laravel framework to standardize the structure of JSON responses.
Installs: 17 043
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 0
Forks: 0
Open Issues: 2
Requires
- php: ^8.0
Requires (Dev)
- orchestra/testbench: ~6.0
- phpunit/phpunit: ^9.5
This package is auto-updated.
Last update: 2024-10-15 09:54:00 UTC
README
Package codebot/laravel-response-builder
is a simple package for Laravel framework to standardize the structure of JSON responses.
You will find this package helpful if you need your responses to look like this:
{ "status": true, "message": "You got that!", "data" : { "name": "James Joesph Bulger", "profession": "criminal" }, "errors": [] }
or
{ "status": false, "message": "Something went wrong...", "data" : [], "errors": { "email": [ "The email field is required." ] } }
Installation
composer require codebot/laravel-response-builder:^1
For Laravel 5.4 and versions below add \Rb\Core\RbServiceProvider::class
to providers in config/app.php file.
Next run the command below in your console:
php artisan vendor:publish --tag=laravel-response-builder
Requests
Once you published vendor, you should see App\Http\Requests\Rb\RbRequest class
. This will be base class for
laravel-response-builder's requests.
To generate a request that extends RbRequest, run:
php artisan make:rbrequest YourNewRequest
If you are using Laravel's Validator class, you can use Rb\Core\RbValidator
to standardize the structure of failed response.
use \Rb\Core\RbValidator; use Illuminate\Support\Facades\Validator; $validator = new Validator($data, $rules); // assuming you have a $validator instance RbValidator::validate($validator); // throws HttpResponseException or returns boolean true
RbValidator::validate() method checks if the validation fails and throws Illuminate\Http\Exceptions\HttpResponseException with the standardized json response structure.
Usage
use \Rb\Core\Response; use \Rb\Core\HttpStatusCode; $response = new Response(); $response->setStatusCode(HttpStatusCode::OK); // required. If code is 2XX then Response::status field will be "true", otherwise "false" $response->setMessage('Some inspiring message.'); // null will be returned if no message set $response->setData($data); // null will be returned if no data set $response->setErrors($errors); // null will be returned if no error set $response->getArray(); // will return an array of data set $response->getResponse(); // will return a json response using Laravel's response() helper
All setters are fluent, so example above could be written like:
use \Rb\Core\Response; use \Rb\Core\HttpStatusCode; $response = new Response(); $response->setStatusCode(HttpStatusCode::OK) ->setMessage('Some inspiring message.'); // ...
Package contains HttpStatusCode class with http status codes defined.
use \Rb\Core\HttpStatusCode; HttpStatusCode::OK; // returns status code 200 (integer) HttpStatusCode::getMessageByCode(HttpStatusCode::NOT_FOUND); // returns string "Not Found" HttpStatusCode::getCodeWithMessage(HttpStatusCode::CREATED); // returns string - code and message, e.g. "201 Created"
The Facade
The package contains a facade class in case if you don't want to interact with all of these setters.
use \Rb\Facade\Response; use \Rb\Core\HttpStatusCode; return Response::success( data: $data, message: 'Created List of users.' ); return Response::error( errors: $errors, message: 'Invalid input.', statusCode: HttpStatusCode::UNPROCESSABLE_ENTITY ); // Without $data (the $errors parameter is also optional) return Response::success(message: 'User deleted.');
$data
and $errors
variables are arrays and are optional.
Configuration
Once you have vendor published, you should see config/response_builder.php
file.
request_path - Generated request classes will be stored in specified directory.
request_namespace - Namespace for generated request class.
is_authorize - Default value of Request's authorize() method.
messages - Contains messages for Response's "message" field.
messages.failed_validation - Default message for response that failed the validation.
Fields
status
- boolean (Not Nullable)
status_code
- integer (Not Nullable)
message
- string (Nullable)
data
- array (Not Nullable, can be empty)
errors
- array (Not Nullable, can be empty)