3.12.2 - 2025-04-13

[jrfnl]

Added

• Added support for PHP 8.4 final properties to the following sniffs:
  • Generic.PHP.LowerCaseConstant PHP 8.4 | Generic/[Lower|Upper]CaseConstant: add support for final properties #948
  • Generic.PHP.UpperCaseConstant PHP 8.4 | Generic/[Lower|Upper]CaseConstant: add support for final properties #948
  • Squiz.Commenting.DocCommentAlignment Squiz/DocCommentAlignment: add support for final classes and final properties #951
  • Squiz.Commenting.VariableComment PHP 8.4 | Squiz/VariableComment: add support for final properties #949
  • Thanks to Juliette Reinders Folmer for the patches.

Changed

• Tokenizer/PHP: a PHP open tag at the very end of a file will now always be tokenized as T_OPEN_TAG, independently of the PHP version. PHP 7.4 | Tokenizer/PHP: handle PHP tag at end of file consistently #937
  • Previously, a PHP open tag at the end of a file was not tokenized as an open tag on PHP < 7.4 and the tokenization would depend on the short_open_tag setting.
  • Thanks to Juliette Reinders Folmer for the patch.
• PEAR.Commenting.FunctionComment: improved message for "blank lines between docblock and declaration" check. PEAR/FunctionComment: bug fix - handling of blank lines in pre-amble #830
• The documentation for the following sniffs has been improved:
  • Generic.Functions.OpeningFunctionBraceBsdAllman
  • Generic.Functions.OpeningFunctionBraceKernighanRitchie
  • Generic.WhiteSpace.LanguageConstructSpacing
  • Thanks to Rodrigo Primo for the patches.
• Various housekeeping, including improvements to the tests and documentation.
  • Thanks to Rodrigo Primo and Juliette Reinders Folmer for their contributions.

Fixed

• Fixed bug PEAR/FunctionComment: bug fix - handling of blank lines in pre-amble #830 : PEAR.Commenting.FunctionComment will no longer remove blank lines within attributes.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Generic/ForbiddenFunctions: improve comment tolerance #929 : Generic.PHP.ForbiddenFunctions: prevent false positives/negatives for code interlaced with comments.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug PHP 8.2 | Generic/[Lower|Upper]CaseConstant: bug fix - ignore DNF property types #934 : Generic.PHP.LowerCaseConstant and Generic.PHP.UpperCaseConstant will now correctly ignore DNF types for properties.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Squiz/FunctionCommentThrowTag: bug fix - jump over attributes #936 : Squiz.Commenting.FunctionCommentThrowTag: sniff would bow out when function has attributes attached, leading to false negatives.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug PHP 8.2 | Squiz/VariableComment: bug fix - allow for DNF typed properties #940 : Squiz.Commenting.VariableComment: false positive for missing docblock for properties using DNF types.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Squiz/FunctionComment: support DNF types #944 : Squiz.Commenting.FunctionComment did not support DNF/intersection types in @param tags.
  • Thanks to Jeffrey Angenent for the patch.
• Fixed bug New warning about function spacing since version 3.12.0 #945 : Squiz.WhiteSpace.FunctionSpacing would get confused when there are two docblocks above a function declaration.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Squiz/FunctionCommentThrowTag: improve comment tolerance #947 : Squiz.Commenting.FunctionCommentThrowTag: prevent false positives/negatives for code interlaced with comments.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Squiz/DocCommentAlignment: add support for final classes and final properties #951 : Squiz.Commenting.DocCommentAlignment did not examine docblocks for final classes.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Report/Code: fix fatal potential fatal error when combined with Diff report #955 : Potential race condition, leading to a fatal error, when both the Diff + the Code reports are requested and caching is on.
  • Thanks to Juliette Reinders Folmer for the patch.
• Fixed bug Generic/ScopeIndent: bug fix for debug mode #956 : Generic.WhiteSpace.ScopeIndent: undefined array index notice when running in debug mode.
  • Thanks to Juliette Reinders Folmer for the patch.

Other

• PHP_CodeSniffer 4.0 is coming soon! Interested in a sneak peek ? Join the live stream at any time on April 14, 15, 17 or 18.
  Read the open invitation (PHPCS 4.0: Open invitation to join live stream April 14, 15, 17 and 18, 2025 #924) for all the details.

---

New Contributors

The PHP_CodeSniffer project is happy to welcome the following new contributors:
@devfrey

Statistics

Closed: 1 issues
Merged: 36 pull requests

Follow @phpcs on Mastodon or @PHP_CodeSniffer on X to stay informed.

Please consider funding the PHP_CodeSniffer project. If you already do so: thank you!

---

This discussion was created from the release 3.12.2 - 2025-04-13.