Skip to content
Switch branches/tags

Latest commit

* Adding test scripts to composer.json for ease of use

* Testing github actions based off #501

* Fixing typo in matric

* Fixing setup php configuration in github action

* Sending coverage off to scrutinizer

* Removing circle ci config

* Matching travis PHP version checks

* Commenting out coverage report for scrutinizer

* Removing scrutinizer sending for now

* Testing github action and removing travis

* Adding travis config back - as it is causing issues on the PR

* Pushing to separate workflows

* Renaming main to run tests

* Adding scrutinizer steps as final steps so coverage report can be sent

* Swapping travis badge for github actions badge

Co-authored-by: Steve McDougall <>

Git stats


Failed to load latest commit information.


Latest Version Software License The PHP League Tests Coverage Status Quality Score Total Downloads

Fractal provides a presentation and transformation layer for complex data output, the like found in RESTful APIs, and works really well with JSON. Think of this as a view layer for your JSON/YAML/etc.

When building an API it is common for people to just grab stuff from the database and pass it to json_encode(). This might be passable for "trivial" APIs but if they are in use by the public, or used by mobile applications then this will quickly lead to inconsistent output.


  • Create a protective shield between source data and output, so schema changes do not affect users
  • Systematic type-casting of data, to avoid foreach()ing through and (bool)ing everything
  • Include (a.k.a embedding, nesting or side-loading) relationships for complex data structures
  • Work with standards like HAL and JSON-API but also allow custom serialization
  • Support the pagination of data results, for small and large data sets alike
  • Generally ease the subtle complexities of outputting data in a non-trivial API

This package is compliant with PSR-1, PSR-2 and PSR-4. If you notice compliance oversights, please send a patch via pull request.


Via Composer

$ composer require league/fractal


The following versions of PHP are supported by this version.

  • PHP 5.4
  • PHP 5.5
  • PHP 5.6
  • PHP 7.0
  • PHP 7.1
  • PHP 7.2
  • HHVM


Fractal has full documentation, powered by Jekyll.

Contribute to this documentation in the gh-pages branch.


  • add HAL serializers


$ phpunit


Please see CONTRIBUTING and CONDUCT for details.




The MIT License (MIT). Please see License File for more information.