2017 © Pedro Peláez
 

library jsonresponses

A trait containing common JSON responses for an API built with Laravel 5.1.

image

delatbabel/jsonresponses

A trait containing common JSON responses for an API built with Laravel 5.1.

  • Monday, August 29, 2016
  • by delatbabel
  • Repository
  • 2 Watchers
  • 0 Stars
  • 118 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 10 Versions
  • 0 % Grown

The README.md

JSON Responses

Build Status StyleCI Latest Stable Version Total Downloads, (*1)

Common JSON responses for an API built with Laravel 5.1., (*2)

Features

This trait does the following:, (*3)

  • It returns generic (predefined) JSON responses for common API actions like creating, updating, destroying, indexing and showing a resource.
  • It can be easily extended and modified
  • It can be used anywhere in your application (controllers, routes etc...)

Installation

composer require delatbabel/jsonresponses

In your class do this:, (*4)

use Delatbabel\JsonResponses\JsonResponses;

class MyController
{
    use JsonResponses;
    // ...
}

Examples

Success Response With Data

return $this->respondSuccess('OK', ['time' => gmtime()]);

Failure Response

return $this->respondInternalError();

Failure Response With Message and Data

return $this->respondNotAcceptable(
    'Mugwumps are not found in swamps',
    ['location' => 'desert']);

Choosing a Status Code

See https://httpstatuses.com/ and http://racksburg.com/choosing-an-http-status-code/, (*5)

Architecture

Rationale

Many APIs have generic response formats for returning a success/fail response, a response code, a message, and some data. There are a few packages out there including Syndra (Mario Basic), which do similar things but I gone back to this, which was my original implementation as a trait, because it does all of what I what I need to do., (*6)

This provides generic JSON responses for when a resource is created, updated, destroyed, indexed, etc, as well as a generic error format., (*7)

To Trait Or Not To Trait?

Many developers have derided the use of PHP 5.4+ traits on the basis that they are really just methods to hide simple cut/paste code. Certainly they have their disadvantages, not the least of which is difficulty in providing stand-alone tests for them., (*8)

In this case I decided to implement this as a trait anyway, because I wanted all of my API controllers to return an identical response format, and this was a simple way of doing it., (*9)

A lot of software designers have suggested that traits should not provide data, only methods, which makes them look more exactly like Ruby's "mixins". However PHP does provide limited capability for traits to hold data and so I have implemented a simple protected variable to store the response code between calls., (*10)

Response Format

The response format emitted by this trait will look like this (in JSON):, (*11)

response: {
    success: true,      // true or false
    message: message,   // arbitrary message goes here
    response_code: code // response code goes here
},
data: { ...
}                       // arbitrary data structure goes here

The HTTP response code is repeated inside the response hash for easy access., (*12)

The Versions

29/08 2016

dev-master

9999999-dev

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Del

laravel api json laravel5

27/08 2016

dev-analysis-8LmwbK

dev-analysis-8LmwbK

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

15/03 2016

v1.2.5

1.2.5.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

15/03 2016

v1.2.4

1.2.4.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

18/02 2016

v1.2.3

1.2.3.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

28/12 2015

v1.2.2

1.2.2.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

28/12 2015

v1.2.1

1.2.1.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

09/12 2015

v1.2

1.2.0.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

09/12 2015

v1.1

1.1.0.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5

09/12 2015

v1.0

1.0.0.0

A trait containing common JSON responses for an API built with Laravel 5.1.

  Sources   Download

MIT

The Requires

 

by Del

laravel api json laravel5