From 040fd843a24f3e8c206ef2356cf4c4e9d72361fb Mon Sep 17 00:00:00 2001 From: Grzegorz Biernacki Date: Tue, 27 Oct 2026 11:28:43 +0100 Subject: [PATCH] Document PHP SDK 2.0.0 upgrade notes in README --- sdks/php/README.md | 9 +++++++++ sdks/php/templates/README.mustache | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/sdks/php/README.md b/sdks/php/README.md index e54a184a6..575bf3745 100644 --- a/sdks/php/README.md +++ b/sdks/php/README.md @@ -3,6 +3,15 @@ Dropbox Sign v3 API +## Upgrading to 2.0.0 + +Version 2.0.0 is generated with OpenAPI Generator 7.26.0. Existing code keeps working, with these changes: + +- **PHP 8.1 or later is required.** PHP 7.4 and 8.0 are no longer supported. Projects on those versions should stay on `dropbox/sign:^1.14`, which receives security and bug-fix patches for one year per the [SDK versioning policy](https://developers.hellosign.com/docs/sdks/versioning-policy). +- **Dependencies:** `guzzlehttp/guzzle >= 7.15.2` (also required since 1.14.1). +- **Model `ArrayAccess` methods** (`offsetExists`, `offsetGet`, `offsetUnset`) now declare `mixed $offset`. Existing calls keep working. +- **New, opt-in:** client certificates (mTLS) with `Configuration::setCertFile()` and `Configuration::setKeyFile()`. + ## Migrating from legacy SDK This SDK is generated from our officially maintained [OpenAPI spec](https://github.com/hellosign/hellosign-openapi/blob/main/openapi.yaml). diff --git a/sdks/php/templates/README.mustache b/sdks/php/templates/README.mustache index 7cc3e7607..3f93bc806 100644 --- a/sdks/php/templates/README.mustache +++ b/sdks/php/templates/README.mustache @@ -9,6 +9,15 @@ For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}}). {{/infoUrl}} {{#useCustomTemplateCode}} +## Upgrading to 2.0.0 + +Version 2.0.0 is generated with OpenAPI Generator 7.26.0. Existing code keeps working, with these changes: + +- **PHP 8.1 or later is required.** PHP 7.4 and 8.0 are no longer supported. Projects on those versions should stay on `dropbox/sign:^1.14`, which receives security and bug-fix patches for one year per the [SDK versioning policy](https://developers.hellosign.com/docs/sdks/versioning-policy). +- **Dependencies:** `guzzlehttp/guzzle >= 7.15.2` (also required since 1.14.1). +- **Model `ArrayAccess` methods** (`offsetExists`, `offsetGet`, `offsetUnset`) now declare `mixed $offset`. Existing calls keep working. +- **New, opt-in:** client certificates (mTLS) with `Configuration::setCertFile()` and `Configuration::setKeyFile()`. + ## Migrating from legacy SDK This SDK is generated from our officially maintained [OpenAPI spec](https://github.com/hellosign/hellosign-openapi/blob/main/openapi.yaml).