Releases: openapi/openapi-php-sdk
Openapi® PHP SDK v1.3.0
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.
Openapi® PHP SDK v1.2.1
Release 1.2.1 — Openapi® PHP SDK Evolves
The 1.2.1 release of the Openapi® PHP SDK brings enhanced stability, consistency, and practical improvements, providing a more reliable foundation for building robust API clients.
🧱 Stability and Reliability
- Minor bugs and compatibility issues have been resolved, ensuring predictable behavior across all use cases.
- Improved error handling and data validation reduce runtime risks and unexpected behaviors.
🌍 Consistency and Interoperability
- Updates to the core PHP SDK align it more closely with other language implementations.
- Client structures and data models now adhere strictly to OpenAPI standards, making integration across diverse systems smoother.
🧩 Developer-Focused Enhancements
- Optimized support for type hinting and JSON serialization.
- Refactored classes improve separation between business logic and HTTP request handling.
- Added utilities simplify client extension and the creation of custom helpers.
🎯 Why This Matters
- Provides a solid foundation for building reliable SDKs, reducing time spent debugging and integrating.
- Enables teams to maintain consistency between PHP projects and other OpenAPI implementations without sacrificing flexibility.
- Offers a stable starting point for all future SDK enhancements.
🚀 Looking Ahead
Version 1.2.1 is not an endpoint; it’s a step toward a PHP SDK that is more coherent, stable, and extendable. Future releases will continue to improve performance, usability, and interoperability across all supported languages.