vice/laravel-fractal

Fractal helpers for Laravel 5

Another Fractal Service Provider for Laravel 5 and Lumen

, _(*1)

Fractal lets you present API data in a consistent way, by acting as an anti-corruption layer between your frontend and backend., _(*2)

Read up on Fractal here., _(*3)

Installation

Require this package, _(*4)

composer require vice/laravel-fractal

And then add the following to the service providers in app.php, _(*5)

Vice\LaravelFractal\FractalServiceProvider::class,

Usage

To send a JSON representation of a single entity to the frontend simply, _(*6)

public function show($id)
{
    //...

    fractalResponse()->item($thing, new ThingTransformer);
}

To send a JSON representation of a collection of entities to the frontend simply, _(*7)

public function index()
{
    //...

    fractalResponse()->collection($things, new ThingTransformer);
}

The collection method also supports paginators, and will automatically append their state under a meta key, _(*8)

If you need to transform data without immediately using it in a response you may inject Vice\LaravelFractal\FractalService into your controller / class and use it as so:, _(*9)

$json = $this->fractalService->item($thing, new ThingTransformer)->toJson();

Contributing

Please open any issues or pull requests on GitHub. This package is maintained by max.brokman@vice.com, _(*10)

For PRs please run the style fixer (vendor/bin/php-cs-fixer fix) before submitting., _(*11)