3.9.2 - 2024-04-24

Changed

• The Generic.ControlStructures.DisallowYodaConditions sniff no longer listens for the null coalesce operator. #458
  • Thanks to Rodrigo Primo for the patch.
• Various housekeeping, including improvements to the tests and documentation.
  • Thanks to Dan Wallis, Rodrigo Primo and Juliette Reinders Folmer for their contributions.

Fixed

• Fixed bug #381 : Squiz.Commenting.ClosingDeclarationComment could throw the wrong error when the close brace being examined is at the very end of a file.
  • Thanks to Rodrigo Primo for the patch.
• Fixed bug #385 : Generic.CodeAnalysis.JumbledIncrementer improved handling of parse errors/live coding.
  • Thanks to Rodrigo Primo for the patch.
• Fixed bug #394 : Generic.Functions.CallTimePassByReference was not flagging call-time pass-by-reference in anonymous class instantiations
  • Thanks to Rodrigo Primo for the patch.
• Fixed bug #420 : PEAR.Functions.FunctionDeclaration could run into a blocking PHP notice while fixing code containing a parse error.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #421 : File::getMethodProperties() small performance improvement & more defensive coding.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #423 : PEAR.WhiteSpace.ScopeClosingBrace would have a fixer conflict with itself when a close tag was preceded by non-empty inline HTML.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #424 : PSR2.Classes.ClassDeclaration using namespace relative interface names in the extends/implements part of a class declaration would lead to a fixer conflict.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #427 : Squiz.Operators.OperatorSpacing would have a fixer conflict with itself when an operator was preceeded by a new line and the previous line ended in a comment.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #430 : Squiz.ControlStructures.ForLoopDeclaration: fixed potential undefined array index notice
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #431 : PSR2.Classes.ClassDeclaration will no longer try to auto-fix multi-line interface implements statements if these are interlaced with comments on their own line. This prevents a potential fixer conflict.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #453 : Arrow function tokenization was broken when the return type was a stand-alone true or false; or contained true or false as part of a union type.
  • Thanks to Juliette Reinders Folmer for the patch

Other

• ESLint 9.0 has been released and changes the supported configuration file format.
  The (deprecated) Generic.Debug.ESLint sniff only supports the "old" configuration file formats and when using the sniff to run ESLint, the ESLINT_USE_FLAT_CONFIG=false environment variable will need to be set when using ESLint >= 9.0.
  For more information, see #436.

---

Statistics

Closed: 0 issues
Merged: 22 pull requests

If you like to stay informed about releases and more, follow @phpcs on Mastodon or @PHP_CodeSniffer on X.

If you like what you see, please consider funding the PHP_CodeSniffer project. If you already do so: thank you!

3.9.1 - 2024-03-31

Added

• Documentation for the following sniffs:
  • Generic.PHP.RequireStrictTypes
  • Squiz.WhiteSpace.MemberVarSpacing
  • Squiz.WhiteSpace.ScopeClosingBrace
  • Squiz.WhiteSpace.SuperfluousWhitespace
  • Thanks to Jay McPartland and Rodrigo Primo for the patches.

Changed

• The following sniffs have received performance related improvements:
  • Generic.CodeAnalysis.UselessOverridingMethod
  • Generic.Files.ByteOrderMark
  • Thanks to Rodrigo Primo for the patches.
• Performance improvement for the "Diff" report. Should be most notable for Windows users. #355
  • Thanks to Juliette Reinders Folmer for the patch.
• The test suite has received some performance improvements. Should be most notable for contributors using Windows. #351
  • External standards with sniff tests using the PHP_CodeSniffer native test framework will also benefit from these changes.
  • Thanks to Juliette Reinders Folmer for the patch.
• Various housekeeping, including improvements to the tests and documentation.
  • Thanks to Jay McPartland, João Pedro Oliveira, Rodrigo Primo and Juliette Reinders Folmer for their contributions.

Fixed

• Fixed bug #289 : Squiz.WhiteSpace.OperatorSpacing and PSR12.Operators.OperatorSpacing : improved fixer conflict protection by more strenuously avoiding handling operators in declare statements.
  • Thanks to Dan Wallis for the patch.
• Fixed bug #366 : Generic.CodeAnalysis.UselessOverridingMethod : prevent false negative when the declared method name and the called method name do not use the same case.
  • Thanks to Rodrigo Primo for the patch.
