Skip to content

Releases: openapi/openapi-php-sdk

Openapi® PHP SDK v1.3.0

08 May 16:18

Choose a tag to compare

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 into Client.
  • Added CurlTransport as the default implementation, extracted from Client to respect the single-responsibility principle.
  • Full PSR-18 compatibility: psr/http-client is now a declared dependency.

🌿 Built-in DotEnv Support

  • Added DotEnv loader for lightweight .env file parsing with no external dependencies.
  • Added Bootstrap — automatically loaded via Composer's files autoload — 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 Openapi prefix from all class and file names — the Openapi\ namespace already provides the context.
  • Renamed ExceptionApiException to avoid shadowing PHP's built-in \Exception.
  • OauthClient now 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 upkeep branch 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

09 Dec 17:26

Choose a tag to compare

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.