Changed

Other

• Composer: The minimum PHPCSUtils requirement has been updated to 1.2.3 (was 1.2.0). #464
• Various housekeeping. Including a contribution by @rodrigoprimo.

Changed

Other

• Composer: The minimum PHPCSUtils requirement has been updated to 1.2.3 (was 1.2.0). #464
• Various housekeeping. Including a contribution by [@rodrigoprimo].

1.5.1 - 2026-07-27 Latest

Latest

Compare

Choose a tag to compare

Added

Universal

• 🔧 📊 📚 New Universal.Attributes.BracketSpacing sniff to enforce a fixed number of spaces on the inside of attribute block brackets. #386, #406
  The sniff offers the following properties to influence its behaviour:
  • spacing (defaults to 0).
  • ignoreNewlines (defaults to false).
    When new lines are allowed (ignoreNewlines=true) and a new line is found, the sniff will verify that there are no superfluous blank lines at the start/end of an attribute block.
• 🔧 📊 📚 New Universal.Attributes.DisallowAttributeParentheses sniff to forbid parentheses for attribute instantiations without arguments. #387, #409
• 🔧 📊 📚 New Universal.Attributes.RequireAttributeParentheses sniff to demand that all attribute instantiations always use parentheses, even if no argument is passed. #387, #410
• 🔧 📊 📚 New Universal.Attributes.TrailingComma sniff to demand a trailing comma for multi-line, multi-attribute attribute blocks and forbid trailing commas in single-line attribute blocks and in multi-line attributes containing only a single attribute. #397, #413
• 🔧 📊 📚 New Universal.PHP.DisallowExitDieParentheses sniff to forbid invocations of exit/die with parentheses when no argument is passed. #399
• 🔧 📊 📚 New Universal.PHP.RequireExitDieParentheses sniff to demand that invocations of exit/die always use parentheses, even if no argument is passed. #398
• 🔧 📚 New Universal.WhiteSpace.FirstClassCallableSpacing sniff to enforce consistent spacing around the ellipses for first class callables. #385
  The sniff offers the following property to influence its behaviour: spacing (defaults to 0).

Changed

Universal

• Universal.WhiteSpace.CommaSpacing: improved handling of commas in PHP attributes. #391, #412
  • The spacing after a trailing comma (after the last attribute in a block) will no longer be checked to prevent potential conflicts with attribute bracket spacing sniffs.
  • Spacing errors for commas between attributes in an attribute block will now get an *InAttributeBlock error code suffix, so in-/excluding them selectively is more straight-forward.
    Note: spacing around commas between parameters passed to an attribute will still be reported with the *InFunctionCall error code suffix, same as before.
  • Metrics for comma spacing in attribute blocks is now also measured and reported separately.

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.13.5 || ^4.0.1 (was ^3.13.4 || ^4.0.0). #408
• Composer: The minimum PHPCSUtils requirement has been updated to ^1.2.0 (was ^1.1.2). #408
• Various housekeeping.

Added

Universal

• :wrench: :bar_chart: :books: New Universal.Attributes.BracketSpacing sniff to enforce a fixed number of spaces on the inside of attribute block brackets. #386, #406 The sniff offers the following properties to influence its behaviour:
  • spacing (defaults to 0).
  • ignoreNewlines (defaults to false). When new lines are allowed (ignoreNewlines=true) and a new line is found, the sniff will verify that there are no superfluous blank lines at the start/end of an attribute block.
• :wrench: :bar_chart: :books: New Universal.Attributes.DisallowAttributeParentheses sniff to forbid parentheses for attribute instantiations without arguments. #387, #409
• :wrench: :bar_chart: :books: New Universal.Attributes.RequireAttributeParentheses sniff to demand that all attribute instantiations always use parentheses, even if no argument is passed. #387, #410
• :wrench: :bar_chart: :books: New Universal.Attributes.TrailingComma sniff to demand a trailing comma for multi-line, multi-attribute attribute blocks and forbid trailing commas in single-line attribute blocks and in multi-line attributes containing only a single attribute. #397, #413
• :wrench: :bar_chart: :books: New Universal.PHP.DisallowExitDieParentheses sniff to forbid invocations of exit/die with parentheses when no argument is passed. #399
• :wrench: :bar_chart: :books: New Universal.PHP.RequireExitDieParentheses sniff to demand that invocations of exit/die always use parentheses, even if no argument is passed. #398
• :wrench: :books: New Universal.WhiteSpace.FirstClassCallableSpacing sniff to enforce consistent spacing around the ellipses for first class callables. #385 The sniff offers the following property to influence its behaviour: spacing (defaults to 0).

