Examples

Code/Annotation examples

Collection of code/annotation examples and their corresponding OpenAPI specs generated using swagger-php.

• openapi-spec

  Implementation of the OpenAPI v3 example specs using swagger-php annotations.

  • openapi-spec: source / spec
  • petstore-3.0 (includes oauth2 auth flow): source / spec

• petstore.swagger.io

  The swagger-ui petstore example using swagger-php annotations.

  • petstore.swagger.io: source / spec

• swagger-spec

  Some more examples based on the (now defunct) swagger-api specs.

  • petstore: source / spec
  • petstore-simple: source / spec
  • petstore-with-external-docs: source / spec

• Other

  • simple response object: source / spec
  • misc: source / spec
  • using interfaces: source / spec (inherit) / spec (merge)
  • using traits: source / spec (inherit) / spec (merge)
  • using refs: source / spec

Custom processors

Processors implement the various steps involved in converting annotations into an OpenAPI spec.

Writing a custom processor is the recommended way to extend swagger-php in a clean way.

Processors are expected to implement the __invoke() method expecting the current Analysis object as single parameter:

<?php
...
use OpenApi\Analysis;
...

class MyCustomProcessor
{
    public function __invoke(Analysis $analysis)
    {
        // custom processing    
    }
}

• schema-query-parameter-processor

  A processor that takes a vendor tag (expecting a schema #ref) and injects all properties of that given schema as query parameter to the request definition.

  source