Example Reference
This page is generated automatically from the swagger-php sources.
For improvements head over to GitHub and create a PR 😉
Api
A simple API example uing enums, traits and callbacks.
Colour.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Spec;
use OpenApi\Spec as OA;
/**
* A Colour.
*/
// schema name inferred from enum name
#[OA\Schema]
enum Colour
{
case GREEN;
case BLUE;
case RED;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Attributes;
use OpenApi\Attributes as OAT;
/**
* A Colour.
*/
#[OAT\Schema]
enum Colour
{
case GREEN;
case BLUE;
case RED;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Annotations;
use OpenApi\Annotations as OA;
/**
* A Colour.
*
* @OA\Schema()
*/
enum Colour
{
case GREEN;
case BLUE;
case RED;
}NameTrait.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Spec;
use OpenApi\Spec as OA;
/**
* A Name.
*/
#[OA\Schema]
trait NameTrait
{
#[OA\Property]
#[OA\Schema(description: 'The name.')]
public $name;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Attributes;
use OpenApi\Attributes as OAT;
/**
* A Name.
*/
#[OAT\Schema]
trait NameTrait
{
#[OAT\Property(description: 'The name.')]
public $name;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Annotations;
use OpenApi\Annotations as OA;
/**
* A Name.
*
* @OA\Schema
*/
trait NameTrait
{
/**
* The name.
*
* @OA\Property
*/
public $name;
}OpenApiSpec.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Spec;
use OpenApi\Spec as OA;
/**
* The Spec.
*/
#[OA\OpenApi(version: '3.1.0')]
#[OA\Security\Requirement(scheme: 'bearerAuth')]
#[OA\Info(
title: 'Basic single file API',
version: '1.0.0',
license: new OA\License(name: 'MIT', identifier: 'MIT'),
)]
#[OA\Server(url: 'https://localhost/api', description: 'API server')]
#[OA\Security\Scheme\Http(description: 'Basic Auth', scheme: 'bearer', component: 'bearerAuth')]
#[OA\Tag(name: 'products', description: 'All about products')]
#[OA\Tag(name: 'catalog', description: 'Catalog API')]
class OpenApiSpec
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Attributes;
use OpenApi\Attributes as OAT;
/**
* The Spec.
*/
#[OAT\OpenApi(openapi: OAT\OpenApi::VERSION_3_1_0, security: [['bearerAuth' => []]])]
#[OAT\Info(
version: '1.0.0',
title: 'Basic single file API',
attachables: [new OAT\Attachable()]
)]
#[OAT\License(name: 'MIT', identifier: 'MIT')]
#[OAT\Server(url: 'https://localhost/api', description: 'API server')]
#[OAT\SecurityScheme(securityScheme: 'bearerAuth', type: 'http', description: 'Basic Auth', scheme: 'bearer')]
#[OAT\Tag(name: 'products', description: 'All about products')]
#[OAT\Tag(name: 'catalog', description: 'Catalog API')]
class OpenApiSpec
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Annotations;
use OpenApi\Annotations as OA;
/**
* The Spec.
*
* @OA\OpenApi(
* openapi="3.1.0",
* security={{"bearerAuth": {}}}
* )
* @OA\Info(
* version="1.0.0",
* title="Basic single file API",
* @OA\License(name="MIT", identifier="MIT", @OA\Attachable)
* )
* @OA\Server(
* url="https://localhost/api",
* description="API server"
* )
* @OA\SecurityScheme(
* securityScheme="bearerAuth",
* type="http",
* scheme="bearer",
* description="Basic Auth"
* )
* @OA\Tag(
* name="products",
* description="All about products"
* )
* @OA\Tag(
* name="catalog",
* description="Catalog API"
* )
*/
class OpenApiSpec
{
}Product.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Spec;
use OpenApi\Spec as OA;
/**
* A Product description ignored.
*/
#[OA\Schema(title: 'Product', description: 'A Product.')]
class Product
{
use NameTrait;
/**
* The kind.
*/
#[OA\Property(property: 'kind')]
public const KIND = 'Virtual';
#[OA\Schema(format: 'int64')]
/**
* The id.
*
* @example 1
*/
public int $id;
public function __construct(
#[OA\Property]
#[OA\Schema]
public int $quantity,
#[OA\Property]
#[OA\Schema(example: null, default: null)]
public ?string $brand,
#[OA\Schema(description: 'The colour')]
public Colour $colour,
#[OA\Property]
#[OA\Schema(type: 'string')]
public \DateTimeInterface $releasedAt,
) {
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Attributes;
use OpenApi\Attributes as OAT;
use OpenApi\Examples\Specs\Api\ProductInterface;
/**
* A Product description ignored.
*/
#[OAT\Schema(title: 'Product', description: 'A Product.')]
class Product implements ProductInterface
{
use NameTrait;
/**
* The kind.
*/
#[OAT\Property(property: 'kind')]
public const KIND = 'Virtual';
#[OAT\Property(description: 'The id.', format: 'int64')]
/**
* The id.
*
* @example 1
*/
public int $id;
public function __construct(
#[OAT\Property]
public int $quantity,
#[OAT\Property(example: null, default: null)]
public ?string $brand,
#[OAT\Property(description: 'The colour')]
public Colour $colour,
#[OAT\Property(type: 'string')]
public \DateTimeInterface $releasedAt,
) {
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Annotations;
use OpenApi\Annotations as OA;
use OpenApi\Examples\Specs\Api\ProductInterface;
/**
* A Product.
*
* @OA\Schema(
* title="Product"
* )
*/
class Product implements ProductInterface
{
use NameTrait;
/**
* The kind.
*
* @OA\Property(property="kind")
*/
public const KIND = 'Virtual';
/** @OA\Property */
public int $quantity;
/** @OA\Property(nullable=true, default=null, example=null) */
public string $brand;
/** @OA\Property(description="The colour") */
public Colour $colour;
/**
* The id.
*
* @OA\Property(format="int64", example=1)
*/
public int $id;
public function __construct(
/**
* @OA\Property(type="string")
*/
public \DateTimeInterface $releasedAt,
) {
}
}ProductController.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Spec;
use OpenApi\Spec as OA;
/**
* The Controller.
*/
class ProductController
{
/**
* Get a product.
*
* @param ?int $product_id the product id
*/
#[OA\Operation\Get(path: '/products/{product_id}', operationId: 'getProducts', tags: ['products'])]
#[OA\Response(
response: 200,
description: 'successful operation',
headers: [new OA\Header(header: 'X-Rate-Limit', description: 'calls per hour allowed by the user', schema: new OA\Schema(type: OA\Type::Integer, format: OA\Format::Int32))],
content: [new OA\MediaType\Json(ref: Product::class)],
)]
#[OA\Response(response: 401, description: 'oops')]
public function getProduct(
#[OA\Parameter\Path(name: 'product_id')]
?int $product_id
) {
}
/**
* Add a product.
*/
#[OA\Operation(path: '/products', method: 'post', operationId: 'addProducts', summary: 'Add products', tags: ['products'])]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [new OA\MediaType\Json(ref: Product::class)],
)]
#[OA\RequestBody(
description: 'New product',
required: true,
content: [new OA\MediaType\Json(items: new OA\Schema(ref: Product::class))],
)]
public function addProduct()
{
}
/**
* Get all.
*/
#[OA\Operation(path: '/products', method: OA\HttpMethod::Get, operationId: 'getAll', tags: ['products'])]
#[OA\Tag(name: 'catalog')]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [new OA\MediaType(
mediaType: 'application/json',
schema: new OA\Schema(
type: 'object',
properties: [
new OA\Property(
property: 'data',
schema: new OA\Schema(type: 'array', items: new OA\Schema(ref: Product::class)),
),
],
required: ['data'],
),
)],
)]
#[OA\Response(response: 401, description: 'oops')]
#[OA\Header(header: 'X-Rate-Limit', description: 'calls per hour allowed by the user', schema: new OA\Schema(type: OA\Type::Integer, format: OA\Format::Int32), fan: OA\Fan::All)]
public function getAll()
{
}
#[OA\Operation(
path: '/subscribe',
method: 'post',
operationId: 'subscribe',
summary: 'Subscribe to product webhook',
tags: ['products'],
callbacks: [
'onChange' => [
'{$request.query.callbackUrl}' => [
'post' => [
'requestBody' => new OA\RequestBody(
description: 'subscription payload',
content: [
new OA\MediaType(
mediaType: 'application/json',
schema: new OA\Schema(
properties: [
new OA\Property(
property: 'timestamp',
schema: new OA\Schema(description: 'time of change', type: 'string', format: OA\Format::DateTime),
),
],
),
),
],
),
],
'responses' => [
'200' => [
'description' => 'Your server implementation should return this HTTP status code if the data was received successfully',
],
],
],
],
],
)]
#[OA\Parameter(name: 'callbackUrl', in: OA\ParameterIn::Query)]
#[OA\Response(response: 200, description: 'callbackUrl registered')]
public function subscribe()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Attributes;
use OpenApi\Attributes as OAT;
use OpenApi\Tests\Fixtures\Attributes as OAF;
/**
* The Controller.
*/
class ProductController
{
/**
* Get a product.
*
* @param ?int $product_id the product id
*/
#[OAT\Get(path: '/products/{product_id}', operationId: 'getProducts', tags: ['products'])]
#[OAT\Response(response: 200, description: 'successful operation', headers: [
new OAT\Header(header: 'X-Rate-Limit', description: 'calls per hour allowed by the user', schema: new OAT\Schema(type: 'integer', format: 'int32')),
], content: [new OAT\MediaType(mediaType: 'application/json', schema: new OAT\Schema(ref: Product::class))])]
#[OAT\Response(response: 401, description: 'oops')]
#[OAF\CustomAttachable(value: 'operation')]
public function getProduct(
#[OAT\PathParameter]
?int $product_id
) {
}
#[OAT\Post(path: '/products', operationId: 'addProducts', summary: 'Add products', tags: ['products'])]
#[OAT\Response(
response: 200,
description: 'successful operation',
content: new OAT\JsonContent(ref: Product::class)
)]
#[OAT\RequestBody(description: 'New product', required: true, content: [new OAT\MediaType(
mediaType: 'application/json',
schema: new OAT\Schema(
items: new OAT\Items(type: Product::class)
)
)])]
/**
* Add a product.
*/
public function addProduct()
{
}
#[OAT\Get(path: '/products', operationId: 'getAll', tags: ['products', 'catalog'])]
#[OAT\Response(
response: 200,
description: 'successful operation',
headers: [
new OAT\Header(header: 'X-Rate-Limit', description: 'calls per hour allowed by the user', schema: new OAT\Schema(type: 'integer', format: 'int32')),
],
content: new OAT\JsonContent(
required: ['data'],
properties: [
new OAT\Property(
property: 'data',
type: 'array',
items: new OAT\Items(ref: Product::class)
),
],
type: 'object'
)
)]
/**
* Get all.
*/
#[OAT\Response(response: 401, description: 'oops', headers: [
new OAT\Header(header: 'X-Rate-Limit', description: 'calls per hour allowed by the user', schema: new OAT\Schema(type: 'integer', format: 'int32')),
])]
public function getAll()
{
}
#[OAT\Post(
path: '/subscribe',
operationId: 'subscribe',
summary: 'Subscribe to product webhook',
tags: ['products'],
callbacks: [
'onChange' => [
'{$request.query.callbackUrl}' => [
'post' => [
'requestBody' => new OAT\RequestBody(
description: 'subscription payload',
content: [
new OAT\MediaType(
mediaType: 'application/json',
schema: new OAT\Schema(
properties: [
new OAT\Property(
property: 'timestamp',
description: 'time of change',
type: 'string',
format: 'date-time'
),
]
)
),
]
),
],
'responses' => [
'200' => [
'description' => 'Your server implementation should return this HTTP status code if the data was received successfully',
],
],
],
],
]
)]
#[OAT\Parameter(
name: 'callbackUrl',
in: 'query'
)]
#[OAT\Response(
response: 200,
description: 'callbackUrl registered'
)]
public function subscribe()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Annotations;
use OpenApi\Annotations as OA;
/**
* The Controller.
*/
class ProductController
{
/**
* Get a product.
*
* @OA\Get(
* tags={"products"},
* path="/products/{product_id}",
* operationId="getProducts",
* @OA\PathParameter(
* name="product_id",
* @OA\Schema(type="integer")
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\Header(
* header="X-Rate-Limit",
* description="calls per hour allowed by the user",
* @OA\Schema(
* type="integer",
* format="int32"
* )
* ),
* @OA\MediaType(mediaType="application/json", @OA\Schema(ref="#/components/schemas/Product"))
* ),
* @OA\Response(
* response=401,
* description="oops"
* )
* )
*
* @param ?int $product_id the product id
*/
public function getProduct(?int $product_id)
{
}
/**
* Add a product.
*
* @OA\Post(
* path="/products",
* tags={"products"},
* summary="Add products",
* operationId="addProducts",
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(ref="#/components/schemas/Product")
* ),
* @OA\RequestBody(
* description="New product",
* required=true,
* @OA\MediaType(
* mediaType="application/json",
* @OA\Schema(
* @OA\Items(ref="#/components/schemas/Product")
* )
* )
* )
* )
*/
public function addProduct()
{
}
/**
* Get all.
*
* @OA\Get(
* tags={"products", "catalog"},
* path="/products",
* operationId="getAll",
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\Header(
* header="X-Rate-Limit",
* description="calls per hour allowed by the user",
* @OA\Schema(
* type="integer",
* format="int32"
* )
* ),
* @OA\JsonContent(
* type="object",
* required={"data"},
* @OA\Property(
* property="data",
* type="array",
* @OA\Items(ref="#/components/schemas/Product")
* )
* )
* ),
* @OA\Response(
* response=401,
* description="oops",
* @OA\Header(
* header="X-Rate-Limit",
* description="calls per hour allowed by the user",
* @OA\Schema(
* type="integer",
* format="int32"
* )
* )
* )
* )
*/
public function getAll()
{
}
/**
* @OA\Post(
* path="/subscribe",
* tags={"products"},
* operationId="subscribe",
* summary="Subscribe to product webhook",
* @OA\Parameter(
* name="callbackUrl",
* in="query"
* ),
* @OA\Response(
* response=200,
* description="callbackUrl registered"
* ),
* callbacks={
* "onChange": {
* "{$request.query.callbackUrl}": {
* "post": {
* "requestBody": @OA\RequestBody(
* description="subscription payload",
* @OA\MediaType(
* mediaType="application/json",
* @OA\Schema(
* @OA\Property(
* property="timestamp",
* description="time of change",
* type="string",
* format="date-time"
* )
* )
* )
* )
* },
* "responses": {
* "200": {
* "description": "Your server implementation should return this HTTP status code if the data was received successfully"
* }
* }
* }
* }
* }
* )
*/
public function subscribe()
{
}
}Server.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Spec;
use OpenApi\Spec as OA;
/**
* A Server.
*/
#[OA\Server(url: 'https://example.localhost', description: 'The local environment.')]
#[OA\Server(url: 'https://example.com', description: 'The production server.')]
class Server
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\Server(
url: 'https://example.localhost',
description: 'The local environment.'
)]
#[OAT\Server(
url: 'https://example.com',
description: 'The production server.'
)]
/**
* A Server.
*/
class Server
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Api\Annotations;
use OpenApi\Annotations as OA;
/**
* A Server.
*
* @OA\Server(
* url="https://example.localhost",
* description="The local environment."
* )
* @OA\Server(
* url="https://example.com",
* description="The production server."
* )
*/
class Server
{
}Petstore
Classic petstore sample app. Uses OAuth
Controllers/PetController.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Controllers;
use OpenApi\Examples\Specs\Petstore\Spec\Models\ApiResponse;
use OpenApi\Examples\Specs\Petstore\Spec\Models\Pet;
use OpenApi\Examples\Specs\Petstore\Spec\Models\PetRequestBody;
use OpenApi\Spec as OA;
/**
* Class Pet.
*/
class PetController
{
/**
* Add a new pet to the store.
*/
#[OA\Operation\Post(path: '/pet', operationId: 'addPet', tags: ['pet'], requestBody: new OA\RequestBody(ref: PetRequestBody::class), security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(response: 405, description: 'Invalid input')]
public function addPet()
{
}
/**
* Update an existing pet.
*/
#[OA\Operation(path: '/pet', method: 'put', operationId: 'updatePet', tags: ['pet'], requestBody: new OA\RequestBody(ref: PetRequestBody::class), security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(response: 400, description: 'Invalid ID supplied')]
#[OA\Response(response: 404, description: 'Pet not found')]
#[OA\Response(response: 405, description: 'Validation exception')]
public function updatePet()
{
}
#[OA\Operation\Get(path: '/pet/findByStatus', operationId: 'findPetsByStatus', summary: 'Finds Pets by status', description: 'Multiple status values can be provided with comma separated string', tags: ['pet'], parameters: [
new OA\Parameter(
name: 'status',
in: OA\ParameterIn::Query,
description: 'Status values that needed to be considered for filter',
required: true,
explode: true,
schema: new OA\Schema(type: OA\Type::String, enum: ['available', 'pending', 'sold'], default: 'available'),
),
], deprecated: true, security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema\Items(ref: Pet::class)),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(type: 'array', items: new OA\Schema(ref: Pet::class))),
],
)]
#[OA\Response(response: 400, description: 'Invalid status value')]
public function findPetsByStatus()
{
}
#[OA\Operation\Get(path: '/pet/findByTags', operationId: 'findByTags', summary: 'Finds Pets by tags', description: 'Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.', tags: ['pet'], parameters: [
new OA\Parameter\Query(
name: 'tags',
description: 'Tags to filter by',
required: true,
explode: true,
schema: new OA\Schema(type: 'array', items: new OA\Schema(type: 'string')),
),
], security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType\Json(type: OA\Type::Array, items: new OA\Schema(ref: Pet::class)),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(type: 'array', items: new OA\Schema(ref: Pet::class))),
],
)]
#[OA\Response(response: 400, description: 'Invalid tag value')]
public function findByTags()
{
}
#[OA\Operation\Get(path: '/pet/{petId}', operationId: 'getPetById', summary: 'Find pet by ID', description: 'Returns a single pet', tags: ['pet'], parameters: [
new OA\Parameter(
name: 'petId',
in: OA\ParameterIn::Path,
description: 'ID of pet to return',
required: true,
schema: new OA\Schema(type: OA\Type::Integer, format: OA\Format::Int64),
),
], security: [
new OA\Security\Requirement(scheme: 'api_key', scopes: []),
])]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType\Json(ref: Pet::class),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(ref: Pet::class)),
],
)]
#[OA\Response(response: 400, description: 'Invalid ID supplier')]
#[OA\Response(response: 404, description: 'Pet not found')]
public function getPetById(int $id)
{
}
#[OA\Operation\Post(path: '/pet/{petId}', operationId: 'updatePetWithForm', summary: 'Updates a pet in the store with form data', tags: ['pet'], parameters: [
new OA\Parameter\Path(
name: 'petId',
description: 'ID of pet that needs to be updated',
schema: new OA\Schema(type: 'integer', format: 'int64'),
),
], requestBody: new OA\RequestBody(
description: 'Input data format',
content: [
new OA\MediaType(
mediaType: 'application/x-www-form-urlencoded',
schema: new OA\Schema(
type: 'object',
properties: [
new OA\Property(property: 'name', schema: new OA\Schema(description: 'Updated name of the pet', type: 'string')),
new OA\Property(property: 'status', schema: new OA\Schema(description: 'Updated status of the pet', type: 'string')),
],
),
),
],
), security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(response: 405, description: 'Invalid input')]
public function updatePetWithForm()
{
}
#[OA\Operation\Delete(path: '/pet/{petId}', operationId: 'deletePet', summary: 'Deletes a pet', tags: ['pet'], parameters: [
new OA\Parameter\Header(name: 'api_key', required: false, schema: new OA\Schema(type: OA\Type::String)),
new OA\Parameter(name: 'petId', in: 'path', description: 'Pet id to delete', required: true, schema: new OA\Schema(type: 'integer', format: 'int64')),
], security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(response: 400, description: 'Invalid ID supplied')]
#[OA\Response(response: 404, description: 'Pet not found')]
public function deletePet()
{
}
#[OA\Operation(path: '/pet/{petId}/uploadImage', method: OA\HttpMethod::Post, operationId: 'uploadFile', summary: 'uploads an image', tags: ['pet'], parameters: [
new OA\Parameter(
name: 'petId',
in: 'path',
description: 'ID of pet to update',
required: true,
schema: new OA\Schema(type: 'integer', format: 'int64', example: 1),
),
], requestBody: new OA\RequestBody(
description: 'Upload images request body',
content: [
new OA\MediaType(
mediaType: 'application/octet-stream',
schema: new OA\Schema(type: 'string', format: 'binary'),
),
],
), security: [
new OA\Security\Requirement(scheme: 'petstore_auth', scopes: ['write:pets', 'read:pets']),
])]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [new OA\MediaType\Json(ref: ApiResponse::class)],
)]
public function uploadFile()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Controllers;
use OpenApi\Attributes as OAT;
use OpenApi\Examples\Specs\Petstore\Attributes\Models\ApiResponse;
use OpenApi\Examples\Specs\Petstore\Attributes\Models\Pet;
use OpenApi\Examples\Specs\Petstore\Attributes\Models\PetRequestBody;
/**
* Class Pet.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
class PetController
{
/**
* Add a new pet to the store.
*/
#[OAT\Post(path: '/pet', operationId: 'addPet', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], requestBody: new OAT\RequestBody(
ref: PetRequestBody::class
), tags: ['pet'], responses: [
new OAT\Response(
response: 405,
description: 'Invalid input'
),
])]
public function addPet()
{
}
/**
* Update an existing pet.
*/
#[OAT\Put(path: '/pet', operationId: 'updatePet', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], requestBody: new OAT\RequestBody(
ref: PetRequestBody::class
), tags: ['pet'], responses: [
new OAT\Response(
response: 400,
description: 'Invalid ID supplied'
),
new OAT\Response(
response: 404,
description: 'Pet not found'
),
new OAT\Response(
response: 405,
description: 'Validation exception'
),
])]
public function updatePet()
{
}
#[OAT\Get(path: '/pet/findByStatus', operationId: 'findPetsByStatus', description: 'Multiple status values can be provided with comma separated string', summary: 'Finds Pets by status', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], tags: ['pet'], parameters: [
new OAT\Parameter(
name: 'status',
description: 'Status values that needed to be considered for filter',
in: 'query',
required: true,
schema: new OAT\Schema(
type: 'string',
default: 'available',
enum: ['available', 'pending', 'sold']
),
explode: true
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: [
new OAT\JsonContent(
type: 'array',
items: new OAT\Items(
ref: Pet::class
)
),
new OAT\XmlContent(
type: 'array',
items: new OAT\Items(
ref: Pet::class
)
),
]
),
new OAT\Response(
response: 400,
description: 'Invalid status value'
),
], deprecated: true)]
public function findPetsByStatus()
{
}
#[OAT\Get(path: '/pet/findByTags', operationId: 'findByTags', description: 'Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.', summary: 'Finds Pets by tags', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], tags: ['pet'], parameters: [
new OAT\Parameter(
name: 'tags',
description: 'Tags to filter by',
in: 'query',
required: true,
schema: new OAT\Schema(
type: 'array',
items: new OAT\Items(
type: 'string'
)
),
explode: true
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: [
new OAT\JsonContent(
type: 'array',
items: new OAT\Items(
ref: Pet::class
)
),
new OAT\XmlContent(
type: 'array',
items: new OAT\Items(
ref: Pet::class
)
),
]
),
new OAT\Response(
response: 400,
description: 'Invalid tag value'
),
])]
public function findByTags()
{
}
#[OAT\Get(path: '/pet/{petId}', operationId: 'getPetById', description: 'Returns a single pet', summary: 'Find pet by ID', security: [
[
'api_key' => [
],
],
], tags: ['pet'], parameters: [
new OAT\Parameter(
name: 'petId',
description: 'ID of pet to return',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'integer',
format: 'int64'
)
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: [
new OAT\JsonContent(
ref: Pet::class
),
new OAT\XmlContent(
ref: Pet::class
),
]
),
new OAT\Response(
response: 400,
description: 'Invalid ID supplier'
),
new OAT\Response(
response: 404,
description: 'Pet not found'
),
])]
public function getPetById(int $id)
{
}
#[OAT\Post(path: '/pet/{petId}', operationId: 'updatePetWithForm', summary: 'Updates a pet in the store with form data', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], requestBody: new OAT\RequestBody(
description: 'Input data format',
content: new OAT\MediaType(
mediaType: 'application/x-www-form-urlencoded',
schema: new OAT\Schema(
properties: [
new OAT\Property(
property: 'name',
description: 'Updated name of the pet',
type: 'string'
),
new OAT\Property(
property: 'status',
description: 'Updated status of the pet',
type: 'string'
),
],
type: 'object'
)
)
), tags: ['pet'], parameters: [
new OAT\Parameter(
name: 'petId',
description: 'ID of pet that needs to be updated',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'integer',
format: 'int64'
)
),
], responses: [
new OAT\Response(
response: 405,
description: 'Invalid input'
),
])]
public function updatePetWithForm()
{
}
#[OAT\Delete(path: '/pet/{petId}', operationId: 'deletePet', summary: 'Deletes a pet', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], tags: ['pet'], parameters: [
new OAT\Parameter(
name: 'api_key',
in: 'header',
required: false,
schema: new OAT\Schema(
type: 'string'
)
),
new OAT\Parameter(
name: 'petId',
description: 'Pet id to delete',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'integer',
format: 'int64'
)
),
], responses: [
new OAT\Response(
response: 400,
description: 'Invalid ID supplied'
),
new OAT\Response(
response: 404,
description: 'Pet not found'
),
])]
public function deletePet()
{
}
#[OAT\Post(path: '/pet/{petId}/uploadImage', operationId: 'uploadFile', summary: 'uploads an image', security: [
[
'petstore_auth' => [
'write:pets',
'read:pets',
],
],
], requestBody: new OAT\RequestBody(
description: 'Upload images request body',
content: new OAT\MediaType(
mediaType: 'application/octet-stream',
schema: new OAT\Schema(
type: 'string',
format: 'binary'
)
)
), tags: ['pet'], parameters: [
new OAT\Parameter(
name: 'petId',
description: 'ID of pet to update',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'integer',
format: 'int64',
example: 1
)
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: new OAT\JsonContent(
ref: ApiResponse::class
)
),
])]
public function uploadFile()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Controllers;
use OpenApi\Annotations as OA;
/**
* Class Pet.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
class PetController
{
/**
* Add a new pet to the store.
*
* @OA\Post(
* path="/pet",
* tags={"pet"},
* operationId="addPet",
* @OA\Response(
* response=405,
* description="Invalid input"
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* },
* @OA\RequestBody(ref="#/components/requestBodies/Pet")
* )
*/
public function addPet()
{
}
/**
* Update an existing pet.
*
* @OA\Put(
* path="/pet",
* tags={"pet"},
* operationId="updatePet",
* @OA\Response(
* response=400,
* description="Invalid ID supplied"
* ),
* @OA\Response(
* response=404,
* description="Pet not found"
* ),
* @OA\Response(
* response=405,
* description="Validation exception"
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* },
* @OA\RequestBody(ref="#/components/requestBodies/Pet")
* )
*/
public function updatePet()
{
}
/**
* @OA\Get(
* path="/pet/findByStatus",
* tags={"pet"},
* summary="Finds Pets by status",
* description="Multiple status values can be provided with comma separated string",
* operationId="findPetsByStatus",
* deprecated=true,
* @OA\Parameter(
* name="status",
* in="query",
* description="Status values that needed to be considered for filter",
* required=true,
* explode=true,
* @OA\Schema(
* default="available",
* type="string",
* enum={"available", "pending", "sold"},
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(
* type="array",
* @OA\Items(ref="#/components/schemas/Pet")
* ),
* @OA\XmlContent(
* type="array",
* @OA\Items(ref="#/components/schemas/Pet")
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid status value"
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* }
* )
*/
public function findPetsByStatus()
{
}
/**
* @OA\Get(
* path="/pet/findByTags",
* tags={"pet"},
* summary="Finds Pets by tags",
* description="Muliple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.",
* operationId="findByTags",
* @OA\Parameter(
* name="tags",
* in="query",
* description="Tags to filter by",
* required=true,
* explode=true,
* @OA\Schema(
* type="array",
* @OA\Items(
* type="string",
* )
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(
* type="array",
* @OA\Items(ref="#/components/schemas/Pet")
* ),
* @OA\XmlContent(
* type="array",
* @OA\Items(ref="#/components/schemas/Pet")
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid tag value"
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* }
* )
*/
public function findByTags()
{
}
/**
* @OA\Get(
* path="/pet/{petId}",
* tags={"pet"},
* summary="Find pet by ID",
* description="Returns a single pet",
* operationId="getPetById",
* @OA\Parameter(
* name="petId",
* in="path",
* description="ID of pet to return",
* required=true,
* @OA\Schema(
* type="integer",
* format="int64"
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(ref="#/components/schemas/Pet"),
* @OA\XmlContent(ref="#/components/schemas/Pet"),
* ),
* @OA\Response(
* response=400,
* description="Invalid ID supplier"
* ),
* @OA\Response(
* response=404,
* description="Pet not found"
* ),
* security={
* {"api_key": {}}
* }
* )
*
* @param int $id
*/
public function getPetById($id)
{
}
/**
* @OA\Post(
* path="/pet/{petId}",
* tags={"pet"},
* summary="Updates a pet in the store with form data",
* operationId="updatePetWithForm",
* @OA\Parameter(
* name="petId",
* in="path",
* description="ID of pet that needs to be updated",
* required=true,
* @OA\Schema(
* type="integer",
* format="int64"
* )
* ),
* @OA\Response(
* response=405,
* description="Invalid input"
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* },
* @OA\RequestBody(
* description="Input data format",
* @OA\MediaType(
* mediaType="application/x-www-form-urlencoded",
* @OA\Schema(
* type="object",
* @OA\Property(
* property="name",
* description="Updated name of the pet",
* type="string",
* ),
* @OA\Property(
* property="status",
* description="Updated status of the pet",
* type="string"
* )
* )
* )
* )
* )
*/
public function updatePetWithForm()
{
}
/**
* @OA\Delete(
* path="/pet/{petId}",
* tags={"pet"},
* summary="Deletes a pet",
* operationId="deletePet",
* @OA\Parameter(
* name="api_key",
* in="header",
* required=false,
* @OA\Schema(
* type="string"
* )
* ),
* @OA\Parameter(
* name="petId",
* in="path",
* description="Pet id to delete",
* required=true,
* @OA\Schema(
* type="integer",
* format="int64"
* ),
* ),
* @OA\Response(
* response=400,
* description="Invalid ID supplied",
* ),
* @OA\Response(
* response=404,
* description="Pet not found",
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* },
* )
*/
public function deletePet()
{
}
/**
* @OA\Post(
* path="/pet/{petId}/uploadImage",
* tags={"pet"},
* summary="uploads an image",
* operationId="uploadFile",
* @OA\Parameter(
* name="petId",
* in="path",
* description="ID of pet to update",
* required=true,
* @OA\Schema(
* type="integer",
* format="int64",
* example=1
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(ref="#/components/schemas/ApiResponse")
* ),
* security={
* {"petstore_auth": {"write:pets", "read:pets"}}
* },
* @OA\RequestBody(
* description="Upload images request body",
* @OA\MediaType(
* mediaType="application/octet-stream",
* @OA\Schema(
* type="string",
* format="binary"
* )
* )
* )
* )
*/
public function uploadFile()
{
}
}Controllers/StoreController.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Controllers;
use OpenApi\Examples\Specs\Petstore\Spec\Models\Order;
use OpenApi\Spec as OA;
/**
* Class Store.
*/
class StoreController
{
#[OA\Operation\Get(path: '/store', operationId: 'getInventory', summary: 'Returns pet inventories by status', description: 'Returns a map of status codes to quantities', tags: ['store'], security: [
new OA\Security\Requirement(scheme: 'api_key', scopes: []),
])]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType(
mediaType: 'application/json',
schema: new OA\Schema(additionalProperties: new OA\Schema(type: 'integer', format: 'int32')),
),
],
)]
public function getInventory()
{
}
#[OA\Operation\Post(
path: '/store/order',
operationId: 'placeOrder',
summary: 'Place an order for a pet',
tags: ['store'],
requestBody: new OA\RequestBody(
description: 'order placed for purchasing the pet',
required: true,
content: [new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(ref: Order::class))],
),
)]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(ref: Order::class)),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(ref: Order::class)),
],
)]
public function placeOrder()
{
}
#[OA\Operation\Get(
path: '/store/order/{orderId}',
operationId: 'getOrderById',
description: 'For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions',
tags: ['store'],
parameters: [
new OA\Parameter(
name: 'orderId',
in: 'path',
description: 'ID of pet that needs to be fetched',
required: true,
schema: new OA\Schema(type: 'integer', format: 'int64', minimum: 1, maximum: 10),
),
],
)]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(ref: Order::class)),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(ref: Order::class)),
],
)]
#[OA\Response(response: 400, description: 'Invalid ID supplied')]
#[OA\Response(response: 404, description: 'Order not found')]
public function getOrderById()
{
}
#[OA\Operation\Delete(
path: '/store/order/{orderId}',
operationId: 'deleteOrder',
summary: 'Delete purchase order by ID',
description: 'For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors',
tags: ['store'],
parameters: [
new OA\Parameter(
name: 'orderId',
in: 'path',
description: 'ID of the order that needs to be deleted',
required: true,
schema: new OA\Schema(type: 'integer', format: 'int64', minimum: 1),
),
],
)]
#[OA\Response(response: 400, description: 'Invalid ID supplied')]
#[OA\Response(response: 404, description: 'Order not found')]
public function deleteOrder()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Controllers;
use OpenApi\Attributes as OAT;
use OpenApi\Examples\Specs\Petstore\Attributes\Models\Order;
/**
* Class Store.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
class StoreController
{
#[OAT\Get(path: '/store', operationId: 'getInventory', description: 'Returns a map of status codes to quantities', summary: 'Returns pet inventories by status', security: [
[
'api_key' => [
],
],
], tags: ['store'], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: new OAT\JsonContent(
additionalProperties: new OAT\AdditionalProperties(
type: 'integer',
format: 'int32'
)
)
),
])]
public function getInventory()
{
}
#[OAT\Post(path: '/store/order', operationId: 'placeOrder', summary: 'Place an order for a pet', requestBody: new OAT\RequestBody(
description: 'order placed for purchasing the pet',
required: true,
content: new OAT\JsonContent(
ref: Order::class
)
), tags: ['store'], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: [
new OAT\JsonContent(
ref: Order::class
),
new OAT\XmlContent(
ref: Order::class
),
],
),
])]
public function placeOrder()
{
}
#[OAT\Get(path: '/store/order/{orderId}', operationId: 'getOrderById', description: 'For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions', tags: ['store'], parameters: [
new OAT\Parameter(
name: 'orderId',
description: 'ID of pet that needs to be fetched',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'integer',
format: 'int64',
maximum: 10,
minimum: 1
)
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: [
new OAT\JsonContent(
ref: Order::class
),
new OAT\XmlContent(
ref: Order::class
),
],
),
new OAT\Response(
response: 400,
description: 'Invalid ID supplied'
),
new OAT\Response(
response: 404,
description: 'Order not found'
),
])]
public function getOrderById()
{
}
#[OAT\Delete(path: '/store/order/{orderId}', operationId: 'deleteOrder', description: 'For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors', summary: 'Delete purchase order by ID', tags: ['store'], parameters: [
new OAT\Parameter(
name: 'orderId',
description: 'ID of the order that needs to be deleted',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'integer',
format: 'int64',
minimum: 1
)
),
], responses: [
new OAT\Response(
response: 400,
description: 'Invalid ID supplied'
),
new OAT\Response(
response: 404,
description: 'Order not found'
),
])]
public function deleteOrder()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Controllers;
use OpenApi\Annotations as OA;
/**
* Class Store.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
class StoreController
{
/**
* @OA\Get(
* path="/store",
* tags={"store"},
* summary="Returns pet inventories by status",
* description="Returns a map of status codes to quantities",
* operationId="getInventory",
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(
* @OA\AdditionalProperties(
* type="integer",
* format="int32"
* )
* )
* ),
* security={
* {"api_key": {}}
* }
* )
*/
public function getInventory()
{
}
/**
* @OA\Post(
* path="/store/order",
* tags={"store"},
* summary="Place an order for a pet",
* operationId="placeOrder",
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(ref="#/components/schemas/Order"),
* @OA\XmlContent(ref="#/components/schemas/Order")
* ),
* @OA\RequestBody(
* description="order placed for purchasing the pet",
* required=true,
* @OA\JsonContent(ref="#/components/schemas/Order")
* )
* )
*/
public function placeOrder()
{
}
/**
* @OA\Get(
* path="/store/order/{orderId}",
* tags={"store"},
* description="For valid response try integer IDs with value >= 1 and <= 10. Other values will generated exceptions",
* operationId="getOrderById",
* @OA\Parameter(
* name="orderId",
* in="path",
* description="ID of pet that needs to be fetched",
* required=true,
* @OA\Schema(
* type="integer",
* format="int64",
* maximum=10,
* minimum=1
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(ref="#/components/schemas/Order"),
* @OA\MediaType(
* mediaType="application/xml",
* @OA\Schema(ref="#/components/schemas/Order")
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid ID supplied"
* ),
* @OA\Response(
* response=404,
* description="Order not found"
* )
* )
*/
public function getOrderById()
{
}
/**
* @OA\Delete(
* path="/store/order/{orderId}",
* tags={"store"},
* summary="Delete purchase order by ID",
* description="For valid response try integer IDs with positive integer value. Negative or non-integer values will generate API errors",
* operationId="deleteOrder",
* @OA\Parameter(
* name="orderId",
* in="path",
* required=true,
* description="ID of the order that needs to be deleted",
* @OA\Schema(
* type="integer",
* format="int64",
* minimum=1
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid ID supplied"
* ),
* @OA\Response(
* response=404,
* description="Order not found"
* )
* ),
*/
public function deleteOrder()
{
}
}Controllers/UserController.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Controllers;
use OpenApi\Examples\Specs\Petstore\Spec\Models\User;
use OpenApi\Examples\Specs\Petstore\Spec\Models\UserArrayRequestBody;
use OpenApi\Spec as OA;
/**
* Class User.
*/
class UserController
{
#[OA\Operation\Post(
path: '/user',
operationId: 'createUser',
summary: 'Create user',
description: 'This can only be done by the logged in user.',
tags: ['user'],
requestBody: new OA\RequestBody(
description: 'Create user object',
required: true,
content: [new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(ref: User::class))],
),
)]
#[OA\Response(response: 'default', description: 'successful operation')]
public function createUser()
{
}
#[OA\Operation\Post(
path: '/user/createWithArray',
operationId: 'createUsersWithListInput',
summary: 'Create list of users with given input array',
tags: ['user'],
requestBody: new OA\RequestBody(ref: UserArrayRequestBody::class),
)]
#[OA\Response(response: 'default', description: 'successful operation')]
public function createUsersWithListInput()
{
}
#[OA\Operation\Get(
path: '/user/login',
operationId: 'loginUser',
summary: 'Logs user into system',
tags: ['user'],
parameters: [
new OA\Parameter(name: 'username', in: 'query', description: 'The user name for login', required: true, schema: new OA\Schema(type: 'string')),
new OA\Parameter(name: 'password', in: 'query', required: true, schema: new OA\Schema(type: 'string')),
],
)]
#[OA\Response(
response: 200,
description: 'successful operation',
headers: [
new OA\Header(header: 'X-Rate-Limit', description: 'calls per hour allowed by the user', schema: new OA\Schema(type: 'integer', format: 'int32')),
new OA\Header(header: 'X-Expires-After', description: 'date in UTC when token expires', schema: new OA\Schema(type: 'string', format: 'datetime')),
],
content: [
new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(type: 'string')),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(type: 'string')),
],
)]
#[OA\Response(response: 400, description: 'Invalid username/password supplied')]
public function loginUser()
{
}
#[OA\Operation\Get(
path: '/user/logout',
operationId: 'logoutUser',
summary: 'Logs out current logged in user session',
tags: ['user'],
)]
#[OA\Response(response: 'default', description: 'successful operation')]
public function logoutUser()
{
}
#[OA\Operation\Get(
path: '/user/{username}',
operationId: 'getUserByName',
summary: 'Get user by user name',
parameters: [
new OA\Parameter(name: 'username', in: 'path', required: true, schema: new OA\Schema(type: 'string')),
],
)]
#[OA\Response(
response: 200,
description: 'successful operation',
content: [
new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(ref: User::class)),
new OA\MediaType(mediaType: 'application/xml', schema: new OA\Schema(ref: User::class)),
],
)]
#[OA\Response(response: 400, description: 'Invalid username supplied')]
#[OA\Response(response: 404, description: 'User not found')]
public function getUserByName()
{
}
#[OA\Operation\Put(
path: '/user/{username}',
operationId: 'updateUser',
summary: 'Update user',
description: 'This can only be done by the logged in user.',
parameters: [
new OA\Parameter(name: 'username', in: 'path', description: 'name that to be updated', required: true, schema: new OA\Schema(type: 'string')),
],
requestBody: new OA\RequestBody(
description: 'Updated user object',
required: true,
content: [new OA\MediaType(mediaType: 'application/json', schema: new OA\Schema(ref: User::class))],
),
)]
#[OA\Response(response: 400, description: 'Invalid user supplied')]
#[OA\Response(response: 404, description: 'User not found')]
public function updateUser()
{
}
#[OA\Operation\Delete(
path: '/user/{username}',
operationId: 'deleteUser',
summary: 'Delete user',
description: 'This can only be done by the logged in user.',
parameters: [
new OA\Parameter(name: 'username', in: 'path', description: 'The name that needs to be deleted', required: true, schema: new OA\Schema(type: 'string')),
],
)]
#[OA\Response(response: 400, description: 'Invalid username supplied')]
#[OA\Response(response: 404, description: 'User not found')]
public function deleteUser()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Controllers;
use OpenApi\Attributes as OAT;
use OpenApi\Examples\Specs\Petstore\Attributes\Models\User;
use OpenApi\Examples\Specs\Petstore\Attributes\Models\UserArrayRequestBody;
/**
* Class User.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
class UserController
{
#[OAT\Post(path: '/user', operationId: 'createUser', description: 'This can only be done by the logged in user.', summary: 'Create user', requestBody: new OAT\RequestBody(
description: 'Create user object',
required: true,
content: new OAT\JsonContent(
ref: User::class
)
), tags: ['user'], responses: [
new OAT\Response(
response: 'default',
description: 'successful operation'
),
])]
public function createUser()
{
}
#[OAT\Post(path: '/user/createWithArray', operationId: 'createUsersWithListInput', summary: 'Create list of users with given input array', requestBody: new OAT\RequestBody(
ref: UserArrayRequestBody::class
), tags: ['user'], responses: [
new OAT\Response(
response: 'default',
description: 'successful operation'
),
])]
public function createUsersWithListInput()
{
}
#[OAT\Get(path: '/user/login', operationId: 'loginUser', summary: 'Logs user into system', tags: ['user'], parameters: [
new OAT\Parameter(
name: 'username',
description: 'The user name for login',
in: 'query',
required: true,
schema: new OAT\Schema(
type: 'string'
)
),
new OAT\Parameter(
name: 'password',
in: 'query',
required: true,
schema: new OAT\Schema(
type: 'string'
)
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
headers: [
new OAT\Header(
header: 'X-Rate-Limit',
description: 'calls per hour allowed by the user',
schema: new OAT\Schema(
type: 'integer',
format: 'int32'
)
),
new OAT\Header(
header: 'X-Expires-After',
description: 'date in UTC when token expires',
schema: new OAT\Schema(
type: 'string',
format: 'datetime'
)
),
],
content: [
new OAT\JsonContent(
type: 'string'
),
new OAT\XmlContent(
type: 'string'
),
]
),
new OAT\Response(
response: 400,
description: 'Invalid username/password supplied'
),
])]
public function loginUser()
{
}
#[OAT\Get(path: '/user/logout', operationId: 'logoutUser', summary: 'Logs out current logged in user session', tags: ['user'], responses: [
new OAT\Response(
response: 'default',
description: 'successful operation'
),
])]
public function logoutUser()
{
}
#[OAT\Get(path: '/user/{username}', operationId: 'getUserByName', summary: 'Get user by user name', parameters: [
new OAT\PathParameter(
name: 'username',
required: true,
schema: new OAT\Schema(
type: 'string'
)
),
], responses: [
new OAT\Response(
response: 200,
description: 'successful operation',
content: [
new OAT\JsonContent(
ref: User::class
),
new OAT\XmlContent(
ref: User::class
),
]
),
new OAT\Response(
response: 400,
description: 'Invalid username supplied'
),
new OAT\Response(
response: 404,
description: 'User not found'
),
])]
public function getUserByName()
{
}
#[OAT\Put(path: '/user/{username}', operationId: 'updateUser', description: 'This can only be done by the logged in user.', summary: 'Update user', requestBody: new OAT\RequestBody(
description: 'Updated user object',
required: true,
content: new OAT\JsonContent(
ref: User::class
)
), parameters: [
new OAT\PathParameter(
name: 'username',
description: 'name that to be updated',
required: true,
schema: new OAT\Schema(
type: 'string'
)
),
], responses: [
new OAT\Response(
response: 400,
description: 'Invalid user supplied'
),
new OAT\Response(
response: 404,
description: 'User not found'
),
])]
public function updateUser()
{
}
#[OAT\Delete(path: '/user/{username}', operationId: 'deleteUser', description: 'This can only be done by the logged in user.', summary: 'Delete user', parameters: [
new OAT\Parameter(
name: 'username',
description: 'The name that needs to be deleted',
in: 'path',
required: true,
schema: new OAT\Schema(
type: 'string'
)
),
], responses: [
new OAT\Response(
response: 400,
description: 'Invalid username supplied'
),
new OAT\Response(
response: 404,
description: 'User not found'
),
])]
public function deleteUser()
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Controllers;
use OpenApi\Annotations as OA;
/**
* Class User.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
class UserController
{
/**
* @OA\Post(
* path="/user",
* tags={"user"},
* summary="Create user",
* description="This can only be done by the logged in user.",
* operationId="createUser",
* @OA\Response(
* response="default",
* description="successful operation"
* ),
* @OA\RequestBody(
* description="Create user object",
* required=true,
* @OA\JsonContent(ref="#/components/schemas/User")
* )
* )
*/
public function createUser()
{
}
/**
* @OA\Post(
* path="/user/createWithArray",
* tags={"user"},
* summary="Create list of users with given input array",
* operationId="createUsersWithListInput",
* @OA\Response(
* response="default",
* description="successful operation"
* ),
* @OA\RequestBody(ref="#/components/requestBodies/UserArray")
* )
*/
public function createUsersWithListInput()
{
}
/**
* @OA\Get(
* path="/user/login",
* tags={"user"},
* summary="Logs user into system",
* operationId="loginUser",
* @OA\Parameter(
* name="username",
* in="query",
* description="The user name for login",
* required=true,
* @OA\Schema(
* type="string"
* )
* ),
* @OA\Parameter(
* name="password",
* in="query",
* required=true,
* @OA\Schema(
* type="string",
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\Header(
* header="X-Rate-Limit",
* description="calls per hour allowed by the user",
* @OA\Schema(
* type="integer",
* format="int32"
* )
* ),
* @OA\Header(
* header="X-Expires-After",
* description="date in UTC when token expires",
* @OA\Schema(
* type="string",
* format="datetime"
* )
* ),
* @OA\JsonContent(
* type="string"
* ),
* @OA\MediaType(
* mediaType="application/xml",
* @OA\Schema(
* type="string"
* )
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid username/password supplied"
* )
* )
*/
public function loginUser()
{
}
/**
* @OA\Get(
* path="/user/logout",
* tags={"user"},
* summary="Logs out current logged in user session",
* operationId="logoutUser",
* @OA\Response(
* response="default",
* description="successful operation"
* )
* )
*/
public function logoutUser()
{
}
/**
* @OA\Get(
* path="/user/{username}",
* summary="Get user by user name",
* operationId="getUserByName",
* @OA\Parameter(
* name="username",
* in="path",
* required=true,
* @OA\Schema(
* type="string"
* )
* ),
* @OA\Response(
* response=200,
* description="successful operation",
* @OA\JsonContent(ref="#/components/schemas/User"),
* @OA\MediaType(
* mediaType="application/xml",
* @OA\Schema(ref="#/components/schemas/User")
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid username supplied"
* ),
* @OA\Response(
* response=404,
* description="User not found"
* ),
* )
*/
public function getUserByName()
{
}
/**
* @OA\Put(
* path="/user/{username}",
* summary="Update user",
* description="This can only be done by the logged in user.",
* operationId="updateUser",
* @OA\Parameter(
* name="username",
* in="path",
* description="name that to be updated",
* required=true,
* @OA\Schema(
* type="string"
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid user supplied"
* ),
* @OA\Response(
* response=404,
* description="User not found"
* ),
* @OA\RequestBody(
* description="Updated user object",
* required=true,
* @OA\JsonContent(ref="#/components/schemas/User")
* )
* )
*/
public function updateUser()
{
}
/**
* @OA\Delete(
* path="/user/{username}",
* summary="Delete user",
* description="This can only be done by the logged in user.",
* operationId="deleteUser",
* @OA\Parameter(
* name="username",
* in="path",
* description="The name that needs to be deleted",
* required=true,
* @OA\Schema(
* type="string"
* )
* ),
* @OA\Response(
* response=400,
* description="Invalid username supplied",
* ),
* @OA\Response(
* response=404,
* description="User not found",
* )
* )
*/
public function deleteUser()
{
}
}Models/ApiResponse.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
/**
* Class ApiResponse.
*/
#[OA\Schema(title: 'Api response', description: 'Api response')]
class ApiResponse
{
#[OA\Property]
#[OA\Schema(title: 'Code', description: 'Code', format: 'int32')]
private int $code;
#[OA\Property]
#[OA\Schema(title: 'Type', description: 'Type')]
private string $type;
#[OA\Schema(title: 'Message', description: 'Message')]
private string $message;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
/**
* Class ApiResponse.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
#[OAT\Schema(title: 'Api response', description: 'Api response')]
class ApiResponse
{
#[OAT\Property(title: 'Code', description: 'Code', format: 'int32')]
private int $code;
#[OAT\Property(title: 'Type', description: 'Type')]
private string $type;
#[OAT\Property(title: 'Message', description: 'Message')]
private string $message;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* Class ApiResponse.
*
* @author Donii Sergii <doniysa@gmail.com>
*
* @OA\Schema(
* description="Api response",
* title="Api response"
* )
*/
class ApiResponse
{
/**
* @OA\Property(
* description="Code",
* title="Code",
* format="int32"
* )
*
* @var int
*/
private $code;
/**
* @OA\Property(
* description="Type",
* title="Type",
* )
*
* @var string
*/
private $type;
/**
* @OA\Property(
* description="Message",
* title="Message"
* )
*
* @var string
*/
private $message;
}Models/Category.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
/**
* Pets Category.
*/
#[OA\Schema(
title: 'Pets Category.',
xml: new OA\Xml(name: 'Category'),
)]
class Category
{
#[OA\Property]
#[OA\Schema(title: 'ID', description: 'ID', format: 'int64')]
private int $id;
#[OA\Property]
#[OA\Schema(title: 'Category name', description: 'Category name')]
private string $name;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
/**
* Pets Category.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
#[OAT\Schema(
title: 'Pets Category.',
xml: new OAT\Xml(
name: 'Category'
)
)]
class Category
{
#[OAT\Property(title: 'ID', description: 'ID', format: 'int64')]
private int $id;
#[OAT\Property(title: 'Category name', description: 'Category name')]
private string $name;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* Pets Category.
*
* @author Donii Sergii <doniysa@gmail.com>
*
* @OA\Schema(
* title="Pets Category.",
* @OA\Xml(
* name="Category"
* )
* )
*/
class Category
{
/**
* @OA\Property(
* title="ID",
* description="ID",
* format="int64",
* )
*
* @var int
*/
private $id;
/**
* @OA\Property(
* title="Category name",
* description="Category name"
* )
*
* @var string
*/
private $name;
}Models/Order.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
/**
* Class Order.
*/
#[OA\Schema(title: 'Order model', description: 'Order model')]
class Order
{
protected string $unrelated;
#[OA\Property]
#[OA\Schema(title: 'ID', description: 'ID', format: 'int64', default: 1)]
private int $id;
#[OA\Property]
#[OA\Schema(title: 'Pet ID', description: 'Pet ID', format: 'int64', default: 1)]
private int $petId;
#[OA\Property]
#[OA\Schema(title: 'Quantity', description: 'Quantity', format: 'int32', default: 12)]
private int $quantity;
#[OA\Property]
#[OA\Schema(title: 'Shipping date', description: 'Shipping date', format: 'datetime', default: '2017-02-02 18:31:45')]
private \DateTime $shipDate;
#[OA\Property]
#[OA\Schema(title: 'Order status', description: 'Order status', enum: ['placed', 'approved', 'delivered'], default: 'placed')]
private string $status;
#[OA\Property]
#[OA\Schema(title: 'Complete status', description: 'Complete status', default: false)]
private bool $complete;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
/**
* Class Order.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
#[OAT\Schema(title: 'Order model', description: 'Order model')]
class Order
{
protected string $unrelated;
#[OAT\Property(title: 'ID', description: 'ID', format: 'int64', default: 1)]
private int $id;
#[OAT\Property(title: 'Pet ID', description: 'Pet ID', format: 'int64', default: 1)]
private int $petId;
#[OAT\Property(title: 'Quantity', description: 'Quantity', format: 'int32', default: 12)]
private int $quantity;
#[OAT\Property(title: 'Shipping date', description: 'Shipping date', type: 'string', format: 'datetime', default: '2017-02-02 18:31:45')]
private \DateTime $shipDate;
#[OAT\Property(title: 'Order status', description: 'Order status', default: 'placed', enum: ['placed', 'approved', 'delivered'])]
private string $status;
#[OAT\Property(title: 'Complete status', description: 'Complete status', type: 'boolean', default: false)]
private bool $complete;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* Class Order.
*
* @author Donii Sergii <doniysa@gmail.com>
*
* @OA\Schema(
* title="Order model",
* description="Order model",
* )
*/
class Order
{
protected string $unrelated;
/**
* @OA\Property(
* format="int64",
* title="ID",
* default=1,
* description="ID",
* )
*
* @var int
*/
private $id;
/**
* @OA\Property(
* default=1,
* format="int64",
* description="Pet ID",
* title="Pet ID",
* )
*
* @var int
*/
private $petId;
/**
* @OA\Property(
* default=12,
* format="int32",
* description="Quantity",
* title="Quantity",
* )
*
* @var int
*/
private $quantity;
/**
* @OA\Property(
* default="2017-02-02 18:31:45",
* format="datetime",
* description="Shipping date",
* title="Shipping date",
* type="string"
* )
*
* @var \DateTime
*/
private $shipDate;
/**
* @OA\Property(
* default="placed",
* title="Order status",
* description="Order status",
* enum={"placed", "approved", "delivered"},
* )
*
* @var string
*/
private $status;
/**
* @OA\Property(
* default=false,
* type="boolean",
* description="Complete status",
* title="Complete status",
* )
*
* @var bool
*/
private $complete;
}Models/Pet.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
/**
* Class Pet.
*/
#[OA\Schema(title: 'Pet model', description: 'Pet model', required: [
'name',
'photoUrls',
], xml: new OA\Xml(name: 'Pet'))]
class Pet
{
#[OA\Schema(title: 'ID', description: 'ID', format: OA\Format::Int64)]
private int $id;
#[OA\Property]
#[OA\Schema(title: 'Category', ref: Category::class)]
private Category $category;
#[OA\Property]
#[OA\Schema(title: 'Pet name', description: 'Pet name', format: 'int64')]
private string $name;
/**
* @var array<string>
*/
#[OA\Property]
#[OA\Schema(
title: 'Photo urls',
description: 'Photo urls',
items: new OA\Schema(type: 'string', default: 'images/image-1.png'),
xml: new OA\Xml(name: 'photoUrl', wrapped: true),
)]
private array $photoUrls;
/**
* @var array<Tag>
*/
#[OA\Schema\Items(
title: 'Pet tags',
description: 'Pet tags',
ref: Tag::class,
xml: new OA\Xml(name: 'tag', wrapped: true),
)]
private array $tags;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
/**
* Class Pet.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
#[OAT\Schema(title: 'Pet model', description: 'Pet model', required: [
'name',
'photoUrls',
], xml: new OAT\Xml(
name: 'Pet'
))]
class Pet
{
#[OAT\Property(title: 'ID', description: 'ID', format: 'int64')]
private int $id;
#[OAT\Property(
title: 'Category'
)]
private Category $category;
#[OAT\Property(title: 'Pet name', description: 'Pet name', format: 'int64')]
private string $name;
#[OAT\Property(title: 'Photo urls', description: 'Photo urls', items: new OAT\Items(
type: 'string',
default: 'images/image-1.png'
), xml: new OAT\Xml(
name: 'photoUrl',
wrapped: true
))]
private array $photoUrls;
#[OAT\Property(title: 'Pet tags', description: 'Pet tags', items: new OAT\Items(
type: Tag::class
), xml: new OAT\Xml(
name: 'tag',
wrapped: true
))]
/**
* @var array<Tag>
*/
private array $tags;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* Class Pet.
*
* @author Donii Sergii <doniysa@gmail.com>
*
* @OA\Schema(
* description="Pet model",
* title="Pet model",
* required={"name", "photoUrls"},
* @OA\Xml(
* name="Pet"
* )
* )
*/
class Pet
{
/**
* @OA\Property(
* format="int64",
* description="ID",
* title="ID",
* )
*
* @var int
*/
private $id;
/**
* @OA\Property(
* title="Category",
* )
*
* @var Category
*/
private $category;
/**
* @OA\Property(
* format="int64",
* description="Pet name",
* title="Pet name",
* )
*
* @var string
*/
private $name;
/**
* @OA\Property(
* description="Photo urls",
* title="Photo urls",
* @OA\Xml(
* name="photoUrl",
* wrapped=true
* ),
* @OA\Items(
* type="string",
* default="images/image-1.png"
* )
* )
*
* @var array
*/
private $photoUrls;
/**
* @OA\Property(
* description="Pet tags",
* title="Pet tags",
* @OA\Xml(
* name="tag",
* wrapped=true
* ),
* )
*
* @var Tag[]
*/
private $tags;
}Models/PetRequestBody.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
#[OA\RequestBody(description: 'Pet object that needs to be added to the store', required: true, content: [
new OA\MediaType\Json(ref: Pet::class),
new OA\MediaType(
mediaType: 'application/xml',
schema: new OA\Schema(ref: Pet::class),
),
], component: 'Pet')]
class PetRequestBody
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
#[OAT\RequestBody(
request: 'Pet',
description: 'Pet object that needs to be added to the store',
required: true,
content: [
new OAT\JsonContent(
ref: Pet::class
),
new OAT\MediaType(
mediaType: 'application/xml',
schema: new OAT\Schema(
ref: Pet::class
)
),
]
)]
class PetRequestBody
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* @OA\RequestBody(
* request="Pet",
* description="Pet object that needs to be added to the store",
* required=true,
* @OA\JsonContent(ref="#/components/schemas/Pet"),
* @OA\MediaType(
* mediaType="application/xml",
* @OA\Schema(ref="#/components/schemas/Pet")
* )
* )
*/
class PetRequestBody
{
}Models/Tag.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
/**
* Tag.
*/
#[OA\Schema(
title: 'Tag',
xml: new OA\Xml(name: 'Tag'),
)]
class Tag
{
#[OA\Property]
#[OA\Schema(title: 'ID', description: 'ID', format: 'int64')]
private int $id;
#[OA\Property]
#[OA\Schema(title: 'Name', description: 'Name')]
private string $name;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
/**
* Tag.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
#[OAT\Schema(
title: 'Tag',
xml: new OAT\Xml(
name: 'Tag'
)
)]
class Tag
{
#[OAT\Property(
title: 'ID',
description: 'ID',
format: 'int64'
)]
private int $id;
#[OAT\Property(
title: 'Name',
description: 'Name'
)]
private string $name;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* Tag.
*
* @author Donii Sergii <doniysa@gmail.com>
*
* @OA\Schema(
* title="Tag",
* @OA\Xml(
* name="Tag"
* )
* )
*/
class Tag
{
/**
* @OA\Property(
* format="int64",
* description="ID",
* title="ID"
* )
*
* @var int
*/
private $id;
/**
* @OA\Property(
* description="Name",
* title="Name"
* )
*
* @var string
*/
private $name;
}Models/User.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
/**
* Class User.
*/
#[OA\Schema(title: 'User model', description: 'User model')]
class User
{
#[OA\Property]
#[OA\Schema(title: 'ID', description: 'ID', format: OA\Format::Int64)]
private int $id;
#[OA\Property]
#[OA\Schema(title: 'Username', description: 'Username')]
private string $username;
#[OA\Schema(title: 'First name', description: 'First name')]
private string $firstName;
#[OA\Schema(title: 'Last name', description: 'Last name')]
private string $lastName;
#[OA\Schema(title: 'Email', description: 'Email', format: OA\Format::Email)]
private string $email;
#[OA\Property]
#[OA\Schema(title: 'Password', description: 'Password', maximum: 255)]
private string $password;
#[OA\Property]
#[OA\Schema(title: 'Phone', description: 'Phone', format: 'msisdn')]
private string $phone;
#[OA\Property]
#[OA\Schema(title: 'User status', description: 'User status', format: OA\Format::Int32)]
private int $userStatus;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
/**
* Class User.
*
* @author Donii Sergii <doniysa@gmail.com>
*/
#[OAT\Schema(
title: 'User model',
description: 'User model'
)]
class User
{
#[OAT\Property(
title: 'ID',
description: 'ID',
format: 'int64'
)]
private int $id;
#[OAT\Property(
title: 'Username',
description: 'Username'
)]
private string $username;
#[OAT\Property(
title: 'First name',
description: 'First name'
)]
private string $firstName;
#[OAT\Property(
title: 'Last name',
description: 'Last name'
)]
private string $lastName;
#[OAT\Property(
title: 'Email',
description: 'Email',
format: 'email'
)]
private string $email;
#[OAT\Property(
title: 'Password',
description: 'Password',
maximum: 255
)]
private string $password;
#[OAT\Property(
title: 'Phone',
description: 'Phone',
format: 'msisdn'
)]
private string $phone;
#[OAT\Property(
title: 'User status',
description: 'User status',
format: 'int32'
)]
private int $userStatus;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* Class User.
*
* @author Donii Sergii <doniysa@gmail.com>
*
* @OA\Schema(
* title="User model",
* description="User model",
* )
*/
class User
{
/**
* @OA\Property(
* format="int64",
* description="ID",
* title="ID",
* )
*
* @var int
*/
private $id;
/**
* @OA\Property(
* description="Username",
* title="Username",
* )
*
* @var string
*/
private $username;
/**
* @OA\Property(
* description="First name",
* title="First name",
* )
*
* @var string
*/
private $firstName;
/**
* @OA\Property(
* description="Last name",
* title="Last name",
* )
*
* @var string
*/
private $lastName;
/**
* @OA\Property(
* format="email",
* description="Email",
* title="Email",
* )
*
* @var string
*/
private $email;
/**
* @OA\Property(
* description="Password",
* title="Password",
* maximum=255
* )
*
* @var string
*/
private $password;
/**
* @OA\Property(
* format="msisdn",
* description="Phone",
* title="Phone",
* )
*
* @var string
*/
private $phone;
/**
* @OA\Property(
* format="int32",
* description="User status",
* title="User status",
* )
*
* @var int
*/
private $userStatus;
}Models/UserArrayRequestBody.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec\Models;
use OpenApi\Spec as OA;
#[OA\RequestBody(description: 'List of user object', required: true, content: [
new OA\MediaType\Json(schema: new OA\Schema\Items(ref: User::class)),
], component: 'UserArray')]
class UserArrayRequestBody
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes\Models;
use OpenApi\Attributes as OAT;
#[OAT\RequestBody(
request: 'UserArray',
description: 'List of user object',
required: true,
content: new OAT\JsonContent(
type: 'array',
items: new OAT\Items(
ref: User::class
)
)
)]
class UserArrayRequestBody
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations\Models;
use OpenApi\Annotations as OA;
/**
* @OA\RequestBody(
* request="UserArray",
* description="List of user object",
* required=true,
* @OA\JsonContent(
* type="array",
* @OA\Items(ref="#/components/schemas/User")
* )
* )
*/
class UserArrayRequestBody
{
}Petstore.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec;
use OpenApi\Spec as OA;
#[OA\OpenApi(version: '3.1.0')]
#[OA\Info(title: 'Swagger Petstore', description: "This is a sample Petstore server.\nYou can find out more about Swagger at [http://swagger.io](http://swagger.io)\nor on [irc.freenode.net, #swagger](http://swagger.io/irc/).", termsOfService: 'http://swagger.io/terms/', version: '1.0.0', contact: new OA\Contact(email: 'apiteam@swagger.io'), license: new OA\License(
name: 'Apache 2.0',
url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
))]
#[OA\Server(url: 'https://petstore.com/1.0.0', description: 'Petstore API')]
#[OA\Tag(
name: 'pet',
description: 'Everything about your Pets',
externalDocs: new OA\ExternalDocumentation(url: 'http://swagger.io', description: 'Find out more'),
)]
#[OA\Tag(name: 'store', description: 'Access to Petstore orders')]
#[OA\Tag(
name: 'user',
description: 'Operations about user',
externalDocs: new OA\ExternalDocumentation(url: 'http://swagger.io', description: 'Find out more about store'),
)]
#[OA\ExternalDocumentation(url: 'http://swagger.io', description: 'Find out more about Swagger')]
class Petstore
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\OpenApi(info: new OAT\Info(
version: '1.0.0',
description: 'This is a sample Petstore server.
You can find out more about Swagger at [http://swagger.io](http://swagger.io)
or on [irc.freenode.net, #swagger](http://swagger.io/irc/).',
title: 'Swagger Petstore',
termsOfService: 'http://swagger.io/terms/',
contact: new OAT\Contact(email: 'apiteam@swagger.io'),
license: new OAT\License(
name: 'Apache 2.0',
url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
)
), servers: [
new OAT\Server(
url: 'https://petstore.com/1.0.0',
description: 'Petstore API'
),
], tags: [
new OAT\Tag(
name: 'pet',
description: 'Everything about your Pets',
externalDocs: new OAT\ExternalDocumentation(
description: 'Find out more',
url: 'http://swagger.io'
)
),
new OAT\Tag(
name: 'store',
description: 'Access to Petstore orders'
),
new OAT\Tag(
name: 'user',
description: 'Operations about user',
externalDocs: new OAT\ExternalDocumentation(
description: 'Find out more about store',
url: 'http://swagger.io'
)
),
], externalDocs: new OAT\ExternalDocumentation(
description: 'Find out more about Swagger',
url: 'http://swagger.io'
))]
class Petstore
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\Info(
* description="This is a sample Petstore server.
You can find out more about Swagger at [http://swagger.io](http://swagger.io)
or on [irc.freenode.net, #swagger](http://swagger.io/irc/).",
* version="1.0.0",
* title="Swagger Petstore",
* termsOfService="http://swagger.io/terms/",
* @OA\Contact(
* email="apiteam@swagger.io"
* ),
* @OA\License(
* name="Apache 2.0",
* url="http://www.apache.org/licenses/LICENSE-2.0.html"
* )
* )
* @OA\Tag(
* name="pet",
* description="Everything about your Pets",
* @OA\ExternalDocumentation(
* description="Find out more",
* url="http://swagger.io"
* )
* )
* @OA\Tag(
* name="store",
* description="Access to Petstore orders",
* )
* @OA\Tag(
* name="user",
* description="Operations about user",
* @OA\ExternalDocumentation(
* description="Find out more about store",
* url="http://swagger.io"
* )
* )
* @OA\Server(
* description="Petstore API",
* url="https://petstore.com/1.0.0"
* )
* @OA\ExternalDocumentation(
* description="Find out more about Swagger",
* url="http://swagger.io"
* )
*/
class Petstore
{
}Security.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Spec;
use OpenApi\Spec as OA;
#[OA\Security\Scheme\OAuth2(flows: [
new OA\Flow\Implicit(
authorizationUrl: 'http://petstore.swagger.io/oauth/dialog',
scopes: [
'write:pets' => 'modify pets in your account',
'read:pets' => 'read your pets',
],
),
], component: 'petstore_auth')]
#[OA\Security\Scheme(type: OA\SchemeType::ApiKey, name: 'api_key', in: 'header', component: 'api_key')]
class Security
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\SecurityScheme(securityScheme: 'petstore_auth', type: 'oauth2', name: 'petstore_auth', flows: [
new OAT\Flow(
authorizationUrl: 'http://petstore.swagger.io/oauth/dialog',
flow: 'implicit',
scopes: [
'write:pets' => 'modify pets in your account',
'read:pets' => 'read your pets',
]
),
])]
#[OAT\SecurityScheme(securityScheme: 'api_key', type: 'apiKey', name: 'api_key', in: 'header')]
class Security
{
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Petstore\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\SecurityScheme(
* type="oauth2",
* name="petstore_auth",
* securityScheme="petstore_auth",
* @OA\Flow(
* flow="implicit",
* authorizationUrl="http://petstore.swagger.io/oauth/dialog",
* scopes={
* "write:pets": "modify pets in your account",
* "read:pets": "read your pets",
* }
* )
* )
* @OA\SecurityScheme(
* type="apiKey",
* in="header",
* securityScheme="api_key",
* name="api_key"
* )
*/
class Security
{
}Polymorphism
Demonstrates the use of Discriminator
AbstractResponsible.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Spec;
use OpenApi\Spec as OA;
#[OA\Schema(oneOf: [
new OA\Schema(ref: Fl::class),
new OA\Schema(ref: Employee::class),
], discriminator: new OA\Discriminator(
propertyName: 'type',
mapping: [
'fl' => Fl::class,
'employee' => Employee::class,
],
), component: 'Responsible')]
abstract class AbstractResponsible
{
protected const TYPE = null;
#[OA\Property]
#[OA\Schema(nullable: false, enum: ['employee', 'assignee', 'fl'])]
protected string $type;
public function __construct()
{
$this->type = static::TYPE;
}
}php
<?php
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\Schema(schema: 'Responsible', discriminator: new OAT\Discriminator(
propertyName: 'type',
mapping: [
'fl' => Fl::class,
'employee' => Employee::class,
]
), oneOf: [
new OAT\Schema(ref: Fl::class),
new OAT\Schema(ref: Employee::class),
])]
abstract class AbstractResponsible
{
protected const TYPE = null;
#[OAT\Property(nullable: false, enum: ['employee', 'assignee', 'fl'])]
protected string $type;
public function __construct()
{
$this->type = static::TYPE;
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\Schema(
* schema="Responsible",
* @OA\Discriminator(
* propertyName="type",
* mapping={
* "fl": "#/components/schemas/FlResponsible",
* "employee": "#/components/schemas/EmployeeResponsible"
* }
* ),
* oneOf={
* @OA\Schema(ref="#/components/schemas/FlResponsible"),
* @OA\Schema(ref="#/components/schemas/EmployeeResponsible")
* }
* )
*/
abstract class AbstractResponsible
{
protected const TYPE = null;
/**
* @OA\Property(nullable=false, enum={"employee", "assignee", "fl"})
*
* @var string
*/
protected $type;
public function __construct()
{
$this->type = static::TYPE;
}
}Controller.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Spec;
use OpenApi\Spec as OA;
#[OA\Info(title: 'Polymorphism', description: 'Polymorphism example', version: '1', contact: new OA\Contact(name: 'Swagger API Team'))]
#[OA\Server(url: 'https://example.localhost', description: 'API server')]
#[OA\Tag(name: 'api', description: 'API operations')]
class Controller
{
#[OA\Operation\Get(
path: '/test',
operationId: 'test',
description: 'Get test',
tags: ['api'],
)]
#[OA\Response(
response: 200,
description: 'Polymorphism',
content: [new OA\MediaType\Json(ref: Request::class)],
)]
public function getProduct($id)
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\Info(version: '1', description: 'Polymorphism example', title: 'Polymorphism', contact: new OAT\Contact(
name: 'Swagger API Team'
))]
#[OAT\Tag(
name: 'api',
description: 'API operations'
)]
#[OAT\Server(
url: 'https://example.localhost',
description: 'API server'
)]
class Controller
{
#[OAT\Get(
path: '/test',
operationId: 'test',
description: 'Get test',
tags: ['api'],
responses: [
new OAT\Response(
response: 200,
description: 'Polymorphism',
content: new OAT\JsonContent(
ref: Request::class
)
),
]
)]
public function getProduct($id)
{
}
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\Info(
* title="Polymorphism",
* description="Polymorphism example",
* version="1",
* @OA\Contact(name="Swagger API Team")
* )
* @OA\Tag(
* name="api",
* description="API operations"
* )
* @OA\Server(
* url="https://example.localhost",
* description="API server"
* )
*/
class Controller
{
/**
* @OA\Get(
* path="/test",
* operationId="test",
* description="Get test",
* tags={"api"},
* @OA\Response(
* response="200",
* description="Polymorphism",
* @OA\JsonContent(ref="#/components/schemas/Request")
* )
* )
*/
public function getProduct($id)
{
}
}Employee.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Spec;
use OpenApi\Spec as OA;
#[OA\Schema(component: 'EmployeeResponsible')]
final class Employee extends AbstractResponsible
{
#[OA\Property(property: 'type')]
protected const TYPE = 'Virtual';
#[OA\Property]
#[OA\Schema(nullable: false)]
public string $property2;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\Schema(
schema: 'EmployeeResponsible'
)]
final class Employee extends AbstractResponsible
{
#[OAT\Property(
property: 'type'
)]
protected const TYPE = 'Virtual';
#[OAT\Property(
nullable: false
)]
public string $property2;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\Schema(schema="EmployeeResponsible")
*/
final class Employee extends AbstractResponsible
{
/**
* @OA\Property(property="type")
*/
protected const TYPE = 'Virtual';
/**
* @OA\Property(nullable=false)
*
* @var string
*/
public $property2;
}Fl.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Spec;
use OpenApi\Spec as OA;
#[OA\Schema(component: 'FlResponsible')]
final class Fl extends AbstractResponsible
{
public const TYPE = 'fl';
#[OA\Property]
public ?string $property3 = null;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\Schema(
schema: 'FlResponsible'
)]
final class Fl extends AbstractResponsible
{
public const TYPE = 'fl';
#[OAT\Property]
public ?string $property3 = null;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\Schema(schema="FlResponsible")
*/
final class Fl extends AbstractResponsible
{
public const TYPE = 'fl';
/**
* @OA\Property(nullable=true)
*
* @var string
*/
public $property3;
}Request.php
php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Spec;
use OpenApi\Spec as OA;
#[OA\Schema]
final class Request
{
protected const TYPE = 'employee';
#[OA\Property]
public AbstractResponsible $payload;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Attributes;
use OpenApi\Attributes as OAT;
#[OAT\Schema]
final class Request
{
protected const TYPE = 'employee';
#[OAT\Property]
public AbstractResponsible $payload;
}php
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Examples\Specs\Polymorphism\Annotations;
use OpenApi\Annotations as OA;
/**
* @OA\Schema(schema="Request")
*/
final class Request
{
protected const TYPE = 'employee';
/**
* @OA\Property(nullable=false)
*
* @var AbstractResponsible
*/
public $payload;
}