• Fixed bug #368 : Squiz.Arrays.ArrayDeclaration fixer did not handle static closures correctly when moving array items to their own line.
  • Thanks to Michał Bundyra for the patch.
• Fixed bug #404 : Test framework : fixed PHP 8.4 deprecation notice.
  • Thanks to Juliette Reinders Folmer for the patch

---

New Contributors

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

Statistics

Closed: 2 issues
Merged: 52 pull requests

If you like to stay informed about releases and more, follow @phpcs on Mastodon or @PHP_CodeSniffer on X.

3.9.0 - 2024-02-16

Added

• Tokenizer support for PHP 8.3 typed class constants. #321
  • Additionally, the following sniffs have been updated to support typed class constants:
    • Generic.NamingConventions.UpperCaseConstantName #332
    • Generic.PHP.LowerCaseConstant #330
    • Generic.PHP.LowerCaseType #331
  • Thanks to Juliette Reinders Folmer for the patches
• Tokenizer support for PHP 8.3 readonly anonymous classes. #309
  • Additionally, the following sniffs have been updated to support readonly anonymous classes:
    • PSR12.Classes.ClassInstantiation #324
  • Thanks to Juliette Reinders Folmer for the patches
• New PHP_CodeSniffer\Sniffs\DeprecatedSniff interface to allow for marking a sniff as deprecated. #281
  • If a ruleset uses deprecated sniffs, deprecation notices will be shown to the end-user before the scan starts.
    When running in -q (quiet) mode, the deprecation notices will be hidden.
  • Deprecated sniffs will still run and using them will have no impact on the exit code for a scan.
  • In ruleset "explain"-mode (-e) an asterix * will show next to deprecated sniffs.
  • Sniff maintainers are advised to read through the PR description for full details on how to use this feature for their own (deprecated) sniffs.
  • Thanks to Juliette Reinders Folmer for the patch
• New Generic.CodeAnalysis.RequireExplicitBooleanOperatorPrecedence sniff. #197
  • Forbid mixing different binary boolean operators within a single expression without making precedence clear using parentheses
  • Thanks to Tim Düsterhus for the contribution
• Squiz.PHP.EmbeddedPhp : the sniff will now also examine the formatting of embedded PHP statements using short open echo tags. #27
  • Includes a new ShortOpenEchoNoSemicolon errorcode to allow for selectively ignoring missing semicolons in single line embedded PHP snippets within short open echo tags.
  • The other error codes are the same and do not distinguish between what type of open tag was used.
  • Thanks to Juliette Reinders Folmer for the patch
• Documentation for the following sniffs:
  • Generic.WhiteSpace.IncrementDecrementSpacing
  • PSR12.ControlStructures.ControlStructureSpacing
  • PSR12.Files.ImportStatement
  • PSR12.Functions.ReturnTypeDeclaration
  • PSR12.Properties.ConstantVisibility
  • Thanks to Denis Žoljom and Rodrigo Primo for the patches

Changed

• The Performance report can now also be used for a phpcbf run. #308
  • Thanks to Juliette Reinders Folmer for the patch
• Sniff tests which extend the PHPCS native AbstractSniffUnitTest class will now show a (non-build-breaking) warning when test case files contain fixable errors/warnings, but there is no corresponding .fixed file available in the test suite to verify the fixes against. #336
  • The warning is only displayed on PHPUnit 7.3.0 and higher.
  • The warning will be elevated to a test failure in PHPCS 4.0.
  • Thanks to Dan Wallis for the patch
• The following sniffs have received performance related improvements:
  • Squiz.PHP.EmbeddedPhp
  • Thanks to Juliette Reinders Folmer for the patch
• Various housekeeping, including improvements to the tests and documentation
  • Thanks to Dan Wallis, Joachim Noreiko, Remi Collet, Rodrigo Primo and Juliette Reinders Folmer for their contributions

Deprecated

• Support for scanning JavaScript and CSS files. See #2448.
  • This also means that all sniffs which are only aimed at JavaScript or CSS files are now deprecated.
  • The Javascript and CSS Tokenizers, all Javascript and CSS specific sniffs, and support for JS and CSS in select sniffs which support multiple file types, will be removed in version 4.0.0.