Changed

Universal

• Universal.WhiteSpace.CommaSpacing: improved handling of commas in PHP attributes. #391, #412
  • The spacing after a trailing comma (after the last attribute in a block) will no longer be checked to prevent potential conflicts with attribute bracket spacing sniffs.
  • Spacing errors for commas between attributes in an attribute block will now get an *InAttributeBlock error code suffix, so in-/excluding them selectively is more straight-forward. Note: spacing around commas between parameters passed to an attribute will still be reported with the *InFunctionCall error code suffix, same as before.
  • Metrics for comma spacing in attribute blocks is now also measured and reported separately.

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.13.5 || ^4.0.1 (was ^3.13.4 || ^4.0.0). #408
• Composer: The minimum PHPCSUtils requirement has been updated to ^1.2.0 (was ^1.1.2). #408
• Various housekeeping.

1.5.0 - 2025-11-13

Compare

Choose a tag to compare

Changed

Other

• Various housekeeping.

Fixed

Universal

• Universal.OOStructures.AlphabeticExtendsImplements incorrectly displayed the "expected" and "found" names. #378
• Universal.WhiteSpace.CommaSpacing could accidentally cause a fatal error if the content adjacent to the comma was a text string containing percentage signs. Thanks @westonruter for reporting! #400, #401

Changed

Other

• Various housekeeping.

Fixed

Universal

• Universal.OOStructures.AlphabeticExtendsImplements incorrectly displayed the "expected" and "found" names. #378
• Universal.WhiteSpace.CommaSpacing could accidentally cause a fatal error if the content adjacent to the comma was a text string containing percentage signs. Thanks [@westonruter] for reporting! #400, #401

1.4.2 - 2025-10-28

Compare

Choose a tag to compare

Changed

Other

• Various housekeeping.

Fixed

Universal

• Universal.PHP.NoFQNTrueFalseNull: fix breakage due to upstream change in tokenization. #375

Changed

Other

• Various housekeeping.

Fixed

Universal

• Universal.PHP.NoFQNTrueFalseNull: fix breakage due to upstream change in tokenization. #375

1.4.1 - 2025-09-05

Compare

Choose a tag to compare

Added

• All sniffs: compatibility with the new PHP_CodeSniffer 4.x branch in anticipation of the PHP_CodeSniffer 4.0 release. #367
  PHPCSExtra should now be fully compatible with PHP_CodeSniffer 4.0. If you still find an issue, please report it.

Changed

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.13.0 (was ^3.12.1). #361
• Composer: The minimum PHPCSUtils requirement has been updated to ^1.1.0 (was ^1.0.12). #361
• Various housekeeping.

Deprecated

Universal

• Universal.WhiteSpace.PrecisionAlignment: support for scanning JS/CSS files via this sniff is now deprecated. #367

Fixed

Universal

• Universal.Arrays.DuplicateArrayKey: false positives for numeric strings with leading/trailing underscores. Fixed via the update to PHPCSUtils 1.1.0. #363
• Universal.Arrays.DuplicateArrayKey: false negatives for fully qualified true/false/null arrays keys. Fixed via the update to PHPCSUtils 1.1.0. #363
• Universal.WhiteSpace.CommaSpacing: wrong errorcode for comma's in closure use statements after the update to PHPCSUtils 1.1.0. #362

Added

• All sniffs: compatibility with the new PHP_CodeSniffer 4.x branch in anticipation of the PHP_CodeSniffer 4.0 release. #367 PHPCSExtra should now be fully compatible with PHP_CodeSniffer 4.0. If you still find an issue, please report it.

Changed

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.13.0 (was ^3.12.1). #361
• Composer: The minimum PHPCSUtils requirement has been updated to ^1.1.0 (was ^1.0.12). #361
• Various housekeeping.

Deprecated

Universal

• Universal.WhiteSpace.PrecisionAlignment: support for scanning JS/CSS files via this sniff is now deprecated. #367

Fixed

Universal

