'value', 'key2' => 'value', // Comment after item. ]; $ok_nested = array( 'key1' => array( 'key1' => 'value', 'key2' => 'value', ), 'key2' => 'value', ); $bad_phpcs_style = array( 'value', 123, // Comment after item. ); $bad_phpcs_style_with_keys = array( 'key1' => 'value', 'key2' => 'value', ); $bad_phpcs_style_nested = array( 'key1' => [ 'key1' => 'value', 'key2' => 'value', ], 'key2' => 'value', ); // Arrays with initial indent. $bad_mixed_indent = [ 'value', 123, ]; $bad_mixed_indent_with_keys = array( 'key1' => 'value', 'key2' => 'value', ); $bad_mixed_indent_nested = [ 'key1' => array( 'key1' => 'value', 'key2' => 'value', ), 'key2' => 'value', ]; $empty = [ ]; // Same-line items in mixed arrays should be ignored. $mixed_1 = array('something', 'else', array( 'key1' => 'value', 'key2' => 'value', // Comment after item. ), ); $mixed_2 = array( array( 'key1' => 'value', 'key2' => 'value', // Comment after item. ), 'something', 'else', ); // Issue 998: don't fix the indentation for the closer if it's not on its own line. $a = array( 'foo' => bar(1, 29)); $a = array( 'foo' => bar(1, 29) ); /* * Issue 973 - multi-line value indentation. */ // OK. get_current_screen()->add_help_tab( array( 'id' => 'overview', 'content' => '

' . __( 'You can manage comments made on your site similar to the way you manage posts and other content. This screen is customizable in the same ways as other management screens, and you can act on comments using the on-hover action links or the Bulk Actions.' ) . '

' . '

' ) ); // Too little overall indentation. get_current_screen()->add_help_tab( array( 'id' => 'overview', 'content' => '

' . '

' ) ); // Too much overall indentation. get_current_screen()->add_help_tab( array( 'id' => 'overview', 'content' => '

' . '

' ) ); // Too little overall with more than the minimum indentation for some subsequent lines. get_current_screen()->add_help_tab( array( 'id' => 'screen-content', 'content' => '

' . __('You can customize the display of this screen’s contents in a number of ways:') . '

' . '

' . __('You can hide/display columns based on your needs and decide how many posts to list per screen using the Screen Options tab.') . '
' . __( 'You can filter the list of posts by post status using the text links above the posts list to only show posts with that status. The default view is to show all posts.' ) . '
' . __('You can view posts in a simple title list or with an excerpt using the Screen Options tab.') . '
' . __('You can refine the list to show only posts in a specific category or from a specific month by using the dropdown menus above the posts list. Click the Filter button after making your selection. You also can refine the list by clicking on the post author, category or tag in the posts list.') . '

' ) ); // Too much overall with more than the minimum indentation for some subsequent lines. get_current_screen()->add_help_tab( array( 'id' => 'bulk-actions', 'content' => '

' . __('You can also edit or move multiple posts to the trash at once. Select the posts you want to act on using the checkboxes, then select the action you want to take from the Bulk Actions menu and click Apply.') . '

' . '

' . __('When using Bulk Edit, you can change the metadata (categories, author, etc.) for all selected posts at once. To remove a post from the grouping, just click the x next to its name in the Bulk Edit area that appears.') . '

' ) ); // Too much overall with less than the minimum indentation for some subsequent lines. get_current_screen()->add_help_tab( array( 'id' => 'screen-content', 'content' => '

' . '

' . __('You can hide/display columns based on your needs and decide how many posts to list per screen using the Screen Options tab.') . '

' . '

' ) ); // Mixed indentation. get_current_screen()->add_help_tab( array( 'id' => 'overview', // Here we have a comment. 'title' => __('Overview') . 'something', /* Here we have a comment. */ 'content' => 'value' . 'value' . 'value' . 'value', ) ); // OK: Ignore empty lines when found as subsequent line in an item. get_current_screen()->add_help_tab( array( 'id' => 'something' . 'something else', ) ); /* * Issue: Subsequent lines with Heredoc/Nowdoc syntax should be ignored. */ // Should only report the first line and fix the first line + the comma on the last line. get_current_screen()->add_help_tab( array( 'id' => <<add_help_tab( array( 'id' => <<add_help_tab( array( 'id' => <<' . '', ) ); // Should report on the heredoc opener and fix the opener and the line after the heredoc. get_current_screen()->add_help_tab( array( 'id' => <<', ) ); // Should report on the 'id' line and the line after. Should fix both + line after the heredoc. get_current_screen()->add_help_tab( array( 'id' => '