• The abstract PHP_CodeSniffer\Filters\ExactMatch::getBlacklist() and PHP_CodeSniffer\Filters\ExactMatch::getWhitelist() methods are deprecated and will be removed in the 4.0 release. See #198.
  • In version 4.0, these methods will be replaced with abstract ExactMatch::getDisallowedFiles() and ExactMatch::getAllowedFiles() methods
  • To make Filters extending ExactMatch cross-version compatible with both PHP_CodeSniffer 3.9.0+ as well as 4.0+, implement the new getDisallowedFiles() and getAllowedFiles() methods.
    • When both the getDisallowedFiles() and getAllowedFiles() methods as well as the getBlacklist() and getWhitelist() are available, the new methods will take precedence over the old methods.
  • Thanks to Juliette Reinders Folmer for the patch
• The MySource standard and all sniffs in it. See #2471.
  • The MySource standard and all sniffs in it will be removed in version 4.0.0.
• The Zend.Debug.CodeAnalyzer sniff. See #277.
  • This sniff will be removed in version 4.0.0.
  • Thanks to Juliette Reinders Folmer for the patch

Fixed

• Fixed bug #127 : Squiz.Commenting.FunctionComment : The MissingParamType error code will now be used instead of MissingParamName when a parameter name is provided, but not its type. Additionally, invalid type hint suggestions will no longer be provided in these cases.
  • Thanks to Dan Wallis for the patch
• Fixed bug #196 : Squiz.PHP.EmbeddedPhp : fixer will no longer leave behind trailing whitespace when moving code to another line.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #196 : Squiz.PHP.EmbeddedPhp : will now determine the needed indent with higher precision in multiple situations.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #196 : Squiz.PHP.EmbeddedPhp : fixer will no longer insert a stray new line when the closer of a multi-line embedded PHP block and the opener of the next multi-line embedded PHP block would be on the same line.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #235 : Generic.CodeAnalysis.ForLoopWithTestFunctionCall : prevent a potential PHP 8.3 deprecation notice during live coding
  • Thanks to Rodrigo Primo for the patch
• Fixed bug #288 : Generic.WhiteSpace.IncrementDecrementSpacing : error message for post-in/decrement will now correctly inform about new lines found before the operator.
  • Thanks to Rodrigo Primo for the patch
• Fixed bug #296 : Generic.WhiteSpace.ArbitraryParenthesesSpacing : false positive for non-arbitrary parentheses when these follow the scope closer of a switch case.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #307 : PSR2.Classes.ClassDeclaration : space between a modifier keyword and the class keyword was not checked when the space included a new line or comment.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #325 : Squiz.Operators.IncrementDecrementUsage : the sniff was underreporting when there was (no) whitespace and/or comments in unexpected places.
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #335 : PSR12.Files.DeclareStatement : bow out in a certain parse error situation to prevent incorrect auto-fixes from being made.
  • Thanks to Dan Wallis for the patch
• Fixed bug #340 : Squiz.Commenting.ClosingDeclarationComment : no longer adds a stray newline when adding a missing comment.
  • Thanks to Dan Wallis for the patch

Other

• A "Community cc list" has been introduced to ping maintainers of external standards and integrators for input regarding change proposals for PHP_CodeSniffer which may impact them. #227
  • For anyone who missed the discussion about this and is interested to be on this list, please feel invited to submit a PR to add yourself.
    The list is located in the .github folder.

---

New Contributors

The PHP_CodeSniffer project is happy to welcome the following new contributors:
@joachim-n, @remicollet, @TimWolla

Statistics

Closed: 8 issues
Merged: 77 pull requests

💸 If you like what you see, please consider funding the PHP_CodeSniffer project. If you already do so: thank you!

3.8.1 - 2024-01-11

Added

• Documentation has been added for the following sniffs:
  • Generic.CodeAnalysis.EmptyPHPStatement
  • Generic.Formatting.SpaceBeforeCast
  • Generic.PHP.Syntax
  • Generic.WhiteSpace.LanguageConstructSpacing
  • PSR12.Classes.ClosingBrace
  • PSR12.Classes.OpeningBraceSpace
  • PSR12.ControlStructures.BooleanOperatorPlacement
  • PSR12.Files.OpenTag
  • Thanks to Rodrigo Primo and Denis Žoljom for the patches

Changed

• GitHub releases will now always only contain unversioned versions of the release assets (PHARS + asc files). See #205 for context.
  • Thanks to Shivam Mathur for opening a discussion about this
• Various housekeeping, includes improvements to the tests and documentation
  • Thanks to Dan Wallis, Lucas Hoffmann, Rodrigo Primo and Juliette Reinders Folmer for their contributions

