Download the PHP package bornfight/jsonapi-documentation without Composer

jsonapi-documentation

This is a Symfony 5 package that is meant to be used in combination with Pakhanad JsonApi Bundle. It can be used to generate Api documentation at anytime during the development, not only after generating entities. This can be particularly useful when you need to make a lot of changes on your domain model during development.

Installation

To install this package use composer:

Register you bundle by adding:

in bundles.php

Usage

To generate JsonApi documentation, use command:

this will create documentation/api.yaml file that can be used as API Documentation on external services like Swagger, or to go generate Postman requests.

You can use this command anytime, it will look for the latest changes in your API and overwrite old api.yaml file.

How it works

This command will check your Controller classes and look for methods:

• list()
• new()
• view()
• edit()
• delete()

After that, it will check for your Transformer and Hydrator classes to generate request and response schemas. It expects these methods:

These methods should return an array. The keys of array elements will be used as attributes and relationships in requests.

Customization

Using a different template

If you want, you can use a different template. Create template.yaml file in your ocumentation/ directory. Original template file:

Add custom documentation

If you want to add custom routes, you can create a class that implements CustomDocumentationInterface class. You also need to give this class a tag with:

After that, you can add any logic you want after the generation process, for example:

This code will look for you custom yaml file and insert its contents into the documentation.