PHP code example of organiseyou / openapi-generator

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

organiseyou / openapi-generator example snippets

use OrganiseYou\OpenApi\OpenApiService;

$api = new OpenApiService(
    title: 'My API',
    version: '1.0.0',
    description: 'My awesome API',
    basePath: '/api/v1'
);

// Define a schema
$api->schema('User')
    ->type('object')
    ->property('id', 'integer', ['description' => 'User ID'])
    ->property('name', 'string', ['maxLength' => 255])
    ->property('email', 'string', ['format' => 'email'])
    ->]
            ]
        ]
    ])
    ->register();

// Generate the specification
$spec = $api->toJson();

$api->schema('Product')
    ->type('object')
    ->property('id', 'integer', ['example' => 1])
    ->property('name', 'string', ['maxLength' => 255])
    ->property('price', 'number', ['format' => 'float', 'example' => 29.99])
    ->property('description', 'string', ['nullable' => true])
    ->

$userSchema = $api->schema('User')->type('object');

$properties = [
    'id' => ['type' => 'integer', 'example' => 10],
    'username' => ['type' => 'string', 'example' => 'john_doe'],
    'email' => ['type' => 'string', 'example' => '[email protected]'],
    'status' => ['type' => 'string', 'enum' => ['active', 'inactive']],
];

foreach ($properties as $name => $config) {
    $type = $config['type'];
    unset($config['type']);
    $userSchema->property($name, $type, $config);
}

$userSchema->

$api->path('/users/{id}')
    ->method('GET')
    ->summary('Get a specific user')
    ->description('Retrieve a user by their ID')
    ->tags(['Users'])
    ->parameters([
        [
            'name' => 'id',
            'in' => 'path',
            '['$ref' => '#/components/schemas/User']
            ]
        ]
    ])
    ->response(404, ['description' => 'User not found'])
    ->register();

$api->path('/users')
    ->method('POST')
    ->summary('Create a new user')
    ->tags(['Users'])
    ->requestBody([
        'application/json' => [
            'schema' => ['$ref' => '#/components/schemas/User']
        ]
    ], true)
    ->response(201, [
        'description' => 'User created',
        'content' => [
            'application/json' => [
                'schema' => ['$ref' => '#/components/schemas/User']
            ]
        ]
    ])
    ->response(400, ['description' => 'Invalid input'])
    ->register();

$api->path('/users')
    ->method('GET')
    ->summary('List users')
    ->response(200, ['description' => 'Success'])
    ->register()
    ->path('/users')
    ->method('POST')
    ->summary('Create user')
    ->response(201, ['description' => 'Created'])
    ->register();

$api->addResponse('NotFound', [
    'description' => 'Resource not found',
    'content' => [
        'application/json' => [
            'schema' => ['$ref' => '#/components/schemas/Error']
        ]
    ]
]);

$api->addResponse('Unauthorized', [
    'description' => 'Unauthorized access',
    'content' => [
        'application/json' => [
            'schema' => ['$ref' => '#/components/schemas/Error']
        ]
    ]
]);

$json = $api->toJson();
// or with custom flags:
$json = $api->toJson(JSON_PRETTY_PRINT);

$spec = $api->generate();

$yaml = $api->toYaml();

// routes/api.php

Route::get('/docs', function () {
    $api = new OpenApiService('My API', '1.0.0');
    
    // Define your schemas and endpoints
    $api->schema('User')->type('object')->property('id', 'integer')->register();
    $api->path('/users')->method('GET')->response(200, [])->register();
    
    return response()->json($api->generate());
});

namespace App\Services;

use OrganiseYou\OpenApi\OpenApiService;

class ApiDocumentationService
{
    public static function generate(): OpenApiService
    {
        $api = new OpenApiService(
            title: config('app.name'),
            version: '1.0.0',
            basePath: '/api/v1'
        );

        // Define your schemas and endpoints here
        self::defineUserSchema($api);
        self::defineUserEndpoints($api);

        return $api;
    }

    private static function defineUserSchema(OpenApiService $api): void
    {
        $api->schema('User')
            ->type('object')
            ->property('id', 'integer')
            ->property('name', 'string')
            ->property('email', 'string')
            ->

namespace App\Http\Controllers;

use App\Services\ApiDocumentationService;

class ApiDocumentationController extends Controller
{
    public function show()
    {
        $api = ApiDocumentationService::generate();
        return response()->json($api->generate());
    }
}

use OrganiseYou\OpenApi\OpenApiService;

$api = new OpenApiService(
    title: 'Pet Store API',
    version: '1.0.0',
    description: 'A simple Pet Store API',
    basePath: '/api/v1'
);

// Define schemas
$api->schema('Pet')
    ->type('object')
    ->property('id', 'integer', ['example' => 1])
    ->property('name', 'string', ['example' => 'Fluffy'])
    ->property('status', 'string', ['enum' => ['available', 'sold']])
    ->chema' => [
                    'type' => 'array',
                    'items' => ['$ref' => '#/components/schemas/Pet']
                ]
            ]
        ]
    ])
    ->register()
    ->path('/pets')
    ->method('POST')
    ->summary('Create a pet')
    ->tags(['Pets'])
    ->requestBody([
        'application/json' => [
            'schema' => ['$ref' => '#/components/schemas/Pet']
        ]
    ])
    ->response(201, [
        'description' => 'Pet created',
        'content' => [
            'application/json' => [
                'schema' => ['$ref' => '#/components/schemas/Pet']
            ]
        ]
    ])
    ->register();

// Get the specification
$spec = $api->toJson();
echo $spec;