Fixed

• Fixed bug #124 : Report Full : avoid unnecessarily wrapping lines when -s is used
  • Thanks to Brad Jorsch for the patch
• Fixed bug #124 : Report Full : fix incorrect bolding of pipes when -s is used and messages wraps
  • Thanks to Brad Jorsch for the patch
• Fixed bug #150 : Squiz.WhiteSpace.KeywordSpacing : prevent a PHP notice when run during live coding
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #154 : Report Full : delimiter line calculation could go wonky on wide screens when a report contains multi-line messages
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #178 : Squiz.Commenting.VariableComment : docblocks were incorrectly being flagged as missing when a property declaration used PHP native union/intersection type declarations
  • Thanks to Ferdinand Kuhl for the patch
• Fixed bug #211 : Squiz.Commenting.VariableComment : docblocks were incorrectly being flagged as missing when a property declaration used PHP 8.2+ stand-alone true/false/null type declarations
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #211 : Squiz.Commenting.VariableComment : docblocks were incorrectly being flagged as missing when a property declaration used PHP native parent, self or a namespace relative class name type declaration
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #226 : Generic.CodeAnalysis.ForLoopShouldBeWhileLoop : prevent a potential PHP 8.3 deprecation notice during live coding
  • Thanks to Rodrigo Primo for the patch

---

New Contributors

The PHP_CodeSniffer project is happy to welcome the following new contributors:
@anomiex, @dingo-d, @fcool, @lucc, @rodrigoprimo

Statistics

Closed: 4 issues
Merged: 63 pull requests

If you like what you see, please consider funding the PHP_CodeSniffer project. If you already do so: thank you!

3.8.0 - 2023-12-08

Squizlabs/PHP_CodeSniffer is dead. Long live PHPCSStandards/PHP_CodeSniffer!

Breaking Changes

• The squizlabs/PHP_CodeSniffer repository has been abandoned. The PHPCSStandards/PHP_CodeSniffer repository will serve as the continuation of the project. For more information about this change, please read the announcement.
  • Installation of PHP_CodeSniffer via PEAR is no longer supported.
    • Users will need to switch to another installation method.
    • Note: this does not affect the PEAR sniffs.
  • For Composer users, nothing changes.
    • In contrast to earlier information, the squizlabs/php_codesniffer package now points to the new repository and everything will continue to work as before.
  • PHIVE users may need to clear the PHIVE URL cache.
    • PHIVE users who don't use the package alias, but refer to the package URL, will need to update the URL from https://squizlabs.github.io/PHP_CodeSniffer/phars/ to https://phars.phpcodesniffer.com/phars/.
  • Users who download the PHAR files using curl or wget, will need to update the download URL from https://squizlabs.github.io/PHP_CodeSniffer/[phpcs|phpcbf].phar or https://github.com/squizlabs/PHP_CodeSnifffer/releases/latest/download/[phpcs|phpcbf].phar to https://phars.phpcodesniffer.com/[phpcs|phpcbf].phar.
  • For users who install PHP_CodeSniffer via the setup-php action runner for GitHub Actions, nothing changes.
  • Users using a git clone will need to update the clone address from git@github.com:squizlabs/PHP_CodeSniffer.git to git@github.com:PHPCSStandards/PHP_CodeSniffer.git.
    • Contributors will need to fork the new repo and add both the new fork as well as the new repo as remotes to their local git copy of PHP_CodeSniffer.
    • Users who have (valid) open issues or pull requests in the squizlabs/PHP_CodeSniffer repository are invited to resubmit these to the PHPCSStandards/PHP_CodeSniffer repository.

Added

