delboy1978uk/bone-open-api

OpenApi package for Bone Framework

v1.3.0 2024-03-31 11:12 UTC

Requires

• php: ^8.2
• laminas/laminas-diactoros: ^3.3
• zircote/swagger-php: ^4.8.

Requires (Dev)

• roave/security-advisories: dev-master

MIT

• Derek Stephen McLean

README

OpenApi package for Bone Mvc Framework

installation

Use Composer

composer require delboy1978uk/open-api

usage

Simply add to the config/packages.php

<?php

// use statements here
use Bone\OpenApi\OpenApi\OpenApiPackage;

return [
    'packages' => [
        // packages here...,
        OpenApiPackage::class,
    ],
    // ...
];

Create a config array entry/file. You can add a client so the docs page can authorize and test your endpoints.

<?php

return [
    'docs' => 'data/docs/api.json',
    'swaggerClient' => [
        'clientId' => '',
        'clientSecret' => '',
    ],
];

Run booty to deploy the front end assets.

vendor/bin/bone assets:deploy

Scan for your API annotations.

vendor/bin/bone docs:generate

Now you can head to /api/docs to view your API documentation. 😃