kbrabrand/silex-swagger-ui

A silex service provider that integrates the Swagger UI documentation browser into silex

Silex SwaggerUI service provider

A silex service provider that integrates the Swagger UI documentation browser into silex. Does not depend on anything besides Silex., _(*1)

Installation

Add "kbrabrand/silex-swagger-ui": "dev-master" to you composer.json file and run composer install inside the root of your project., _(*2)

In addition to this you will need to register the service in your Silex app like this;, _(*3)

// Set up swagger ui service for viewing the swagger docs
$app->register(new SwaggerUI\Silex\Provider\SwaggerUIServiceProvider(), array(
    'swaggerui.path'       => '/v1/swagger',
    'swaggerui.apiDocPath' => '/v1/docs'
));

This will result in the SwaggerUI interface being available at /v1/swagger under you Silex application root. The swaggerui.apiDovPath config option specifies the URL/path to the swagger doc files., _(*4)

Known issues

The Swagger UI is pretty slow right now due to the fact that static resources are served through a Silex controller and no cache is in place (yet). I'll try to fix this soon., _(*5)

License

Copyright (c) 2014, Kristoffer Brabrand kristoffer@brabrand.no, _(*6)

Licensed under the MIT License, _(*7)