basster/silex-simple-swagger-provider

A silex service provider that integrates swagger-php 2.0 into silex

silex-simple-swagger-provider

, _(*1)

silex-simple-swagger-provider is a silex service provider that integrates swagger-php (Version 2) into silex. This service provider adds routes for generating and exposing a swagger defintion based on swagger-php annotations. The swagger definition can then be used with swagger-ui., _(*2)

This library is strongly inspired by Jason Desrosiers silex-swagger-provider but fully rewritten to meet the needs of swagger-php (Version 2), _(*3)

:warning: For Silex2 and Pimple3 check out the silex-2 branch :warning:, _(*4)

Installation für Silex 1

Install the silex-swagger-provider using composer., _(*5)

composer require basster/silex-simple-swagger-provider:^1.0

Parameters

• swagger.servicePath: The path to the classes that contain your swagger annotations.
• swagger.excludePath: A string path or an array of paths to be excluded when generating annotations.
• swagger.apiDocPath: The URI that will be used to access the swagger definition. Defaults to /api/api-docs.
• swagger.cache: An array of caching options that will be passed to Symfony 2's Response::setCache method.

Services

• swagger: An instance of Swagger\Annotations\Swagger. It's the already parsed swagger annotation tree.

Registering

$app->register(new Basster\Silex\Provider\Swagger\SwaggerProvider(), [
    "swagger.servicePath" => __DIR__ . "/path/to/your/api",
]);

Usage

The following routes are made available by default * GET /api/api-docs: Get the list of resources, _(*6)

The results of the swagger definition file is not cached internally. Instead, the routes that are created are designed to work with an HTTP cache such as a browser cache or reverse proxy. You can configure how you want to your service cached using the swagger.cache parameter. By default, no caching will be done. Read about HTTP caching in Symfony for more information about how to customize caching behavior. The following example will allow the service definition file to be cached for 5 days., _(*7)

$app["swagger.cache"] = [
    "max_age": "432000", // 5 days in seconds
    "s_maxage": "432000", // 5 days in seconds
    "public": true,
]