Release 1.3.0 — Openapi® PHP SDK
The 1.3.0 release of the Openapi® PHP SDK introduces a redesigned transport layer, built-in environment support, and a cleaner class naming convention — making the SDK more composable, testable, and framework-friendly.
🔌 Pluggable HTTP Transport
- Introduced
HttpTransportInterface— inject any HTTP client (Guzzle, PSR-18, Laravel HTTP) directly intoClient. - Added
CurlTransportas the default implementation, extracted fromClientto respect the single-responsibility principle. - Full PSR-18 compatibility:
psr/http-clientis now a declared dependency.
🌿 Built-in DotEnv Support
- Added
DotEnvloader for lightweight.envfile parsing with no external dependencies. - Added
Bootstrap— automatically loaded via Composer'sfilesautoload — for seamless environment bootstrapping in plain PHP projects. - Framework-safe: does not override variables already set by Laravel, Symfony, or CI environments.
🧹 Cleaner Naming Convention
- Removed redundant
Openapiprefix from all class and file names — theOpenapi\namespace already provides the context. - Renamed
Exception→ApiExceptionto avoid shadowing PHP's built-in\Exception. OauthClientnow supports environment variable fallback for credentials and OAuth URLs.
👥 Contributors
- Added full author attribution in
composer.json— Lorenzo Paderi, Mario Ugurcu, Francesco Bianco, and Claude Code. - Work from the
upkeepbranch has been properly integrated and credited.
A special thank you to Mario Ugurcu (@Seraphim200001) for contributing the transport injection architecture and the DotEnv support that form the core of this release. Your work made this possible.
🚀 Looking Ahead
Version 1.3.0 establishes the architectural foundation for future extensibility. Next milestones include middleware support, structured error responses, and a retry policy interface built on top of the new transport layer.