Install

composer require langsys/openapi-docs-generator Copy

PHP 8.1+ Laravel 10 / 11

Packagist ↗ GitHub ↗

Requirements

• PHP 8.1+
• Laravel 10 / 11
• spatie/laravel-data ^3.9 or ^4.0

Installation

1. Require the package:

   composer require langsys/openapi-docs-generator

2. Publish the config:

   php artisan vendor:publish --provider="Langsys\OpenApiDocsGenerator\OpenApiDocsServiceProvider" --tag=config

   This creates config/openapi-docs.php.

Quick start

Out of the box, the package scans your entire app/ directory for both controller annotations and Data subclasses. No path or namespace configuration needed — DTOs can live anywhere.

namespace App\DataObjects;

use Spatie\LaravelData\Data;

class UserData extends Data
{
    public function __construct(
        public int $id,
        public string $name,
        public string $email,
        public ?string $phone,
        public bool $is_active = true,
    ) {}
}

php artisan openapi:generate

Output: storage/api-docs/api-docs.json with a UserData schema containing all properties, types, defaults, and auto-generated example values.