• Universal.Arrays.DuplicateArrayKey: false positives for numeric strings with leading/trailing underscores. Fixed via the update to PHPCSUtils 1.1.0. #363
• Universal.Arrays.DuplicateArrayKey: false negatives for fully qualified true/false/null arrays keys. Fixed via the update to PHPCSUtils 1.1.0. #363
• Universal.WhiteSpace.CommaSpacing: wrong errorcode for comma's in closure use statements after the update to PHPCSUtils 1.1.0. #362

1.4.0 - 2025-06-14

Compare

Choose a tag to compare

Changed

Other

• Composer: The minimum PHPCSUtils requirement has been updated to ^1.0.12 (was ^1.0.9). #346
• Various housekeeping.

Fixed

Universal

• Universal.UseStatements.DisallowMixedGroupUse: the fixer could get confused when the "base" name for the group name contained a leading backslash, leading to parse errors in the fixed code. #350

Changed

Other

• Composer: The minimum PHPCSUtils requirement has been updated to ^1.0.12 (was ^1.0.9). #346
• Various housekeeping.

Fixed

Universal

• Universal.UseStatements.DisallowMixedGroupUse: the fixer could get confused when the "base" name for the group name contained a leading backslash, leading to parse errors in the fixed code. #350

1.3.1 - 2025-06-08

Compare

Choose a tag to compare

Added

Universal

• 🔧 📚 New Universal.PHP.NoFQNTrueFalseNull sniff to forbid using true, false and null as fully qualified constants. Thanks @rodrigoprimo for reviewing. #327
• Universal.Operators.TypeSeparatorSpacing: support for checking the spacing around the parentheses used in PHP 8.2+ DNF types. #329

Changed

Universal

• The Universal.WhiteSpace.DisallowInlineTabs sniff will now also check for inline tabs in heredoc/nowdoc openers and between the yield and from keywords. #320

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.12.1 (was ^3.8.0). #330
• Developer happiness: prevent creating a composer.lock file. Thanks @fredden! #307
• Various housekeeping, including improvements to the documentation and tests.

Added

Universal

• :wrench: :books: New Universal.PHP.NoFQNTrueFalseNull sniff to forbid using true, false and null as fully qualified constants. Thanks [@rodrigoprimo] for reviewing. #327
• Universal.Operators.TypeSeparatorSpacing: support for checking the spacing around the parentheses used in PHP 8.2+ DNF types. #329

Changed

Universal

• The Universal.WhiteSpace.DisallowInlineTabs sniff will now also check for inline tabs in heredoc/nowdoc openers and between the yield and from keywords. #320

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.12.1 (was ^3.8.0). #330
• Developer happiness: prevent creating a composer.lock file. Thanks [@fredden]! #307
• Various housekeeping, including improvements to the documentation and tests.

1.3.0 - 2025-04-21

Compare

Choose a tag to compare

Changed

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.8.0 (was ^3.7.2). #298
• Composer: The minimum PHPCSUtils requirement has been updated to ^1.0.9 (was ^1.0.8). #298

Please ensure you run composer update phpcsstandards/phpcsextra --with-dependencies to benefit from this.

Changed

Other

• Composer: The minimum PHP_CodeSniffer requirement has been updated to ^3.8.0 (was ^3.7.2). #298
• Composer: The minimum PHPCSUtils requirement has been updated to ^1.0.9 (was ^1.0.8). #298

Please ensure you run composer update phpcsstandards/phpcsextra --with-dependencies to benefit from this.

1.2.1 - 2023-12-08

Compare

Choose a tag to compare

Added

Universal

• 🔧 📚 New Universal.CodeAnalysis.NoDoubleNegative sniff to detect double negatives (!!) and advise to use a boolean cast instead. Thanks @diedexx for reviewing. #277
• 🔧 📚 New Universal.Operators.ConcatPosition sniff to enforce that the concatenation operator for multi-line concatenations is in a preferred position, either always at the start of the next line or always at the end of the previous line. #294
• 🔧 📊 📚 New Universal.PHP.LowercasePHPTag sniff to enforce that the "PHP" in a PHP open tag is lowercase. Thanks @fredden for reviewing. #276

Changed

NormalizedArrays