• Runtime support for PHP 8.3. All known PHP 8.3 deprecation notices have been fixed
  • Syntax support for new PHP 8.3 features will follow in a future release
  • If you find any PHP 8.3 deprecation notices which were missed, please report them
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patches
• Added support for PHP 8.2 readonly classes to File::getClassProperties() through a new is_readonly array index in the return value
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Added support for PHP 8.2 readonly classes to a number of sniffs
  • Generic.CodeAnalysis.UnnecessaryFinalModifier
  • PEAR.Commenting.ClassComment
  • PEAR.Commenting.FileComment
  • PSR1.Files.SideEffects
  • PSR2.Classes.ClassDeclaration
  • PSR12.Files.FileHeader
  • Squiz.Classes.ClassDeclaration
  • Squiz.Classes.LowercaseClassKeywords
  • Squiz.Commenting.ClassComment
  • Squiz.Commenting.DocCommentAlignment
  • Squiz.Commenting.FileComment
  • Squiz.Commenting.InlineComment
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Added support for PHP 8.2 true as a stand-alone type declaration
  • The File::getMethodProperties(), File::getMethodParameters() and File::getMemberProperties() methods now all support the true type
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Added support for PHP 8.2 true as a stand-alone type to a number of sniffs
  • Generic.PHP.LowerCaseType
  • PSr12.Functions.NullableTypeDeclaration
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Added a Performance report to allow for finding "slow" sniffs
  • To run this report, run PHPCS with --report=Performance.
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.PHP.RequireStrictTypes : new warning for when there is a declare statement, but the strict_types directive is set to 0
  • The warning can be turned off by excluding the Generic.PHP.RequireStrictTypes.Disabled error code
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Squiz.Commenting.FunctionComment : new ParamNameUnexpectedAmpersandPrefix error for parameters annotated as passed by reference while the parameter is not passed by reference
  • Thanks to Dan Wallis (@fredden) for the patch
• Documentation has been added for the following sniffs:
  • PSR2.Files.ClosingTag
  • PSR2.Methods.FunctionCallSignature
  • PSR2.Methods.FunctionClosingBrace
  • Thanks to Atsushi Okui (@blue32a) for the patch
• Support for PHPUnit 8 and 9 to the test suite
  • Test suites for external standards which run via the PHPCS native test suite can now run on PHPUnit 4-9 (was 4-7)
  • If any of these tests use the PHPUnit setUp()/tearDown() methods or overload the setUp() in the AbstractSniffUnitTest test case, they will need to be adjusted. See the PR details for further information
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch

Changed

• Changes have been made to the way PHPCS handles invalid sniff properties being set in a custom ruleset
  • Fixes PHP 8.2 deprecation notices for properties set in a (custom) ruleset for complete standards/complete sniff categories
  • Invalid sniff properties set for individual sniffs will now result in an error and halt the execution of PHPCS
    • A descriptive error message is provided to allow users to fix their ruleset
  • Sniff properties set for complete standards/complete sniff categories will now only be set on sniffs which explicitly support the property
    • The property will be silently ignored for those sniffs which do not support the property
  • Invalid sniff properties set for sniffs via inline annotations will result in an informative Internal.PropertyDoesNotExist errror on line 1 of the scanned file, but will not halt the execution of PHPCS
  • For sniff developers, it is strongly recommended for sniffs to explicitly declare any user-adjustable public properties
    • If dynamic properties need to be supported for a sniff, either declare the magic __set()/__get()/__isset()/__unset() methods on the sniff or let the sniff extend stdClass
    • Note: The #[\AllowDynamicProperties] attribute will have no effect for properties which are being set in rulesets
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• The third parameter for the Ruleset::setSniffProperty() method has been changed to expect an array
  • Sniff developers/integrators of PHPCS may need to make some small adjustments to allow for this change
  • Existing code will continue to work but will throw a deprecation error
  • The backwards compatiblity layer will be removed in PHPCS 4.0
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• When using auto report width (the default) a value of 80 columns will be used if the width cannot be determined
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Sniff error messages are now more informative to help bugs get reported to the correct project
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.CodeAnalysis.UnusedFunctionParameter will now ignore magic methods for which the signature is defined by PHP
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.Functions.OpeningFunctionBraceBsdAllman will now check the brace indent before the opening brace for empty functions
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.Functions.OpeningFunctionBraceKernighanRitchie will now check the spacing before the opening brace for empty functions
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.WhiteSpace.IncrementDecrementSpacing now detects more spacing issues
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• PSR2.Classes.PropertyDeclaration now enforces that the readonly modifier comes after the visibility modifier
  • PSR2 and PSR12 do not have documented rules for this as they pre-date the readonly modifier
  • PSR-PER has been used to confirm the order of this keyword so it can be applied to PSR2 and PSR12 correctly
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• PEAR.Commenting.FunctionComment + Squiz.Commenting.FunctionComment: the SpacingAfter error can now be auto-fixed
  • Thanks to Dan Wallis (@fredden) for the patch
• Squiz.PHP.InnerFunctions sniff no longer reports on OO methods for OO structures declared within a function or closure
  • Thanks to @Daimona for the patch
