Download the PHP package methorz/openapi-generator without Composer
On this page you can find all versions of the php package methorz/openapi-generator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package openapi-generator
MethorZ OpenAPI Generator
Automatic OpenAPI 3.0 specification generator from routes and DTOs
Automatically generates OpenAPI specifications by analyzing your application's routes and Data Transfer Objects (DTOs). Perfect for Mezzio, Laminas, and any PSR-15 application.
✨ Features
- 🚀 Automatic Generation: Scans routes and DTOs to generate complete OpenAPI specs
- 📝 DTO Analysis: Extracts request/response schemas from PHP DTOs with property promotion
- ✅ Validation Integration: Reads Symfony Validator attributes for schema constraints
- 🎯 Handler Detection: Automatically finds request and response DTOs in handlers
- 📦 Multiple Formats: Generates both YAML and JSON outputs
- 🔧 Zero Configuration: Works out-of-the-box with sensible defaults
- 🎨 Customizable: Configure via application config
- 🔗 Nested DTOs: Automatically generates schemas for nested DTO references
- 📚 Collections: Supports typed arrays with
@param array<Type>PHPDoc - 🎲 Enums: Full support for backed and unit enums (PHP 8.1+)
- 🔀 Union Types: Generates
oneOfschemas for union types (PHP 8.0+) - ⚡ Performance: Schema caching for efficient generation
📋 Requirements
This package requires PHP 8.2+ and uses the following runtime dependencies:
| Package | Purpose | Framework Required? |
|---|---|---|
psr/container |
PSR-11 Container Interface | ❌ No |
symfony/console |
CLI command handling | ❌ No (standalone utility) |
symfony/yaml |
YAML file parsing/writing | ❌ No (standalone utility) |
Note: The Symfony packages used are standalone utility libraries, not framework components. They work independently without the Symfony framework and are used by many non-Symfony projects (Composer, PHPStan, PHPUnit, etc.).
📦 Installation
🚀 Quick Start
1. Register the Command
Add to your application's command configuration:
2. Generate Specification
This will create:
public/openapi.yaml- YAML formatpublic/openapi.json- JSON format
📖 Usage
Basic Configuration
Example Handler
The generator automatically analyzes your handlers:
Example Request DTO
Generated Schema:
📋 Supported Validation Attributes
The generator extracts constraints from Symfony Validator attributes:
| Attribute | OpenAPI Property |
|---|---|
@Assert\NotBlank |
required: true |
@Assert\Length(min, max) |
minLength, maxLength |
@Assert\Range(min, max) |
minimum, maximum |
@Assert\Email |
format: email |
@Assert\Url |
format: uri |
@Assert\Uuid |
format: uuid |
🚀 Advanced Features
Enum Support
Generates enum schemas from PHP 8.1+ backed enums:
Generated Schema:
Nested DTOs
Automatically generates schemas for nested DTO objects:
Generated Schema:
Typed Collections
Supports typed arrays using PHPDoc annotations:
Generated Schema:
Union Types
Generates oneOf schemas for union types:
Generated Schema:
🎯 Features
Route Detection
Scans your application's route configuration:
Automatic Operation Generation
Creates OpenAPI operations with:
- HTTP method (GET, POST, PUT, DELETE, etc.)
- Path parameters (extracted from
{id}patterns) - Request body (for POST/PUT/PATCH)
- Response schemas
- Summary and operationId
- Tags (from module namespace)
Path Parameters
Automatically detects and types path parameters:
📂 Generated Output
OpenAPI Structure
🔧 Configuration
Full Configuration Example
📊 Integration with Swagger UI
View your generated OpenAPI specification:
Or use online tools:
🧪 Testing
🤝 Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Write tests for new features
- Ensure all quality checks pass (
composer quality) - Submit a pull request
📄 License
MIT License. See LICENSE for details.
🔗 Related Packages
This package is part of the MethorZ HTTP middleware ecosystem:
| Package | Description |
|---|---|
| methorz/http-dto | Automatic HTTP ↔ DTO conversion with validation |
| methorz/http-problem-details | RFC 7807 error handling middleware |
| methorz/http-cache-middleware | HTTP caching with ETag support |
| methorz/http-request-logger | Structured logging with request tracking |
| methorz/openapi-generator | Automatic OpenAPI spec generation (this package) |
These packages work together seamlessly in PSR-15 applications.
🙏 Acknowledgments
Built with:
📞 Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
🔗 Links
- Changelog
- Contributing
- Security
Made with ❤️ by Thorsten Merz
All versions of openapi-generator with dependencies
psr/container Version ^1.1 || ^2.0
symfony/console Version ^6.0 || ^7.0
symfony/yaml Version ^6.0 || ^7.0