Skip to content

Conversation

@hubipe
Copy link
Contributor

@hubipe hubipe commented Oct 31, 2025

Q A
Bug fix? yes
New feature? no
BC breaks? no
Deprecations? no
Related tickets no
Documentation no
License MIT

What's in this PR?

This PR improves the version 1.2.1 to be compatible with PHP 8.4.

Why?

Microsoft library for communicating with their Graph API (that is a whole MS ecosystem) in PHP relies on this library with version 1.2. Update to 1.3 is not possible as it is built on the generic annotations, which was introduced in the 1.2 version and reverted in the 1.3 version. The potential upgrade to 1.3 version would break the whole library API (the static analysis would not know the actual return types of the promises and therefore the programmer's IDEs would be lost as well).
As this prevents many people of upgrading to PHP 8.4, the easiest solution to this problem is to create new version 1.2.2 compatible with PHP 8.4 (and no other change). All other solutions are just a no-go for one reason or another – for more context and reasoning, please read this PR microsoft/kiota-php#53.

Only for context - the library we're talking about is microsoft/microsoft-graph. It relies on the microsoft/microsoft-graph-core, which relies through the many packages on microsoft/kiota-abstractions, which is built around http/promise 1.2.* with abstractions.

Checklist

  • Updated CHANGELOG.md to describe BC breaks / deprecations | new feature | bugfix
  • Documentation pull request created (if not simply a bugfix)

@xabbuh
Copy link
Member

xabbuh commented Oct 31, 2025

@dbu @joelwurtz @sagikazarmark @Nyholm What do you think about this? From my POV it’s fine to do this as it requires little effort on our side but seems to have quite some positive impact for the community. We would have to create a branch based on the 1.2.1 tag that this CI PR needs to target then though.

@dbu
Copy link
Contributor

dbu commented Nov 8, 2025

i agree. i created the 1.2.x branch in this repository. @hubipe can you retarget the 1.2.x branch for these changes please?

@dbu dbu changed the base branch from 1.x to 1.2.x November 8, 2025 15:12
@dbu
Copy link
Contributor

dbu commented Nov 8, 2025

ah , i realized that i can change the target myself. will merge and tag a release

@dbu dbu merged commit 0128021 into php-http:1.2.x Nov 8, 2025
1 check passed
@dbu
Copy link
Contributor

dbu commented Nov 8, 2025

i tagged 1.2.2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants