File: README.md

Recommend this page to a friend!
  Classes of Ahmed Saad  >  PHP JSON Response Builder  >  README.md  >  Download  
File: README.md
Role: Documentation
Content type: text/markdown
Description: Documentation
Class: PHP JSON Response Builder
Compose an HTTP response dynamically in JSON
Author: By
Last change:
Date: 3 months ago
Size: 5,511 bytes
 

Contents

Class file image Download

<p align="center">

<img src="https://laravel.com/assets/img/components/logo-laravel.svg">
<h1 align="center">Json Response Builder Package</h1>

</p>

<p align="center"> <a href="https://travis-ci.org/ahmad-sa3d/json-response-builder"><img src="https://travis-ci.org/ahmad-sa3d/json-response-builder.svg?branch=master" alt="Build Status"></a> <a href="https://codeclimate.com/github/ahmad-sa3d/json-response-builder/maintainability"><img src="https://api.codeclimate.com/v1/badges/84d709814a320dc85f0a/maintainability" /></a> <a href="https://codeclimate.com/github/ahmad-sa3d/json-response-builder/test_coverage"><img src="https://api.codeclimate.com/v1/badges/84d709814a320dc85f0a/test_coverage" /></a> <a href="https://packagist.org/packages/saad/json-response-builder"><img src="https://poser.pugx.org/laravel/framework/license.svg" alt="License"></a> </p>

Install

	composer require saad/json-response-builder

Change Log

> V 1.3.1

add feature to merge meta when adding data

addData(str $key, mix $val, bool $merge_meta)

		
	$builder = new Saad\JsonResponseBuilder\JsonResponseBuilder();
	
	$builder->addData('users', [
		['name' => 'Ahmed Saad'],
		'meta' => [
			'name' => 'iam meta',
		]
	], true); // Note the third argument
	
	
	return $builder->getResponse();
	
	// Output
	
	{
        "success": true,
	
        "meta" : {
            'name' => 'iam meta',
        },
	
        "data": [
            'users': [
            		{"name": "Ahmed Saad"}
            ],
        ],
	
        "message": "Successfully Retrieved"
    }

> V 1.3

Add Strict Mode and enabled by default: in strict mode if data or meta are empty it will set it's value to null instead of []

to turn of strickt mode, on constructor pass false to disable strickt mode so that it will return data, and meta as empty array if they are empty

you can set mode on instance by the method strictMode(bool)


Usage

  • Basic Example:

    inside your controller:

    
    	$builder = new Saad\JsonResponseBuilder\JsonResponseBuilder();
    
    	$builder->mergeData([
    		['name' => 'Ahmed Saad'],
    		['name' => 'John Doe']
    	]);
    
    	$builder->addMeta([
    		'pagination' => [
    			'page' => 1,
    			'per_page' => 4,
    		]
    	]);
    
    	return $builder->getResponse();
    
    
  • the above example will output:

    
    	{
    		"success": true,
    
    		"meta" : {
    			"pagination": {
    				"page": 1,
    				"per_page": 4
    			}
    		},
    
    		"data": [
    			{"name": "Ahmed Saad"},
    			{"name": "John Doe"}
    		],
    
    		"message": "Successfully Retrieved"
    	}
    
    

Available Methods

addData($key, $value)

> Appends to data new member with the given key and value > > ` php > $builder->addData('doctors', ['ahmed', 'mohamed', 'saad']); > $builder->addData('patients', ['patient1', 'patient3', 'patient3']); > > // Output data will be > > "data": { > "doctors": ["ahmed", "mohamed", "saad"], > "patients" ["patient1", "patient4", "patient3"] > }, > > > `

mergeData($array)

> merge given array with data with given array keys as keys, this is usefull when we want to send data as json array insteadof json object with key and value > > this method also if the given array has key called 'meta' it will remove that key and add it to response meta > > ` php > $builder->mergeData(['ahmed', 'mohamed', 'meta' => ['key' => 'Iam Meta']]); > > // Output will be > > { > "success": true, > "meta": { > "key": "Iam Meta" > }, > "data": [ > "ahmed", > "mohamed" > ], > "message": "Successfully Retrieved" > } > > `

addMeta($key, $value)

> Appends to meta new member with the given key and value

mergeMeta($array)

> merge given array with meta

addHeader($header, $value)

> add header to response headers

success($response_message = null)

> set response success status to __true__, and set response message if supplied.

setMessage($response_message = null)

> set response message if supplied.

error($message = null, $error_code = null)

> set response success status to __false__ and set nessage and error code > > ` php > $builder->error('Fails!', 2345); > > // Output will be > > { > "success": false, > "meta": null, > "data": null, > 'error': { > "message": "Fails!", > "code": 2345 > } > "message": "Fails!" > }

addError($key, mixed $value)

> Add key to error array > > ` php > $builder->error('Fails!', 2345) > ->addError('validation', 'validation value'); > > // Output will be > > { > "success": false, > "meta": null, > "data": null, > 'error': { > "message": "Fails!", > "code": 2345, > "validation": "validation value" > } > "message": "Fails!" > }

setStatusCode(301)

> set response status code.

strictMode(bool)

> default value true > > since V1.3 > > enable or disable strict mode. > > ` php > $builder->getResponse(); > > // Strict Mode Enabled, Output will be > > { > "success": false, > "meta": null, > "data": null, > "message": "" > } > > $builder->strictMode(false)->getResponse(); > > // Strict Mode Disabled, Output will be > > { > "success": false, > "meta":[], > "data":[], > "message": "" > }

getResponse($status_code = null)

> set response status code if supplied, and return Response Object

License

The Laravel framework is open-sourced software licensed under the MIT license.README.md

For more information send a message to info at phpclasses dot org.