• NormalizedArrays.Arrays.CommaAfterLast: the sniff now has two extra error codes to distinguish between multi-line arrays with the last array item on the same line as the array closer vs the last array item being on a line before the array closer. Thanks @stronk7 for suggesting and patching this. #283, #284
  These new error codes allow for selectively excluding that specific situation from triggering the sniff.
  The new error codes are FoundMultiLineCloserSameLine (for multiLine="forbid") and MissingMultiLineCloserSameLine (for multiLine="enforce").
  The pre-existing FoundMultiLine and FoundSingleLine error codes continue to be used for multi-line arrays with the last array item on a different line than the array closer.

Other

• Various housekeeping.

Added

Universal

• :wrench: :books: New Universal.CodeAnalysis.NoDoubleNegative sniff to detect double negatives (!!) and advise to use a boolean cast instead. Thanks [@diedexx] for reviewing. #277
• :wrench: :books: New Universal.Operators.ConcatPosition sniff to enforce that the concatenation operator for multi-line concatenations is in a preferred position, either always at the start of the next line or always at the end of the previous line. #294
• :wrench: :bar_chart: :books: New Universal.PHP.LowercasePHPTag sniff to enforce that the "PHP" in a PHP open tag is lowercase. Thanks [@fredden] for reviewing. #276

Changed

NormalizedArrays

• NormalizedArrays.Arrays.CommaAfterLast: the sniff now has two extra error codes to distinguish between multi-line arrays with the last array item on the same line as the array closer vs the last array item being on a line before the array closer. Thanks [@stronk7] for suggesting and patching this. #283, #284 These new error codes allow for selectively excluding that specific situation from triggering the sniff. The new error codes are FoundMultiLineCloserSameLine (for multiLine="forbid") and MissingMultiLineCloserSameLine (for multiLine="enforce"). The pre-existing FoundMultiLine and FoundSingleLine error codes continue to be used for multi-line arrays with the last array item on a different line than the array closer.

Other

• Various housekeeping.

1.2.0 - 2023-12-02

Compare

Choose a tag to compare

Changed

Other

• Various housekeeping.

Fixed

Universal

• Universal.CodeAnalysis.ConstructorDestructorReturn: the sniff will now correctly ignore methods mirroring the class name (PHP-4 style constructors) in namespaced code. #207, #272

Changed

Other

• Various housekeeping.

Fixed

Universal