• Squiz.PHP.NonExecutableCode will now also flag redundant return statements just before a closure close brace
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Runtime performance improvement for PHPCS CLI users. The improvement should be most noticeable for users on Windows.
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• The following sniffs have received performance related improvements:
  • Generic.PHP.LowerCaseConstant
  • Generic.PHP.LowerCaseType
  • PSR12.Files.OpenTag
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patches
• The -e (explain) command will now list sniffs in natural order
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Tests using the PHPCS native test framework with multiple test case files will now run the test case files in numeric order.
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• The following sniffs have received minor message readability improvements:
  • Generic.Arrays.ArrayIndent...

3.7.2 - 2023-02-23

• Newer versions of Composer will now suggest installing PHPCS using require-dev instead of require
  • Thanks to Gary Jones (@GaryJones) for the patch
• A custom Out Of Memory error will now be shown if PHPCS or PHPCBF run out of memory during a run
  • Error message provides actionable information about how to fix the problem and ensures the error is not silent
  • Thanks to Juliette Reinders Folmer (@jrfnl) and Alain Schlesser (@schlessera) for the patch
• Generic.PHP.LowerCaseType sniff now correctly examines types inside arrow functions
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Squiz.Formatting.OperatorBracket no longer reports false positives in match() structures
• Fixed bug #3616 : Squiz.PHP.DisallowComparisonAssignment false positive for PHP 8 match expression
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3618 : Generic.WhiteSpace.ArbitraryParenthesesSpacing false positive for return new parent()
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3632 : Short list not tokenized correctly in control structures without braces
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3639 : Tokenizer not applying tab replacement to heredoc/nowdoc closers
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3640 : Generic.WhiteSpace.DisallowTabIndent not reporting errors for PHP 7.3 flexible heredoc/nowdoc syntax
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3645 : PHPCS can show 0 exit code when running in parallel even if child process has fatal error
  • Thanks to Alex Panshin (@enl) for the patch
• Fixed bug #3653 : False positives for match() in OperatorSpacingSniff
  • Thanks to Jaroslav Hanslík (@kukulich) for the patch
• Fixed bug #3666 : PEAR.Functions.FunctionCallSignature incorrect indent fix when checking mixed HTML/PHP files
• Fixed bug #3668 : PSR12.Classes.ClassInstantiation.MissingParentheses false positive when instantiating parent classes
  • Similar issues also fixed in Generic.Functions.FunctionCallArgumentSpacing and Squiz.Formatting.OperatorBracket
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3672 : Incorrect ScopeIndent.IncorrectExact report for match inside array literal
• Fixed bug #3694 : Generic.WhiteSpace.SpreadOperatorSpacingAfter does not ignore spread operator in PHP 8.1 first class callables
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch

3.7.1 - 2022-06-18

• Fixed bug #3609: Methods/constants with name empty/isset/unset are always reported as error
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch

3.7.0 - 2022-06-13

PHP 8.1 Language Feature Support

PHP_CodeSniffer has run correctly under PHP 8.1 since PHP 8 support was added, but it has not supported new 8.1 language features until this release. Version 3.7.0 adds support for the following PHP 8.1 language features:

• Enums
• Explicit octal notation
• Readonly properties
• Intersection types
• The never type

Note: Standards and sniffs included with PHP_CodeSniffer have been updated to support these language features, but external standards and sniffs may need updating before they are able to detect them correctly.

Changelog

• Added support for PHP 8.1 explicit octal notation
  • This new syntax has been backfilled for PHP versions less than 8.1
  • Thanks to Mark Baker (@MarkBaker) for the patch
  • Thanks to Juliette Reinders Folmer (@jrfnl) for additional fixes
• Added support for PHP 8.1 enums
  • This new syntax has been backfilled for PHP versions less than 8.1
  • Includes a new T_ENUM_CASE token to represent the case statements inside an enum
  • Thanks to Jaroslav Hanslík (@kukulich) for the patch
  • Thanks to Juliette Reinders Folmer (@jrfnl) for additional core and sniff support
• Added support for the PHP 8.1 readonly token
  • Tokenzing of the readonly keyword has been backfilled for PHP versions less than 8.1
  • Thanks to Jaroslav Hanslík (@kukulich) for the patch
• Added support for PHP 8.1 intersection types
  • Includes a new T_TYPE_INTERSECTION token to represent the ampersand character inside intersection types
  • Thanks to Jaroslav Hanslík (@kukulich) for the patch
