terwey/slim-swagger

Slim Middleware for generating Swagger documentation on the fly with Swagger-PHP

SlimSwagger

A Slim Middleware for generating Swagger documentation on the fly with Swagger-PHP., _(*1)

Installation

Easiest is using Composer:, _(*2)

composer require terwey/slim-swagger

Adding it to Slim is easy too:, _(*3)

$app->add(new \terwey\SlimSwagger(array(), array('baseDir' => __DIR__.'/../src/')));

Where src/ is the directory you keep your API endpoint or Models., _(*4)

Resources

For now you'll have to grab a release of Swagger-UI and copy /lib and /css to your /public directory. Also copy over swagger-ui.min.js to the /public/lib directory., _(*5)

Template

I've provided a Twig template in the /templates directory. Copy this over to your Slim application. If you want to use Twig also install Slim Views., _(*6)

Docs

The SlimSwagger class takes 2 parameters. The first one is the $swaggerSettings array, please see the Swagger-PHP docs for more info., _(*7)

$swaggerSettings = array(
    'output' => 'json',
    'apiVersion' => $defaultApiVersion,
    'swaggerVersion' => $defaultSwaggerVersion,
    'defaultSwaggerVersion' => $resourceList['swaggerVersion'],
    'defaultBasePath' => $defaultBasePath
);

The second one is the $options array., _(*8)

$options = array(
    'baseDir' => __DIR__.'/../',
    'ignoreDir' => array()
);