Download the PHP package nilportugues/laravel5-haljson without Composer

Laravel 5 HAL+JSON

1. Installation
2. Configuration
3. Mapping
   • 3.1 Mapping with arrays
   • 3.2 Mapping with Mapping class
4. HAL Serialization
5. HAL Paginated Resource
6. PSR-7 Response Objects

1. Installation

Use Composer to install the package:

2. Configuration

Open up config/app.php and add the following line under providers array:

Also, enable Facades by uncommenting:

3. Mapping

For instance, lets say the following object has been fetched from a Repository , lets say PostRepository - this being implemented in Eloquent or whatever your flavour is:

We will have to map all the involved classes. This can be done as one single array, or a series of Mapping classes.

Also we will require to have routes. The routes must be named routes.

For instance our app/Http/routes.php file contains the following routes:

3.1 Mapping with arrays

Create a haljson.php file in config/ directory. This file should return an array returning all the class mappings.

And a series of mappings, placed in bootstrap/haljson.php, that require to use named routes so we can use the route() helper function:

3.2 Mapping with Mapping class

In order to map with Mapping class, you need to create a new class for each involved class.

This mapping fashion scales way better than using an array. Place each mapping in a separate file.

All Mapping classes will extend the \NilPortugues\Api\Mappings\HalMapping interface.

All the mappings will be contained in the array in the bootstrap/haljson.php, but this time the fully qualified class name is required instead.

3. HAL Serialization

All of this set up allows you to easily use the Serializer service as follows:

Output:

5. HAL Paginated Resource

A pagination object to easy the usage of this package is provided.

For both XML and JSON output, use the HalPagination object to build your paginated representation of the current resource.

Methods provided by HalPagination are as follows:

• setSelf($self)
• setFirst($first)
• setPrev($prev)
• setNext($next)
• setLast($last)
• setCount($count)
• setTotal($total)
• setEmbedded(array $embedded)

In order to use it, create a new HalPagination instance, use the setters and pass the instance to the serialize($value) method of the serializer.

Everything else will be handled by serializer itself. Easy as that!

6. Response objects

The following HalJsonResponseTrait methods are provided to return the right headers and HTTP status codes are available:

Quality

To run the PHPUnit tests at the command line, go to the tests directory and issue phpunit.

This library attempts to comply with PSR-1, PSR-2, PSR-4 and PSR-7.

If you notice compliance oversights, please send a patch via Pull Request.

Contribute

Contributions to the package are always welcome!

• Report any bugs or issues you find on the issue tracker.
• You can grab the source code at the package's Git repository.

Support

Get in touch with me using one of the following means:

• Emailing me at [email protected]
• Opening an Issue

Authors

• Nil Portugués Calderó
• The Community Contributors

License

The code base is licensed under the MIT license.