• File::getMethodParameters now supports the new PHP 8.1 readonly token
  • When constructor property promotion is used, a new property_readonly array index is included in the return value
    • This is a boolean value indicating if the property is readonly
  • If the readonly token is detected, a new readonly_token array index is included in the return value
    • This contains the token index of the readonly keyword
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Support for new PHP 8.1 readonly keyword has been added to the following sniffs:
  • Generic.PHP.LowerCaseKeyword
  • PSR2.Classes.PropertyDeclaration
  • Squiz.Commenting.BlockComment
  • Squiz.Commenting.DocCommentAlignment
  • Squiz.Commenting.VariableComment
  • Squiz.WhiteSpace.ScopeKeywordSpacing
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patches
• The parallel feature is now more efficient and runs faster in some situations due to improved process management
  • Thanks to Sergei Morozov (@morozov) for the patch
• The list of installed coding standards now has consistent ordering across all platforms
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.PHP.UpperCaseConstant and Generic.PHP.LowerCaseConstant now ignore type declarations
  • These sniffs now only report errors for true/false/null when used as values
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Generic.PHP.LowerCaseType now supports the PHP 8.1 never type
  • Thanks to Jaroslav Hanslík (@kukulich) for the patch
• Fixed bug #3502 : A match statement within an array produces Squiz.Arrays.ArrayDeclaration.NoKeySpecified
• Fixed bug #3503 : Squiz.Commenting.FunctionComment.ThrowsNoFullStop false positive when one line @throw
• Fixed bug #3505 : The nullsafe operator is not counted in Generic.Metrics.CyclomaticComplexity
  • Thanks to Mark Baker (@MarkBaker) for the patch
