Version 3.12.2 - 2025-04-13

Added

• Added support for PHP 8.4 final properties to the following sniffs:
  • Generic.PHP.LowerCaseConstant [#948]
  • Generic.PHP.UpperCaseConstant [#948]
  • Squiz.Commenting.DocCommentAlignment [#951]
  • Squiz.Commenting.VariableComment [#949]
  • Thanks to [Juliette Reinders Folmer][@jrfnl] 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. [#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][@jrfnl] for the patch.
• PEAR.Commenting.FunctionComment: improved message for "blank lines between docblock and declaration" check. [#830]
• The documentation for the following sniffs has been improved:
  • Generic.Functions.OpeningFunctionBraceBsdAllman
  • Generic.Functions.OpeningFunctionBraceKernighanRitchie
  • Generic.WhiteSpace.LanguageConstructSpacing
  • Thanks to [Rodrigo Primo][@rodrigoprimo] for the patches.
• Various housekeeping, including improvements to the tests and documentation.
  • Thanks to [Rodrigo Primo][@rodrigoprimo] and [Juliette Reinders Folmer][@jrfnl] for their contributions.

Fixed

• Fixed bug [#830] : PEAR.Commenting.FunctionComment will no longer remove blank lines within attributes.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#929] : Generic.PHP.ForbiddenFunctions: prevent false positives/negatives for code interlaced with comments.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#934] : Generic.PHP.LowerCaseConstant and Generic.PHP.UpperCaseConstant will now correctly ignore DNF types for properties.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#936] : Squiz.Commenting.FunctionCommentThrowTag: sniff would bow out when function has attributes attached, leading to false negatives.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#940] : Squiz.Commenting.VariableComment: false positive for missing docblock for properties using DNF types.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#944] : Squiz.Commenting.FunctionComment did not support DNF/intersection types in @param tags.
  • Thanks to [Jeffrey Angenent][@devfrey] for the patch.
• Fixed bug [#945] : Squiz.WhiteSpace.FunctionSpacing would get confused when there are two docblocks above a function declaration.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#947] : Squiz.Commenting.FunctionCommentThrowTag: prevent false positives/negatives for code interlaced with comments.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#951] : Squiz.Commenting.DocCommentAlignment did not examine docblocks for final classes.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.
• Fixed bug [#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][@jrfnl] for the patch.
• Fixed bug [#956] : Generic.WhiteSpace.ScopeIndent: undefined array index notice when running in debug mode.
  • Thanks to [Juliette Reinders Folmer][@jrfnl] for the patch.