[v6] Bump PHP deps to 8.1 (or 8.2?)

[DerManoMann]

Just a place holder and reminder.

Affected user (going to PHP 8.1):
v5 -> v6 : 1.7%
v4 -> v6 : 5.8%

Affected user (going to PHP 8.2):
v5 -> v6 : 6.8%
v4 -> v6 : 18.6%

---

• Bump deps to PHP 8.1
• Refactor Util class into one/more non-static classes
  • FinderFactory ::finder()
  • Encoder refEncode(), refDecode()
  • Merge shorten() into a new/simpler logger?
• [v6?] add phpdoc parser #1678
• Split logging and error handling #1162
• remove Generator::getDefaultConfig()
• remove other deprecated elements
• deprecate Generator::scan method

[fulldecent]

I think this can safely be done in v5 since 8.0 and lower is already deprecated

[DerManoMann]

It is, but we are taking things slowly. PHP 7.4 -> PHP 8.0 is still used by ~8% of users of v4.

I would think v6 with min PHP 8.1 will be coming around the middle of 2025.

[DerManoMann]

Having second thoughts about perhaps going to PHP 8.2 directly after all. The latest stats show a lot less impact and seeing that PHP 8.5 will be out soon it feels reasonable.

The types refactor will still land on [v5], so I would think that is going to be the only big change in the near future....

Thoughts?

[DjordyKoert]

Having second thoughts about perhaps going to PHP 8.2 directly after all. The latest stats show a lot less impact and seeing that PHP 8.5 will be out soon it feels reasonable.

Maybe you can consider if are you planning on using specific features released in PHP 8.2? That could maybe help make a decision on which version you want.

Back when I was working on version 5 of https://github.com/nelmio/NelmioApiDocBundle I decided to go for 8.1 as my minimum because of the new features that I wanted to use:

• nested attributes (to allow getting rid of https://github.com/doctrine/annotations)
• enums

PHP 8.2 didn't really bring me any features or direct bug fixes that I would want/need to use, so in my opinion it would have brought more harm than good (by making it easier for users to upgrade).

❤️