laravel-api-response
A Laravel wrapper for thephpleague's Fractal package
Install
Via Composer
composer require lykegenes/laravel-api-response
Then, add this to your Service Providers :
Lykegenes\ApiResponse\ServiceProvider::class,
...and this to your Aliases :
'ApiResponse' => Lykegenes\ApiResponse\Facades\ApiResponse::class,
Optionally, you can publish and edit the configuration file :
php artisan vendor:publish --provider="Lykegenes\ApiResponse\ServiceProvider" --tag=config
Usage
The easiest way to use this package is to call the make() function from the facade. It will try to guess your input. For the transformers, see the docs from the Fractal package here.
// You can use a class directly to return a paginated collection
return ApiResponse::make(User::class, UserTransformer::class);
// You can also use an Eloquent Query
return ApiResponse::make(User::where('age', '<', '40'), UserTransformer::class);
// This will return a single object
return ApiResponse::make(User::findOrFail($id), UserTransformer::class);
Testing
composer test
Credits
License
The MIT License (MIT). Please see License File for more information.