Download the PHP package elenyum/open-api without Composer

Elenyum Open API

This bundle generates documentation and returns JSON formatted according to the OpenAPI specification.

Install

Configuration

For adding configuration, create a config file in the project root directory, /config/packages/elenyum_open_api.yaml. In the config file add:

To add a route to get the json specification add to project root file /config/routes/elenyum_open_api.yaml

width config example:

Cache Configuration

• cache.enable:
  Indicates whether caching is activated. Default: false.

• cache.item_id:
  Sets the cache item identifier. Default: elenyum_open_api.

Example:

yaml

Documentation Configuration

Serves as a foundation for creating API documentation using attributes as keys.

• documentation.info.title:
  The title of the application in the documentation: My App.

• documentation.info.description:
  The description of the application in the documentation: Description service.

• documentation.info.version:
  The version of the application in the documentation: 1.0.0.

Example:

yaml

Other Configuration

Filters the routes that will be documented and manages their visibility in the generated documentation.

• path_patterns:
  An array of regex patterns to match against the path for including routes.

• host_patterns:
  An array of regex patterns to match against the host for including routes.

• name_patterns:
  An array of regex patterns to match against the route name for including routes.

• with_tag:
  A boolean indicating if routes should be filtered by tag (annotations).

• disable_default_routes:
  A boolean indicating if default routes without explicit OpenAPI annotations should be excluded.

Example

yaml