An easy to use Fractal integration for Laravel applications

#Spatie Laravel Fractal Package

The Spatie Laravel Fractal package provides a simplified wrapper for the Fractal library, which is designed to handle complex data transformations in API development. It integrates seamlessly into Laravel and Lumen applications, making the process of transforming data models into arrays or JSON output more intuitive and efficient.

#Key Features

• Simplified Syntax: Streamlines the process of transforming data with a concise and easy-to-use syntax.
• Facade Support: Includes a facade for traditional Laravel style coding.
• Integration with Eloquent: Directly transform data retrieved from Eloquent models.
• Auto Includes: Automatically handle API resource inclusion based on request parameters.
• Customizable: Publish and customize configuration settings like default serializer, paginator, or even the base Fractal class.
• Quick Transformations: Facilitates quick transformations with minimal code, ideal for rapid API development.

#Installation

For Laravel 5.5 and newer:

composer require spatie/laravel-fractal

The package will auto-register. To publish and modify the configuration:

php artisan vendor:publish --provider="Spatie\Fractal\FractalServiceProvider"

#Usage

Transforming data is straightforward:

$books = fractal($books, new BookTransformer())->toArray();

To return a JSON response in a Laravel application:

return fractal($books, new BookTransformer())->respond();

Additional response customization options include setting status codes, headers, and JSON encoding options.

#Extending Functionality

The package allows for macroable extensions to the Fractal class, enabling developers to add custom methods without cluttering the primary codebase.

#Development and Support

• Running Tests: Execute composer test to run the test suite.
• Contributions: Contributions are welcome, and the guidelines are listed in the CONTRIBUTING document.
• Security Issues: Direct security-related concerns to Spatie via their provided contact email.

For a comprehensive understanding of all available methods and further examples, developers should refer to the documentation of spatie/fractalistic.

This package streamlines working with complex data transformations in Laravel, enhancing API development with its elegant approach to managing resource output.