• Universal.CodeAnalysis.ConstructorDestructorReturn: the sniff will now correctly ignore methods mirroring the class name (PHP-4 style constructors) in namespaced code. [#207], #272

1.1.2 - 2023-09-21

Compare

Choose a tag to compare

Changed

Modernize

• Modernize.FunctionCalls.Dirname: the sniff will now respect a potentially set [php_version configuration option][php_version-config] and only report on modernizations which are possible on the configured php_version. #261 If the php_version is not set, the sniff will continue to report on all modernization options.

Other

• Various documentation improvements. Props in part to [@szepeviktor].
• Improved defensive coding in select places.
• Various housekeeping.

Added

Universal

• :wrench: :books: New Universal.CodeAnalysis.NoEchoSprintf sniff to detect use of the inefficient echo [v]sprintf(...); combi and recommends using [v]printf() instead. #242
• :bar_chart: :books: New Universal.FunctionDeclarations.NoLongClosures sniff to detect "long" closures and recommend using a named function instead. #240 The sniff offers the following properties to influence its behaviour: recommendedLines (defaults to 5), maxLines (defaults to 8), ignoreCommentLines (defaults to true) and ignoreEmptyLines (defaults to true).
• :wrench: :bar_chart: :books: New Universal.FunctionDeclarations.RequireFinalMethodsInTraits sniff to enforce non-private, non-abstract methods in traits to be declared as final. #243, #245 There is a separate NonFinalMagicMethodFound error code for magic methods to allow those to be excluded from the check.
• :wrench: :bar_chart: :books: New Universal.UseStatements.DisallowMixedGroupUse sniff to disallow group use statements which import a combination of namespace/OO construct, functions and/or constants in one statement. #241, #246 Note: the fixer will use a semi-standardized format for group use statements. If there are more specific requirements for the formatting of group use statements, the ruleset configurator should ensure that additional sniffs are included in the ruleset to enforce the required format.
• :wrench: :bar_chart: :books: New Universal.UseStatements.KeywordSpacing sniff to enforce the use of a single space after the use, function, const keywords and both before and after the as keyword in import use statements. #247 The sniff has modular error codes to allow for disabling individual checks.
• :wrench: :books: New Universal.UseStatements.NoUselessAliases sniff to detect useless aliases (aliasing something to its original name) in import use statements. #244 Note: as OO and function names in PHP are case-insensitive, aliasing to the same name, using a different case is also considered useless.
• :wrench: :bar_chart: :books: New Universal.WhiteSpace.CommaSpacing sniff to enforce that there is no space before a comma and exactly one space, or a new line, after a comma. #254 Additionally, the sniff also enforces that the comma should follow the code and not be placed after a trailing comment. The sniff has modular error codes to allow for disabling individual checks and checks in certain contexts. The sniff will respect a potentially set [php_version configuration option][php_version-config] when deciding how to handle the spacing after a heredoc/nowdoc closer.

Changed

Universal

• Minor performance improvements for the Universal.Arrays.DuplicateArrayKey and the Universal.CodeAnalysis.ConstructorDestructorReturn sniffs. #251, #252

Other

• Composer: The minimum PHPCSUtils requirement has been updated to ^1.0.8 (was ^1.0.6). #249, #254
• Various housekeeping.

Changed

Other

• Composer: The minimum PHPCSUtils requirement has been updated to ^1.0.6 (was ^1.0.0). #237
• Various housekeeping.

Fixed

Universal

• Universal.Constants.LowercaseClassResolutionKeyword: prevent false positives for function calls to methods called class. #226

Changed

Universal

• Universal.WhiteSpace.DisallowInlineTabs: significant performance improvement. #216, #217

Other

• Various housekeeping.

Fixed

Modernize

• Modernize.FunctionCalls.Dirname: prevent false positives for attribute classes called dirname. #211, #213

Changed

Universal

• Universal.CodeAnalysis.ConstructorDestructorReturn: the sniff will now respect a potentially set [php_version configuration option][php_version-config] and only report on PHP4-style constructors when the php_version is below '80000'. Thanks [@anomiex] for reporting! #207, #208

Fixed

Universal

• Universal.CodeAnalysis.ConstructorDestructorReturn: fixed false positive for return statements in nested functions/closures declared within constructor/destructor methods. Thanks [@anomiex] for reporting! #201, #202

:warning: Important: this package now requires PHPCSUtils 1.0.0. Please make sure you use --with-[all-]dependencies when running composer update. :exclamation:

For the full list of features, please see the changelogs of the alpha/rc releases:

• 1.0.0-rc1
• 1.0.0-alpha3
• 1.0.0-alpha2
• 1.0.0-alpha1

Changed

Other

• Updated various sniffs to take advantage of PHPCSUtils 1.0.0(-rc1). #193, #194, #195
• Minor documentation improvements.
• Various housekeeping.

Fixed

Modernize

• Modernize.FunctionCalls.Dirname: the sniff will now correctly recognize magic constants in a case-insensitive manner. #187

Added

Universal

• :wrench: :books: New Universal.Arrays.DisallowShortArraySyntax sniff to disallow short array syntax. #40 In contrast to the PHPCS native Generic.Arrays.DisallowShortArraySyntax sniff, this sniff will ignore short list syntax and not cause parse errors when the fixer is used.
• :wrench: :bar_chart: :books: New Universal.Constants.UppercaseMagicConstants sniff to enforce that PHP native magic constants are in uppercase. #64
• :bar_chart: :books: New Universal.Namespaces.DisallowDeclarationWithoutName sniff to disallow namespace declarations without a namespace name. #50
• :bar_chart: :books: New Universal.Operators.DisallowLogicalAndOr sniff to enforce the use of the boolean && and || operators instead of the logical and/or operators. #52 Note: as the operator precedence of the logical operators is significantly lower than the operator precedence of boolean operators, this sniff does not contain an auto-fixer.
• :bar_chart: :books: New Universal.Operators.DisallowShortTernary sniff to disallow the use of short ternaries ?:. #42 While short ternaries are useful when used correctly, the principle of them is often misunderstood and they are more often than not used incorrectly, leading to hard to debug issues and/or PHP warnings/notices.
• :wrench: :bar_chart: :books: New Universal.Operators.DisallowStandalonePostIncrementDecrement sniff disallow the use of post-in/decrements in stand-alone statements and discourage the use of multiple increment/decrement operators in a stand-alone statement. #65
• :wrench: :bar_chart: :books: New Universal.Operators.StrictComparisons sniff to enforce the use of strict comparisons. #48 Warning: the auto-fixer for this sniff may cause bugs in applications and should be used with care! This is considered a risky fixer.
• :wrench: :bar_chart: :books: New Universal.OOStructures.AlphabeticExtendsImplements sniff to verify that the names used in a class "implements" statement or an interface "extends" statement are listed in alphabetic order. #55
  • This sniff contains a public orderby property to determine the sort order to use for the statement. If all names used are unqualified, the sort order won't make a difference. However, if one or more of the names are partially or fully qualified, the chosen sort order will determine how the sorting between unqualified, partially and fully qualified names is handled. The sniff supports two sort order options:
    • 'name' : sort by the interface name only (default);
    • 'full' : sort by the full name as used in the statement (without leading backslash). In both cases, the sorting will be done using natural sort, case-insensitive.
  • The sniff has modular error codes to allow for selective inclusion/exclusion:
    • ImplementsWrongOrder - for "class implements" statements.
    • ImplementsWrongOrderWithComments - for "class implements" statements interlaced with comments. These will not be auto-fixed.
    • ExtendsWrongOrder - for "interface extends" statements.
    • ExtendsWrongOrderWithComments - for "interface extends" statements interlaced with comments. These will not be auto-fixed.
  • When fixing, the existing spacing between the names in an implements/extends statement will not be maintained. The fixer will separate each name with a comma and one space. If alternative formatting is desired, a sniff which will check and fix the formatting should be added to the ruleset.
• :wrench: :bar_chart: :books: New Universal.UseStatements.LowercaseFunctionConst sniff to enforce that function and const keywords when used in an import use statement are always lowercase. #58
• :wrench: :bar_chart: :books: New Universal.UseStatements.NoLeadingBackslash sniff to verify that a name being imported in an import use statement does not start with a leading backslash. #46 Names in import use statements should always be fully qualified, so a leading backslash is not needed and it is strongly recommended not to use one. This sniff handles all types of import use statements supported by PHP, in contrast to other sniffs for the same in, for instance, the PSR12 or the Slevomat standard, which are incomplete.
• :wrench: :books: New Universal.WhiteSpace.DisallowInlineTabs sniff to enforce using spaces for mid-line alignment. #43

Changed

Other

• The master branch has been renamed to stable.
• Composer: The version requirements for the [Composer PHPCS plugin] have been widened to allow for version 0.7.0 which supports Composer 2.0.0. #62
• Various housekeeping.

Added

Universal

• :wrench: :bar_chart: :books: New Universal.ControlStructures.DisallowAlternativeSyntax sniff to disallow using the alternative syntax for control structures. #23
  • This sniff contains a allowWithInlineHTML property to allow alternative syntax when inline HTML is used within the control structure. In all other cases, the use of the alternative syntax will still be disallowed.
  • The sniff has modular error codes to allow for making exceptions based on specific control structures and/or specific control structures in combination with inline HTML.
• :bar_chart: Universal.UseStatements.DisallowUseClass/Function/Const: new, additional metrics about the import source will be shown in the info report. #25

Other

• Readme: installation instructions and sniff list. #26

Changed

Universal

• Universal.Arrays.DuplicateArrayKey: wording of the error message. #18
• Universal.UseStatements.DisallowUseClass/Function/Const: the error codes have been made more modular. #25 Each of these sniffs now has four additional error codes: <ul> <li><code>FoundSameNamespace</code>, <code>FoundSameNamespaceWithAlias</code> for <code>use</code> statements importing from the same namespace;</li> <li><code>FoundGlobalNamespace</code>, <code>FoundGlobalNamespaceWithAlias</code> for <code>use</code> statements importing from the global namespace, like import statements for PHP native classes, functions and constants.</li> </ul> In all other circumstances, the existing error codes <code>FoundWithAlias</code> and <code>FoundWithoutAlias</code> will continue to be used.

Other

• Improved formatting of the CLI documentation which can be viewed using --generator=text. #17
• Various housekeeping.

Fixed

Universal

• Universal.Arrays.DuplicateArrayKey: improved handling of parse errors. #34
• Universal.ControlStructures.IfElseDeclaration: the fixer will now respect tab indentation. #19
• Universal.UseStatements.DisallowUseClass/Function/Const: the determination of whether a import is aliased in now done in a case-insensitive manner. #25
• Universal.UseStatements.DisallowUseClass/Function/Const: an import from the global namespace would previously always be seen as non-aliased, even when it was aliased. #25
• Universal.UseStatements.DisallowUseClass/Function/Const: improved tolerance for use import statements with leading backslashes. #25

Initial alpha release containing:

• A NormalizedArrays standard which will contain a full set of sniffs to check the formatting of array declarations.
• A Universal standard which will contain a collection of universally applicable sniffs. DO NOT INCLUDE THIS AS A STANDARD. Universal, like the upstream PHPCS Generic standard, contains sniffs which contradict each other. Include individual sniffs from this standard in a custom project/company ruleset to use them.

This initial alpha release contains the following sniffs:

NormalizedArrays

• :wrench: :bar_chart: :books: NormalizedArrays.Arrays.ArrayBraceSpacing: enforce consistent spacing for the open/close braces of array declarations. The sniff allows for having different settings for:
  • Space between the array keyword and the open parenthesis for long arrays via the keywordSpacing property. Accepted values: (int) number of spaces or false to turn this check off. Defaults to 0 spaces.
  • Spaces on the inside of the braces for empty arrays via the spacesWhenEmpty property. Accepted values: (string) newline, (int) number of spaces or false to turn this check off. Defaults to 0 spaces.
  • Spaces on the inside of the braces for single-line arrays via the spacesSingleLine property; Accepted values: (int) number of spaces or false to turn this check off. Defaults to 0 spaces.
  • Spaces on the inside of the braces for multi-line arrays via the spacesMultiLine property. Accepted values: (string) newline, (int) number of spaces or false to turn this check off. Defaults to newline. Note: if any of the above properties are set to newline, it is recommended to also include an array indentation sniff. This sniff will not handle the indentation.
• :wrench: :bar_chart: :books: NormalizedArrays.Arrays.CommaAfterLast: enforce/forbid a comma after the last item in an array declaration. By default, this sniff will: <ul> <li>forbid a comma after the last array item for single-line arrays.</li> <li>enforce a comma after the last array item for multi-line arrays.</li> </ul> This can be changed for each type or array individually by setting the <code>singleLine</code> or <code>multiLine</code> properties in a custom ruleset. The valid values are: <code>enforce</code>, <code>forbid</code> or <code>skip</code> to not check the comma after the last array item for a particular type of array.

Universal

• :books: Universal.Arrays.DuplicateArrayKey: detects duplicate array keys in array declarations.
• :books: Universal.Arrays.MixedArrayKeyTypes: best practice sniff: don't use a mix of integer and numeric keys for array items.
• :books: Universal.Arrays.MixedKeyedUnkeyedArray: best practice sniff: don't use a mix of keyed and unkeyed array items.
• :wrench: :bar_chart: :books: Universal.ControlStructures.IfElseDeclaration: verify that else(if) statements with braces are on a new line.
• :wrench: :bar_chart: :books: Universal.Lists.DisallowLongListSyntax: disallow the use of long lists.
• :wrench: :bar_chart: :books: Universal.Lists.DisallowShortListSyntax: disallow the use of short lists.
• :bar_chart: :books: Universal.Namespaces.DisallowCurlyBraceSyntax: disallow the use of the alternative namespace declaration syntax using curly braces.
• :bar_chart: :books: Universal.Namespaces.EnforceCurlyBraceSyntax: enforce the use of the alternative namespace syntax using curly braces.
• :books: Universal.Namespaces.OneDeclarationPerFile: disallow the use of multiple namespaces within a file.
• :bar_chart: :books: Universal.UseStatements.DisallowUseClass: forbid using import use statements for classes/traits/interfaces. Individual sub-types can be allowed by excluding specific error codes.
• :bar_chart: :books: Universal.UseStatements.DisallowUseConst: forbid using import use statements for constants. Individual sub-types can be allowed by excluding specific error codes.
• :bar_chart: :books: Universal.UseStatements.DisallowUseFunction: forbid using import use statements for functions. Individual sub-types can be allowed by excluding specific error codes.