[ANNOUNCEMENT] PHP_CodeSniffer-3.1.0 (stable) Released.

The new PEAR package PHP_CodeSniffer-3.1.0 (stable) has been released at http://pear.php.net/. Release notes ------------- - This release includes a change to support newer versions of PHPUnit (versions 4, 5, and 6 are now supported) -- The custom PHP_CodeSniffer test runner now requires a bootstrap file -- Developers with custom standards using the PHP_CodeSniffer test runner will need to do one of the following: --- run your unit tests from the PHP_CodeSniffer root dir so the bootstrap file is included --- specify the PHP_CodeSniffer bootstrap file on the command line: phpunit --bootstrap=/path/to/phpcs/tests/bootstrap.php --- require the PHP_CodeSniffer bootstrap file from your own bootstrap file -- If you don't run PHP_CodeSniffer unit tests, this change will not affect you -- Thanks to Juliette Reinders Folmer for the patch - A phpcs.xml or phpcs.xml.dist file now takes precedence over the default_standard config setting -- Thanks to Björn Fischer for the patch - Both phpcs.xml and phpcs.xml.dist files can now be prefixed with a dot (request #1566) -- The order that the files are searched is: .phpcs.xml, .phpcs.xml.dist, phpcs.xml, phpcs.xml.dist - The autoloader will now search for files during unit tests runs from the same locations as during normal phpcs runs -- Allows for easier unit testing of custom standards that use helper classes or custom namespaces - Include patterns for sniffs now use OR logic instead of AND logic -- Previously, a file had to be in each of the include patterns to be processed by a sniff -- Now, a file has to only be in at least one of the patterns -- This change reflects the original intention of the feature - PHPCS will now follow symlinks under the list of checked directories -- This previously only worked if you specified the path to a symlink on the command line - Output from --config-show, --config-set, and --config-delete now includes the path to the loaded config file - PHPCS now cleanly exits if its config file is not readable -- Previously, a combination of PHP notices and PHPCS errors would be generated - Comment tokens that start with /** are now always tokenized as docblocks -- Thanks to Michał Bundyra for the patch - The PHP-supplied T_YIELD and T_YIELD_FROM token have been replicated for older PHP versions -- Thanks to Michał Bundyra for the patch - Added new Generic.CodeAnalysis.AssignmentInCondition sniff to warn about variable assignments inside conditions -- Thanks to Juliette Reinders Folmer for the contribution - Added Generic.Files.OneObjectStructurePerFile sniff to ensure there is a single class/interface/trait per file -- Thanks to Mponos George for the contribution - Function call sniffs now check variable function names and self/static object creation -- Specific sniffs are Generic.Functions.FunctionCallArgumentSpacing, PEAR.Functions.FunctionCallSignature, and PSR2.Methods.FunctionCallSignature -- Thanks to Michał Bundyra for the patch - Generic.Files.LineLength can now be configured to ignore all comment lines, no matter their length -- Set the ignoreComments property to TRUE (default is FALSE) in your ruleset.xml file to enable this -- Thanks to Juliette Reinders Folmer for the patch - Generic.PHP.LowerCaseKeyword now checks self, parent, yield, yield from, and closure (function) keywords -- Thanks to Michał Bundyra for the patch - PEAR.Functions.FunctionDeclaration now removes a blank line if it creates one by moving the curly brace during fixing - Squiz.Commenting.FunctionCommentThrowTag now supports PHP 7.1 multi catch exceptions - Squiz.Formatting.OperatorBracket no longer throws errors for PHP 7.1 multi catch exceptions - Squiz.Commenting.LongConditionClosingComment now supports finally statements - Squiz.Formatting.OperatorBracket now correctly fixes pipe separated flags - Squiz.Formatting.OperatorBracket now correctly fixes statements containing short array syntax - Squiz.PHP.EmbeddedPhp now properly fixes cases where the only content in an embedded PHP block is a comment -- Thanks to Juliette Reinders Folmer for the patch - Squiz.WhiteSpace.ControlStructureSpacing now ignores comments when checking blank lines at the top of control structures - Squiz.WhiteSpace.ObjectOperatorSpacing now detects and fixes spaces around double colons -- Thanks to Julius Šmatavičius for the patch - Squiz.WhiteSpace.MemberVarSpacing can now be configured to check any number of blank lines between member vars -- Set the spacing property (default is 1) in your ruleset.xml file to set the spacing - Squiz.WhiteSpace.MemberVarSpacing can now be configured to check a different number of blank lines before the first member var -- Set the spacingBeforeFirst property (default is 1) in your ruleset.xml file to set the spacing - Added a new PHP_CodeSniffer\Util\Tokens::$ooScopeTokens static member var for quickly checking object scope -- Includes T_CLASS, T_ANON_CLASS, T_INTERFACE, and T_TRAIT -- Thanks to Juliette Reinders Folmer for the patch - PHP_CodeSniffer\Files\File::findExtendedClassName() now supports extended interfaces -- Thanks to Martin Hujer for the patch - Fixed bug #1550 : Squiz.Commenting.FunctionComment false positive when function contains closure - Fixed bug #1577 : Generic.InlineControlStructureSniff breaks with a comment between body and condition in do while loops - Fixed bug #1581 : Sniffs not loaded when one-standard directories are being registered in installed_paths - Fixed bug #1591 : Autoloader failing to load arbitrary files when installed_paths only set via a custom ruleset - Fixed bug #1605 : Squiz.WhiteSpace.OperatorSpacing false positive on unary minus after comment -- Thanks to Juliette Reinders Folmer for the patch - Fixed bug #1615 : Uncaught RuntimeException when phpcbf fails to fix files - Fixed bug #1637 : Generic.WhiteSpaceScopeIndent closure argument indenting incorrect with multi-line strings - Fixed bug #1638 : Squiz.WhiteSpace.ScopeClosingBrace closure argument indenting incorrect with multi-line strings - Fixed bug #1640 : Squiz.Strings.DoubleQuoteUsage replaces tabs with spaces when fixing -- Thanks to Juliette Reinders Folmer for the patch Package Info ------------ PHP_CodeSniffer is a set of two PHP scripts; the main phpcs script that tokenizes PHP, JavaScript and CSS files to detect violations of a defined coding standard, and a second phpcbf script to automatically correct coding standard violations. PHP_CodeSniffer is an essential development tool that ensures your code remains clean and consistent. Related Links ------------- Package home: http://pear.php.net/package/PHP_CodeSniffer Changelog: http://pear.php.net/package/PHP_CodeSniffer/download/3.1.0 Download: http://download.pear.php.net/package/PHP_CodeSniffer-3.1.0.tgz Authors ------- Greg Sherwood (lead)