' . <<', ) ); // OK. Not pretty, but not handled by this sniff as both first line + line after have acceptable alignment. get_current_screen()->add_help_tab( array( 'id' => '

' . <<', ) ); /* * Issue 985 - arrays with comments between items. */ // OK. get_current_screen()->add_help_tab( array( 'id' => 'overview', // Here we have a comment. 'title' => __('Overview'), /* Here we have a comment. */ 'content' => 'value', ) ); // Too little overall indentation. get_current_screen()->add_help_tab( array( 'id' => 'overview', // Here we have a comment. 'title' => __('Overview'), /* Here we have a comment. */ 'content' => 'value', ) ); // Too much overall indentation. get_current_screen()->add_help_tab( array( 'id' => 'overview', // Here we have a comment. 'title' => __('Overview'), /* Here we have a comment. */ 'content' => 'value', ) ); // Mixed indentation. get_current_screen()->add_help_tab( array( 'id' => 'overview', // Here we have a comment. 'title' => __('Overview'), /* Here we have a comment. */ 'content' => 'value', ) ); // Various multi-line comments. $my_array = [ /** * Docblock about a filtered value... */ 'truthy' => apply_filters( '...', true ), ]; $my_array = [ /** * Docblock about a filtered value... */ 'truthy' => apply_filters( '...', true ), ]; $my_array = [ /* * Multi-line inline comment about something... */ 'truthy' => apply_filters( '...', true ), ]; $my_array = [ /* * Multi-line inline comment about something... */ 'truthy' => apply_filters( '...', true ), ]; $my_array = array( 'something' => /** * Docblock about a filtered value... */ $a = apply_filters( '...', true ), ); $my_array = [ 'something' => /** * Docblock about a filtered value... */ $a = apply_filters( '...', true ), ]; $my_array = [ 'something' => /* * Multi-line inline comment about something... */ apply_filters( '...', true ), ]; $my_array = [ 'something' => /* * Multi-line inline comment about something... */ apply_filters( '...', true ), ]; /* * Test multi-line strings as the value for an array item. */ $test = array( 'notes1' => '

Whether to use isset() or array_key_exists() depends on what you want to know:

', 'notes1' => '

Whether to use isset() or array_key_exists() depends on what you want to know:

' . // The sniff should check & fix the next line as it is a new token. '

This said, we can concluded that to avoid warnings and undesired results you will always have to use an is_array() first.
Also note that isset() is faster than array_key_exists(), but as said above, will return false if no value has been assigned.

', 'notes1' => // Same, but now using double quotes. "

Whether to use isset() or array_key_exists() depends on what you want to know:

" . // The sniff should check & fix the next line as it is a new token. "

", // Now using double quotes with a variable to force T_DOUBLE_QUOTED_STRING token. 'notes1' => array( "

Whether to use $abc or $def depends on what you want to know:

" . // The sniff should check & fix the next line as it is a new token. "

This said, we can concluded that to avoid warnings and undesired results you will always have to use an is_array() first.
Also note that $abc is faster than $def, but as said above, will return false if no value has been assigned.

", ), 'notes2' => array( '

Important: Integers between -128 and 255 are interpreted as the ASCII value pointing to a character (negative values have 256 added in order to allow characters in the Extended ASCII range).
In any other case, integers are interpreted as a string containing the decimal digits of the integer.

', ), 'tooltip' => ' if( ! is_array( $x ) ) { filter_var( $x, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE ); } else { filter_var_array( $x, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE ); // = Simplified... see note } ', 'notes3' => array( '

Please note: On some PHP versions filter_var( $x, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE ) where $x = false will incorrectly return null.
Also: with the same parameters filter_var() will return false instead of null for most objects.

', '

The code snippet is simplified for brevity. Please refer to the source of this file on GitHub for full details on how to use filter_var_array().

', ), ); // Issue #1179. b( [ 1 => false, // wat 2 => false, ] ); $a = array( 'post_type' => 'post', 'post_content' => ' Page 1/5 Page 2/3 Page 3/3 ', ); // Upstream issue #2060 - multi-line trailing comment. $NP = array( 'replacemaps' => array( 0x41 => array( 0x61 ), 0x33C1 => array( 0x6D, 0x3C9 ), /* ,0x33C2 => array(0x61, 0x2E, 0x6D, 0x2E) */ 0x33C3 => array( 0x62, 0x71 ), ), ); $my_array = [ 'something' => apply_filters( '...', true ),// A // Multi-line inline comment about something... // B 'something_else', ]; /* * Issue #1692: Test distinguishing between short array and short list. */ [ 'prop1' => $prop1, 'prop2' => $prop2, ] = $some_var; // phpcs:set WordPress.Arrays.ArrayIndentation tabIndent true