php openapi generator

The problem

Writing OpenAPI specs for legacy or undocumented PHP APIs is tedious and prone to human error. Developers often waste hours manually syncing YAML files with their Laravel, Slim, or plain PHP route and controller logic.

What it does

• Scans PHP route files and controllers to identify HTTP methods, paths, and parameters.
• Extracts request validation rules and response shapes directly from the source code.
• Maps PHP data structures to valid OpenAPI 3.0 types (string, integer, boolean, etc.).
• Organizes repeated data structures into reusable components and schemas via $ref.
• Detects authentication middleware and security requirements like Bearer tokens or API keys.

Frameworks & tools

Supports Laravel, Slim, and plain PHP. Generates OpenAPI 3.0.3 YAML compatible with Swagger UI, Redoc, and Postman.

Why this beats prompting it yourself

Generic prompts often hallucinate endpoints or invent response fields that do not exist. This skill follows a strict extraction logic that prioritizes code-level evidence, marking gaps with TODO comments instead of fabricating data.

Use cases

• Documenting an existing Laravel API for a new frontend team.
• Generating a spec file to bootstrap client SDK generation.
• Creating a Postman collection source for manual testing.
• Audit of internal endpoints for security and compliance reviews.

Known limitations

Designed for documenting existing code only, not for scaffolding new endpoints. Requires access to both route definitions and controller logic for accurate schema generation.