shalvah / laravel-jsend
Laravel helpers to easily send JSend-compliant responses
Installs: 72 161
Dependents: 1
Suggesters: 0
Security: 0
Stars: 62
Watchers: 5
Forks: 16
Open Issues: 0
Requires
- php: >=7.2.5
- laravel/framework: >= 7.0
Requires (Dev)
- ext-json: *
- orchestra/testbench: ^5.0|^6.0|8.0
- phpunit/phpunit: ^8.0|^10.0
README
Simple helpers to generate JSend-compliant responses for your Laravel app
The JSend specification lays down some rules for how JSON responses from web servers should be formatted. JSend is especially suited for REST-style applications and APIs.
Installation
Laravel 7 and above:
composer require shalvah/laravel-jsend
Laravel 5.1 - 6.*:
composer require shalvah/laravel-jsend:^1.0
Usage
In your controller:
public function create(Request $request) { $userData = $request->input('data'); if (empty($userData['email'])) return jsend_fail(['email' => 'Email is required']); try { $user = User::create($userData): return jsend_success($user); } catch (Exception $e) { return jsend_error('Unable to create user: '.$e->getMessage()); } }
You can also add the JsendExceptionFormatter
trait in App\Exceptions\Handler
to format JSON responses for unhandled exceptions and Laravel validation errors as JSend:
class Handler extends ExceptionHandler { use Shalvah\LaravelJsend\JsendExceptionFormatter; // ... }
Available helpers
jsend_success
The jsend_success
function creates a JSend success response instance.
return jsend_success([ "id" => 2, "title" => "New life", "body" => "Trust me, this is great!" ]);
Generates a response:
{ "status": "success", "data": { "id": 2, "title": "New life", "body": "Trust me, this is great!" } }
You may pass an Eloquent model instead of an array as the "data" object:
$post = Post::find($id); return jsend_success($post);
jsend_fail
The jsend_fail
function creates a JSend fail response instance.
return jsend_fail([ "title" => "title is required", "body" => "body must be 50 - 10000 words" ]);
Generates a response:
{ "status": "fail", "data": { "title": "title is required", "body": "body must be 50 - 10000 words" } }
jsend_error
The jsend_error
function creates a JSend error response instance.
return jsend_error("Unable to connect to database");
Generates a response:
{ "status": "error", "message":"Unable to connect to database" }
You may also pass optional code
and data
objects.
return jsend_error("Unable to connect to database", 'E0001', ['type' => 'database error']);
Generates a response:
{ "status": "error", "message":"Unable to connect to database", "code": "E001", "data": { "type": "database error" } }
Note: for each helper, the HTTP status codes are set automatically (to 200, 400, and 500 for
success
,fail
, anderror
respectively), and the headerContent-type: application/json
is set. If you wish, you may specify a HTTP status code and additional headers as the last two parameters.
return jsend_success($post, 201, ["X-My-Header" => "header value"]); return jsend_fail(["location_id" => "Location not found"], 404); return jsend_error("Unable to connect to database", 'E0001', [], 503, ["X-My-Header" => "header value"]);
License
MIT