• Fixed bug #3526 : PSR12.Properties.ConstantVisibility false positive when using public final const syntax
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3530 : Line indented incorrectly false positive when using match-expression inside switch case
• Fixed bug #3534 : Name of typed enum tokenized as T_GOTO_LABEL
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3546 : Tokenizer/PHP: bug fix - parent/static keywords in class instantiations
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3550 : False positive from PSR2.ControlStructures.SwitchDeclaration.TerminatingComment when using trailing comment
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3575: Squiz.Scope.MethodScope misses visibility keyword on previous line
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3604: Tokenizer/PHP: bug fix for double quoted strings using ${
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch

3.6.2 - 2021-12-12

• Processing large code bases that use tab indenting inside comments and strings will now be faster
  • Thanks to Thiemo Kreuz (@thiemowmde) for the patch
• Fixed bug #3388 : phpcs does not work when run from WSL drives
  • Thanks to Juliette Reinders Folmer (@jrfnl) and Graham Wharton (@gwharton) for the patch
• Fixed bug #3422 : Squiz.WhiteSpace.ScopeClosingBrace fixer removes HTML content when fixing closing brace alignment
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3437 : PSR12 does not forbid blank lines at the start of the class body
  • Added new PSR12.Classes.OpeningBraceSpace sniff to enforce this
• Fixed bug #3440 : Squiz.WhiteSpace.MemberVarSpacing false positives when attributes used without docblock
  • Thanks to Vadim Borodavko (@javer) for the patch
• Fixed bug #3448 : PHP 8.1 deprecation notice while generating running time value
  • Thanks to Juliette Reinders Folmer (@jrfnl) and Andy Postnikov (@andypost) for the patch
• Fixed bug #3456 : PSR12.Classes.ClassInstantiation.MissingParentheses false positive using attributes on anonymous class
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3460 : Generic.Formatting.MultipleStatementAlignment false positive on closure with parameters
  • Thanks to Juliette Reinders Folmer (@jrfnl) for the patch
• Fixed bug #3468 : do/while loops are double-counted in Generic.Metrics.CyclomaticComplexity
  • Thanks to Mark Baker (@MarkBaker) for the patch
• Fixed bug #3469 : Ternary Operator and Null Coalescing Operator are not counted in Generic.Metrics.CyclomaticComplexity
  • Thanks to Mark Baker (@MarkBaker) for the patch
• Fixed bug #3472 : PHP 8 match() expression is not counted in Generic.Metrics.CyclomaticComplexity
  • Thanks to Mark Baker (@MarkBaker) for the patch

3.6.1 - 2021-10-11

• PHPCS annotations can now be specified using hash-style comments
  • Previously, only slash-style and block-style comments could be used to do things like disable errors
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed an issue where some sniffs would not run on PHP files that only used the short echo tag
  • The following sniffs were affected:
    • Generic.Files.ExecutableFile
    • Generic.Files.LowercasedFilename
    • Generic.Files.LineEndings
    • Generic.Files.EndFileNewline
    • Generic.Files.EndFileNoNewline
    • Generic.PHP.ClosingPHPTag
    • Generic.PHP.Syntax
    • Generic.VersionControl.GitMergeConflict
    • Generic.WhiteSpace.DisallowSpaceIndent
    • Generic.WhiteSpace.DisallowTabIndent
  • Thanks to Juliette Reinders Folmer for the patch
• The new PHP 8.1 tokenisation for ampersands has been reverted to use the existing PHP_CodeSniffer method
  • The PHP 8.1 tokens T_AMPERSAND_FOLLOWED_BY_VAR_OR_VARARG and T_AMPERSAND_NOT_FOLLOWED_BY_VAR_OR_VARARG are unsued
  • Ampersands continue to be tokenized as T_BITWISE_AND for all PHP versions
  • Thanks to Juliette Reinders Folmer and Anna Filina for the patch
• File::getMethodParameters() no longer incorrectly returns argument attributes in the type hint array index
  • A new has_attributes array index is available and set to TRUE if the argument has attributes defined
  • Thanks to Juliette Reinders Folmer for the patch
• Generic.NamingConventions.ConstructorName no longer throws deprecation notices on PHP 8.1
  • Thanks to Juliette Reinders Folmer for the patch
• Squiz.Commenting.BlockComment now correctly applies rules for block comments after a short echo tag
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed false positives when using attributes in the following sniffs:
  • PEAR.Commenting.FunctionComment
  • Squiz.Commenting.InlineComment
  • Squiz.Commenting.BlockComment
  • Squiz.Commenting.VariableComment
  • Squiz.WhiteSpace.MemberVarSpacing
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3294 : Bug in attribute tokenization when content contains PHP end token or attribute closer on new line
  • Thanks to Alessandro Chitolina for the patch
  • Thanks to Juliette Reinders Folmer for the tests
• Fixed bug #3296 : PSR2.ControlStructures.SwitchDeclaration takes phpcs:ignore as content of case body
• Fixed bug #3297 : PSR2.ControlStructures.SwitchDeclaration.TerminatingComment does not handle try/finally blocks
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3302 : PHP 8.0 | Tokenizer/PHP: bugfix for union types using namespace operator
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3303 : findStartOfStatement() doesn't work with T_OPEN_TAG_WITH_ECHO
• Fixed bug #3316 : Arrow function not tokenized correctly when using null in union type
• Fixed bug #3317 : Problem with how phpcs handles ignored files when running in parallel
  • Thanks to Emil Andersson for the patch
• Fixed bug #3324 : PHPCS hangs processing some nested arrow functions inside a function call
• Fixed bug #3326 : Generic.Formatting.MultipleStatementAlignment error with const DEFAULT
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3333 : Squiz.Objects.ObjectInstantiation: null coalesce operators are not recognized as assignment
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3340 : Ensure interface and trait names are always tokenized as T_STRING
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3342 : PSR12/Squiz/PEAR standards all error on promoted properties with docblocks
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3345 : IF statement with no braces and double catch turned into syntax error by auto-fixer
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3352 : PSR2.ControlStructures.SwitchDeclaration can remove comments on the same line as the case statement while fixing
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3357 : Generic.Functions.OpeningFunctionBraceBsdAllman removes return type when additional lines are present
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3362 : Generic.WhiteSpace.ScopeIndent false positive for arrow functions inside arrays
• Fixed bug #3384 : Squiz.Commenting.FileComment.SpacingAfterComment false positive on empty file
• Fixed bug #3394 : Fix PHP 8.1 auto_detect_line_endings deprecation notice
• Fixed bug #3400 : PHP 8.1: prevent deprecation notices about missing return types
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3424 : PHPCS fails when using PHP 8 Constructor property promotion with attributes
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3425 : PHP 8.1 | Runner::processChildProcs(): fix passing null to non-nullable bug
  • Thanks to Juliette Reinders Folmer for the patch
• Fixed bug #3445 : Nullable parameter after attribute incorrectly tokenized as ternary operator
  • Thanks to Juliette Reinders Folmer for the patch