You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I think we should start preparing for NelmioApiDocBundle v5 and move forward with this bundle.
PHP 8.1+
First of all I would like to remove support for PHP 7. PHP 7 has been EOL for quite some time now (PHP 7.4 active support stopped 2 years ago https://endoflife.date/php) and is currently preventing us from using new PHP 8 features (typed properties, native attributes, property promotion, union types).
Additionally I would like to start using PHP 8.1 as a minimum instead of PHP 8.0 because:
Rewrite every class for constructor property promotion
Add proper types for every class property
Static analysis
PHP 8 is also a perfect time to start using static analysis tools. That's why I would like to introduce (PHPStan) to this project. This would also include some refactoring here and there to remove PHPStan's detected problems.
Symfony version bump to 6.4+ Drop support for Symfony 6.0, 6.1, 6.2 & 6.3
Symfony 6.0, 6.1, 6.2 & 6.3 have already stopped receiving bug fixes & security updates which is why a bump to Symfony 6.4 would be ideal, this version also closely align with our new minimum PHP version support.
Additionaly let's keep supporting Symfony 5.4 for now. Support for it should be dropped in a different minor release. Preferably we wait until after November 2024 (end of bug fixes for Symfony 5.4 https://symfony.com/releases/5.4).
General refactoring
Remove current deprecations
Add proper return types to methods (including void)
It could make upgrading harder, but it could be the opportunity to drop support for annotations. It seems to be that having both attributes & annotations adds a lot of complexity. Especially when the 2 are mixed
I think we should start preparing for NelmioApiDocBundle v5 and move forward with this bundle.
PHP 8.1+
First of all I would like to remove support for PHP 7. PHP 7 has been EOL for quite some time now (PHP 7.4 active support stopped 2 years ago https://endoflife.date/php) and is currently preventing us from using new PHP 8 features (typed properties, native attributes, property promotion, union types).
Additionally I would like to start using PHP 8.1 as a minimum instead of PHP 8.0 because:
new
in initializers https://stitcher.io/blog/new-in-php-81#new-in-initializers-rfcnew
as default parametersNelmioApiDocBundle/ApiDocGenerator.php
Line 69 in daadb0b
readonly
propertiespublic readonly
propertyNelmioApiDocBundle/Model/Model.php
Line 39 in daadb0b
Planned changes:
Static analysis
PHP 8 is also a perfect time to start using static analysis tools. That's why I would like to introduce (PHPStan) to this project. This would also include some refactoring here and there to remove PHPStan's detected problems.
Symfony version bump to 6.4+Drop support for Symfony 6.0, 6.1, 6.2 & 6.3Symfony 6.0, 6.1, 6.2 & 6.3 have already stopped receiving bug fixes & security updates which is why a bump to Symfony 6.4 would be ideal, this version also closely align with our new minimum PHP version support.
Additionaly let's keep supporting Symfony 5.4 for now. Support for it should be dropped in a different minor release. Preferably we wait until after November 2024 (end of bug fixes for Symfony 5.4 https://symfony.com/releases/5.4).
General refactoring
void
)NelmioApiDocBundle/PropertyDescriber/PropertyDescriberInterface.php
Line 25 in daadb0b
final
PropertyDescriberInterface
(prefer class decoration)sensio/framework-extra-bundle
? (unmaintained & all annotations are available from Symfony 6.2 onward)The text was updated successfully, but these errors were encountered: