PHPStan code quality improvements for 7.0

[SergeyBiryukov]

This ticket is for various code quality issues and improvements surfaced via PHPStan.

Implementing PHPStan is tracked separately in #61175.

Previously:

• #63268 (6.9)
• #52217 (6.8)
• #51423 (6.2)

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR fixes an issue in get_taxonomy_labels(), where the template_name was accessed as an object property on $tax->labels instead of as an array property.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

This PR improves the type safety around WP_Screen in the following ways:

• Correctly hint that WP_Screen::$_show_screen_options is null before instantiated.
• Correctly hint that ::get_option(), get_help_tab() and get_screen_reader_text() can return null.
• Ensure $this->columns is an int, by casting $this->get_option( 'layout_columns', 'default' ) from its numeric string.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR fixes wp_create_category() to return an int as defined in the DocBlock, instead of the numeric-string returned by category_exists().

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR removes an unnecessary empty( $old_user_data ) check from wp_insert_user(). The $old_user_data variable is defined alongside $update, so by checking for one, we've already narrowed the type for the other:

• ​https://github.com/justlevine/wordpress-develop/blob/dd5e2bccaa6f145a10d25283c75ac39846e2046b/src/wp-includes/user.php#L2208-L2226

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR fixes an issue in WP_REST_Attachments_Controller::update_item(), where the $schema['properties'] are checked for featured media, but is only defined in the parent method and not where it is currently used.

Follow up to: https://core.trac.wordpress.org/ticket/41692

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR removes an unnecessary empty( $modes_str ) check from wpdb::set_sql_mode(), as the previous code block already checks and returns early:

• ​https://github.com/justlevine/wordpress-develop/blob/09faccb0971511c3dba6f65f9effa185ab66e741/src/wp-includes/class-wpdb.php#L960

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR fixes two attempts to use the results of base_convert() in a binaryOp without first converting the results to an integer.

In

• add_menu_page()
• WP_Duotone::colord_parse_hex()

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR updates WP_REST_Comments_Controller::get_items() to cast the values of $total_comments and $max_pages to string types before they are set on the response headers.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR fixes the return type on WP_HTML_Decoder::read_character_reference() to correctly indicate that it returns a _nullable_ string, and not string|false.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR fixes the return type on WP_Speculation_Rules::jsonSerialize() to show that it returns an array<string, mixed[]> instead of the internal array having a string key. This is due to the method's use of array_values() to intentionally strip any keys.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR updates various @var tags on class properties to correctly indicate that they props may be null|unset:

• WP_Dependencies::$all_queued_deps is nullable by both ::enqueue() and ::dequeue.
• WP_Duotone::$global_styles_presets and ::$global_styles_block_names start off unset and are only initialized by static classes.
• WP_Query::init() and WP_Rewrite::init() are public methods that unset()s many class props.
• WP_Theme::cache_delete() sets many props to null.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR updates several functions to explicitly return null in accordance to their existing doc-types, instead of using a void return;.

Affected functions:

• get_comment_reply_link()
• get_page_of_comment()
• get_edit_term_link()
• get_preview_post_link()
• get_edit_post_link()
• wp_set_all_user_settings()
• get_page_by_path()
• save_mod_rewrite_rules()

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

This PR removes an unreachable break; from the 'allblogs' -> 'delete' case in wp-admin/network/sites.php, as the line before exits entirely.

While this issue was surfaced via PHPStan in ​https://github.com/WordPress/wordpress-develop/pull/7619 (trac: https://core.trac.wordpress.org/ticket/61175 ), it can be remediated independently of that ticket.

Trac ticket:
https://core.trac.wordpress.org/ticket/64238
https://core.trac.wordpress.org/ticket/63268

[SergeyBiryukov]

In 61243:

Coding Standards: Remove redundant check in wpdb::set_sql_mode().

This commit removes an unnecessary empty( $modes_str ) check, as the previous code block already checks the same value and returns early.

Follow-up to [30587], [56475].

Props justlevine.
See #64238.

Thanks for the PR! Merged in r61243.

[SergeyBiryukov]

In 61247:

Coding Standards: Cast base_convert() to an integer before arithmetic operations.

Follow-up to [35477], [53104], [56101].

Props justlevine.
See #64238.

Thanks for the PR! Merged in r61247.

[westonruter]

In 61280:

Docs: Fix phpdoc types for WP_Speculation_Rules members.

What was previously mixed is actually a speculation rule which can be more accurately be typed as array<string, mixed>. Additionally, the return value of jsonSerialize is fixed to indicate it returns an array of lists as opposed an array of associative arrays.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8946

Follow-up to [59837].

Props justlevine, johnbillion, westonruter.
See #64238, #63268, #62503.

Committed in r61280 (9e2d045)

[westonruter]

In 61281:

Docs: Explicitly return null when documented instead of void in link-template.php functions.

The phpdoc @return tags for these functions indicate they may return null. This also fixes "Missing return argument" warnings which an IDE may also complain about.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8955

Props justlevine.
See #64238.

Committed in r61281 (c9c6518)

[westonruter]

In 61282:

Docs: Cast header values to strings in WP_REST_Comments_Controller::get_items().

Follow-up to [38832].

Props justlevine, johnbillion.
See #64238.

Committed in r61282 (​https://github.com/WordPress/wordpress-develop/commit/43f956385976bf08f3a12749c4471bfffb7c09a9)

[westonruter]

In 61283:

Docs: Fix return type for WP_HTML_Decoder::read_character_reference().

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8945

Follow-up to [58281].

Props justlevine.
See #64238, #61072.

Committed in r61283 (e870c4a)

@justlevine I found that wp_create_category() was incorrectly saying that it could return WP_Error, when in fact it is supposed to always return an integer. In the case of failure, it returns zero, since wp_insert_category() isn't called with the $wp_error arg.

In trunk when I run:

phpstan analyze --memory-limit=2G --level=3 src/wp-admin/includes/class-wp-screen.php

I get:

Note: Using configuration file /Users/westonruter/repos/wordpress-develop/phpstan.neon.
 1/1 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%

 ------ ----------------------------------------------------------------------------------- 
  Line   class-wp-screen.php                                                                
 ------ ----------------------------------------------------------------------------------- 
  306    Variable $post_id might not be defined.                                            
         🪪  variable.undefined                                                             
         at src/wp-admin/includes/class-wp-screen.php:306                                   
  552    Method WP_Screen::get_option() should return string but returns null.              
         🪪  return.type                                                                    
         at src/wp-admin/includes/class-wp-screen.php:552                                   
  558    Method WP_Screen::get_option() should return string but returns null.              
         🪪  return.type                                                                    
         at src/wp-admin/includes/class-wp-screen.php:558                                   
  605    Method WP_Screen::get_help_tab() should return array but returns null.             
         🪪  return.type                                                                    
         at src/wp-admin/includes/class-wp-screen.php:605                                   
  740    Method WP_Screen::get_screen_reader_text() should return string but returns null.  
         🪪  return.type                                                                    
         at src/wp-admin/includes/class-wp-screen.php:740                                   
  953    Property WP_Screen::$columns (int) does not accept string.                         
         🪪  assign.propertyType                                                            
         at src/wp-admin/includes/class-wp-screen.php:953      

In this branch, the last five are eliminated.

I guess the bug here has never been noticed before because no where in core is the REST API used to set the featured image for an attachment?

We should add a unit test for this.

@justlevine ok, I found the issue, and I've fixed it in 720512a. The issue is that with fixing the $schema here, it's allowing handle_featured_media() to be called by \WP_REST_Attachments_Controller::update_item() when the this method is also calling parent::update_item() in which case it calls \WP_REST_Posts_Controller::update_item() which _also_ calls the handle_featured_media() method. The handle_featured_media() method wasn't accounting for the case where an attempt is made to update a featured media to be the same as the featured media currently set.

This appears to have been introduced in r57603 (54d72c5deee2c5cfa2dadef4409b7beb1cefea38) to fix Core-41692 (as noted above).

The idempotency issue is only noticed for updating attachments because it short-circuits with an error when handle_featured_media() returns false:

​https://github.com/WordPress/wordpress-develop/blob/ba4d80d346eb2f71e1ccc122af466451759d84ba/src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php#L224-L230

This doesn't happen when updating posts:

​https://github.com/WordPress/wordpress-develop/blob/ba4d80d346eb2f71e1ccc122af466451759d84ba/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php#L817-L819

So while the tests have been fixed, it's clear that test coverage is not complete, because this code is never run:

​https://github.com/WordPress/wordpress-develop/blob/ba4d80d346eb2f71e1ccc122af466451759d84ba/src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php#L227-L229

So we need to make sure that the error scenario is tested.

So we need to make sure that the error scenario is tested.

OK, added in e6c6c68

Summarized in comment on original ticket: https://core.trac.wordpress.org/ticket/41692#comment:44

[westonruter]

In 61298:

Docs: Update typing for wp_create_category().

• Ensure that wp_create_category() returns int as opposed to numeric-string.
• Rename $cat_name to $category_name to avoid abbreviating variables.
• Update docblock to remove erroneous int for $category_name param when only string is intended.
• Add missing tests for wp_create_category().

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8861

Props justlevine, westonruter.
See #64238, #64226.

Committed in r61298 (2cf0f3d)

[westonruter]

In 61299:

Docs: Update various class @var tags to indicate nullability.

This updates various @var tags on class properties to correctly indicate that the props may be null or unset:

• WP_Dependencies::$all_queued_deps is nullable by both ::enqueue() and ::dequeue. Also, the types of the keys and values are specified.
• WP_Duotone::$global_styles_presets and ::$global_styles_block_names start off unset and are only initialized by static classes.
• WP_Query::init() and WP_Rewrite::init() are public methods that unset()s many class props.
• WP_Theme::cache_delete() sets many props to null.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8953

Props justlevine, westonruter.
See #64238, #64224.

Committed in r61299 (0d33b5c)

[westonruter]

In 61300:

Docs: Improve docblocks and types for WP_Screen properties.

• Correctly hint that WP_Screen::$_show_screen_options is null before being instantiated.
• Correctly hint that ::get_option(), get_help_tab() and get_screen_reader_text() can return null.
• Ensure $this->columns is an int, by casting $this->get_option( 'layout_columns', 'default' ) from its numeric string.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8860

Props justlevine, peterwilsoncc, westonruter.
See #64238, #64224.

Committed in r61300 (2898ab5).

[westonruter]

In 61303:

Coding Standards: Remove unreachable break statement after exit in switch.

This resolves static analysis warnings about an unreachable statement.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/8956

Follow-up to [41131].

Props justlevine, johnbillion.
See #64238.

Committed in r61303 (6bea530)

Trac ticket: https://core.trac.wordpress.org/ticket/64238

Running this PHPStan command:

phpstan analyze --memory-limit=4G --level=8 src/wp-includes/class-wp-scripts.php src/wp-includes/class-wp-styles.php src/wp-includes/class-wp-dependencies.php src/wp-includes/class-wp-dependency.php

Results in the following report for trunk:

 ------ ------------------------------------------------------------------------------------------------------------ 
  Line   class-wp-dependencies.php                                                                                   
 ------ ------------------------------------------------------------------------------------------------------------ 
  65     Property WP_Dependencies::$args type has no value type specified in iterable type array.                    
         🪪  missingType.iterableValue                                                                               
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                  
         at src/wp-includes/class-wp-dependencies.php:65                                                             
  105    Property WP_Dependencies::$queued_before_register type has no value type specified in iterable type array.  
         🪪  missingType.iterableValue                                                                               
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                  
         at src/wp-includes/class-wp-dependencies.php:105                                                            
 ------ ------------------------------------------------------------------------------------------------------------ 

 ------ -------------------------------------------------------------------------------------------- 
  Line   class-wp-dependency.php                                                                     
 ------ -------------------------------------------------------------------------------------------- 
  71     Property _WP_Dependency::$extra type has no value type specified in iterable type array.    
         🪪  missingType.iterableValue                                                               
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type  
         at src/wp-includes/class-wp-dependency.php:71                                               
 ------ -------------------------------------------------------------------------------------------- 

 ------ -------------------------------------------------------------------------------------------------------- 
  Line   class-wp-scripts.php                                                                                    
 ------ -------------------------------------------------------------------------------------------------------- 
  51     Property WP_Scripts::$in_footer type has no value type specified in iterable type array.                
         🪪  missingType.iterableValue                                                                           
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type              
         at src/wp-includes/class-wp-scripts.php:51                                                              
  123    Property WP_Scripts::$default_dirs type has no value type specified in iterable type array.             
         🪪  missingType.iterableValue                                                                           
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type              
         at src/wp-includes/class-wp-scripts.php:123                                                             
  597    Method WP_Scripts::localize() has parameter $l10n with no value type specified in iterable type array.  
         🪪  missingType.iterableValue                                                                           
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type              
         at src/wp-includes/class-wp-scripts.php:597                                                             
  724    Property _WP_Dependency::$translations_path (string) in isset() is not nullable.                        
         🪪  isset.property                                                                                      
         at src/wp-includes/class-wp-scripts.php:724                                                             
 ------ -------------------------------------------------------------------------------------------------------- 

 ------ --------------------------------------------------------------------------------------------- 
  Line   class-wp-styles.php                                                                          
 ------ --------------------------------------------------------------------------------------------- 
  101    Property WP_Styles::$default_dirs type has no value type specified in iterable type array.   
         🪪  missingType.iterableValue                                                                
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type   
         at src/wp-includes/class-wp-styles.php:101                                                   
  186    Parameter #1 $src of method WP_Styles::in_default_dir() expects string, string|false given.  
         🪪  argument.type                                                                            
         at src/wp-includes/class-wp-styles.php:186                                                   
 ------ --------------------------------------------------------------------------------------------- 

 [ERROR] Found 9 errors                                                                                                 

With this PR, the issues are fixed.

[westonruter]

In 61358:

Docs: Improve accuracy for types in phpdoc for WP_Dependencies, _WP_Dependency, WP_Scripts, and WP_Styles.

This increases these classes to PHPStan level 8.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10607

See #64238.

Committed in r61358.

This addresses the following PHPStan level 6 issues:

 ------ --------------------------------------------------------------------------------------------------------------- 
  Line   class-wp-script-modules.php                                                                                    
 ------ --------------------------------------------------------------------------------------------------------------- 
  122    Method WP_Script_Modules::register() has parameter $args with no value type specified in iterable type array.       
         🪪  missingType.iterableValue                                                                                       
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                          
         at src/wp-includes/class-wp-script-modules.php:122                                                                  
  294    Method WP_Script_Modules::enqueue() has parameter $args with no value type specified in iterable type array.        
         🪪  missingType.iterableValue                                                                                       
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                          
         at src/wp-includes/class-wp-script-modules.php:294                                                                  
  540    Method WP_Script_Modules::get_import_map() return type has no value type specified in iterable type array.          
         🪪  missingType.iterableValue                                                                                       
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                          
         at src/wp-includes/class-wp-script-modules.php:540                                                                  
  561    Method WP_Script_Modules::get_marked_for_enqueue() return type has no value type specified in iterable type array.  
         🪪  missingType.iterableValue                                                                                       
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                          
         at src/wp-includes/class-wp-script-modules.php:561                                                                  
  582    Method WP_Script_Modules::get_dependencies() return type has no value type specified in iterable type array.        
         🪪  missingType.iterableValue                                                                                       
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                          
         at src/wp-includes/class-wp-script-modules.php:582   

Trac ticket: https://core.trac.wordpress.org/ticket/64238

[westonruter]

In 61362:

Docs: Improve specificity of types in WP_Script_Modules and script-modules.php functions.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10614

Follow-up to [61358].

See #64238.

Committed in r61362.

Trac ticket: https://core.trac.wordpress.org/ticket/64238

This fixes the following PHPStan issues:

 ------ -------------------------------------------------------------------------------------------------------- 
  Line   functions.wp-scripts.php                                                                                
 ------ -------------------------------------------------------------------------------------------------------- 
  144    Parameter #1 $string of function trim expects string, string|null given.                                
         🪪  argument.type                                                                                       
         at src/wp-includes/functions.wp-scripts.php:144                                                         
  181    Function wp_register_script() has parameter $args with no value type specified in iterable type array.  
         🪪  missingType.iterableValue                                                                           
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type              
         at src/wp-includes/functions.wp-scripts.php:181                                                         
  230    Function wp_localize_script() has parameter $l10n with no value type specified in iterable type array.  
         🪪  missingType.iterableValue                                                                           
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type              
         at src/wp-includes/functions.wp-scripts.php:230                                                         
  366    Function wp_enqueue_script() has parameter $args with no value type specified in iterable type array.   
         🪪  missingType.iterableValue                                                                           
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type              
         at src/wp-includes/functions.wp-scripts.php:366                                                         
 ------ -------------------------------------------------------------------------------------------------------- 

 ------ ------------------------------------------------------------------------------------------------------------------------------------ 
  Line   functions.wp-styles.php                                                                                                             
 ------ ------------------------------------------------------------------------------------------------------------------------------------ 
  44     Function wp_print_styles() has parameter $handles with no value type specified in iterable type array.                              
         🪪  missingType.iterableValue                                                                                                       
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                          
         at src/wp-includes/functions.wp-styles.php:44                                                                                       
  68     Parameter #1 $handles of method WP_Dependencies::do_items() expects array<string>|string|false, array|bool|non-empty-string given.  
         🪪  argument.type                                                                                                                   
         at src/wp-includes/functions.wp-styles.php:68                                                                                       
  101    Parameter #1 $string of function trim expects string, string|null given.                                                            
         🪪  argument.type                                                                                                                   
         at src/wp-includes/functions.wp-styles.php:101                                                                                      
 ------ ------------------------------------------------------------------------------------------------------------------------------------ 

 ------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ 
  Line   script-loader.php                                                                                                                                                             
 ------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ 
  133    Offset                                                                                                                                                                        
         0|1|2|3|4|5|6|7|8|9|10|11|12|'lodash'|'moment'|'react'|'react-dom'|'react-jsx-runtime'|'regenerator-runtime'|'wp-polyfill'|'wp-polyfill-dom-rect'|'wp-polyfill-element…'|'wp  
         -polyfill-fetch'|'wp-polyfill-formdata'|'wp-polyfill-inert'|'wp-polyfill-node…'|'wp-polyfill-object…'|'wp-polyfill-url' might not exist on array{react: '18.3.1.1',           
         react-dom: '18.3.1.1', react-jsx-runtime: '18.3.1', regenerator-runtime: '0.14.1', moment: '2.30.1', lodash: '4.17.21', wp-polyfill-fetch: '3.6.20', wp-polyfill-formdata:    
         '4.0.10', ...}.                                                                                                                                                               
         🪪  offsetAccess.notFound                                                                                                                                                     
         at src/wp-includes/script-loader.php:133                                                                                                                                      
  135    Parameter #1 $handle of method WP_Dependencies::add() expects string, int|string given.                                                                                       
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:135                                                                                                                                      
  191    Parameter #1 $haystack of function str_starts_with expects string, string|false given.                                                                                        
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:191                                                                                                                                      
  191    Parameter #2 $subject of function preg_match expects string, string|false given.                                                                                              
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:191                                                                                                                                      
  700    Variable $wp_version might not be defined.                                                                                                                                    
         🪪  variable.undefined                                                                                                                                                        
         at src/wp-includes/script-loader.php:700                                                                                                                                      
  1089   Parameter #1 $string of function strtolower expects string, string|false given.                                                                                               
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:1089                                                                                                                                     
  1564   Variable $wp_version might not be defined.                                                                                                                                    
         🪪  variable.undefined                                                                                                                                                        
         at src/wp-includes/script-loader.php:1564                                                                                                                                     
  1608   Parameter #2 $src of method WP_Dependencies::add() expects string|false, true given.                                                                                          
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:1608                                                                                                                                     
  1907   Parameter #2 $offset of function array_splice expects int, int|string given.                                                                                                  
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:1907                                                                                                                                     
  2083   Function wp_style_loader_src() should return string|false but returns string|null.                                                                                            
         🪪  return.type                                                                                                                                                               
         at src/wp-includes/script-loader.php:2083                                                                                                                                     
  2357   Function print_late_styles() return type has no value type specified in iterable type array.                                                                                  
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2357                                                                                                                                     
  2514   Function wp_filter_out_block_nodes() has parameter $nodes with no value type specified in iterable type array.                                                                
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2514                                                                                                                                     
  2514   Function wp_filter_out_block_nodes() return type has no value type specified in iterable type array.                                                                          
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2514                                                                                                                                     
  2875   Function wp_sanitize_script_attributes() has parameter $attributes with no value type specified in iterable type array.                                                       
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2875                                                                                                                                     
  2907   Function wp_get_script_tag() has parameter $attributes with no value type specified in iterable type array.                                                                   
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2907                                                                                                                                     
  2939   Function wp_print_script_tag() has parameter $attributes with no value type specified in iterable type array.                                                                 
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2939                                                                                                                                     
  2955   Function wp_get_inline_script_tag() has parameter $attributes with no value type specified in iterable type array.                                                            
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:2955                                                                                                                                     
  3043   Function wp_print_inline_script_tag() has parameter $attributes with no value type specified in iterable type array.                                                          
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:3043                                                                                                                                     
  3081   Call to an undefined method object::get_data().                                                                                                                               
         🪪  method.notFound                                                                                                                                                           
         at src/wp-includes/script-loader.php:3081                                                                                                                                     
  3099   Parameter #1 $array of function usort contains unresolvable type.                                                                                                             
         🪪  argument.unresolvableType                                                                                                                                                 
         at src/wp-includes/script-loader.php:3099                                                                                                                                     
  3100   Parameter #2 $callback of function usort contains unresolvable type.                                                                                                          
         🪪  argument.unresolvableType                                                                                                                                                 
         at src/wp-includes/script-loader.php:3100                                                                                                                                     
  3128   Parameter #1 $css of function _wp_normalize_relative_css_links expects string, string|false given.                                                                            
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:3128                                                                                                                                     
  3158   Function _wp_normalize_relative_css_links() should return string but returns string|null.                                                                                     
         🪪  return.type                                                                                                                                                               
         at src/wp-includes/script-loader.php:3158                                                                                                                                     
  3244   Function wp_enqueue_stored_styles() has parameter $options with no value type specified in iterable type array.                                                               
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:3244                                                                                                                                     
  3318   Function wp_enqueue_block_style() has parameter $args with no value type specified in iterable type array.                                                                    
         🪪  missingType.iterableValue                                                                                                                                                 
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type                                                                                    
         at src/wp-includes/script-loader.php:3318                                                                                                                                     
  3756   Parameter #3 $priority of function remove_action expects int, int|true given.                                                                                                 
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:3756                                                                                                                                     
  3763   Parameter #3 $priority of function add_action expects int, int|true given.                                                                                                    
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:3763                                                                                                                                     
  3846   Parameter #1 $text of method WP_HTML_Tag_Processor@anonymous/script-loader.php:3773::insert_after() expects string, string|false given.                                       
         🪪  argument.type                                                                                                                                                             
         at src/wp-includes/script-loader.php:3846                                                                                                                                     
 ------ ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ 

 [ERROR] Found 35 errors                                                                                                

[westonruter]

In 61397:

Script Loader: Fix adding default version to script/style URL when args are supplied via enqueued handle.

Also fixes phpdoc for some member variables of WP_Scripts and WP_Styles.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10608

Follow-up to [61358].

Props westonruter, peterwilsoncc.
See #64224, #64238.
Fixes #64372.

This PR addresses the following issues PHPStan ​level 8 issues:

phpstan analyze --memory-limit=4G --level=8 src/wp-includes/functions.wp-styles.php src/wp-includes/functions.wp-scripts.php

Before:

Note: Using configuration file /Users/westonruter/repos/wordpress-develop/phpstan.neon.
 2/2 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%

 ------ --------------------------------------------------------------------------------------------------------
  Line   functions.wp-scripts.php
 ------ --------------------------------------------------------------------------------------------------------
  144    Parameter #1 $string of function trim expects string, string|null given.
         🪪  argument.type
  181    Function wp_register_script() has parameter $args with no value type specified in iterable type array.
         🪪  missingType.iterableValue
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type
  230    Function wp_localize_script() has parameter $l10n with no value type specified in iterable type array.
         🪪  missingType.iterableValue
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type
  366    Function wp_enqueue_script() has parameter $args with no value type specified in iterable type array.
         🪪  missingType.iterableValue
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type
 ------ --------------------------------------------------------------------------------------------------------

 ------ ------------------------------------------------------------------------------------------------------------------------------------
  Line   functions.wp-styles.php
 ------ ------------------------------------------------------------------------------------------------------------------------------------
  44     Function wp_print_styles() has parameter $handles with no value type specified in iterable type array.
         🪪  missingType.iterableValue
         💡  See: https://phpstan.org/blog/solving-phpstan-no-value-type-specified-in-iterable-type
  68     Parameter #1 $handles of method WP_Dependencies::do_items() expects array<string>|string|false, array|bool|non-empty-string given.
         🪪  argument.type
  101    Parameter #1 $string of function trim expects string, string|null given.
         🪪  argument.type
 ------ ------------------------------------------------------------------------------------------------------------------------------------

After:

[OK] No errors

Trac ticket: https://core.trac.wordpress.org/ticket/64238

[westonruter]

In 61402:

Docs: Improve specificity of PHP types in functions.wp-scripts.php and functions.wp-styles.php.

These files now adhere to PHPStan level 8.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10652

Follow-up to [61362], [61358].

See #64238.

Committed in r61402

[westonruter]

In 61425:

Script Loader: Simplify data structure in wp_default_packages_vendor() to facilitate static analysis.

This resolves two PHPStan level 7 issues: offsetAccess.notFound and argument.type.

Follow-up to [44114].

See #64238, #45065.

[westonruter]

In 61426:

Script Loader: Add types for arrays in phpdoc.

This resolves 10 missingType.iterableValue issues in PHPStan.

Follow-up to [61402], [61362], [61358].

See #64224, #64238.

[westonruter]

In 61642:

Code Quality: Remove unused WP_Block_Bindings_Registry::$supported_blocks private member variable.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10912

Follow-up to [59080], [57641].

Props soean.
See #64238, #61642.
Fixes #64633.

The commits in this PR were cherry-picked from ​https://github.com/WordPress/wordpress-develop/pull/10419 for Core-61175.

Trac ticket: https://core.trac.wordpress.org/ticket/64238

## Use of AI Tools

n/a

@sabernhardt Would you review when you get a chance?

The changes in this PR were cherry-picked (e.g. 2f724070eca10d8503c6453732cbc9131d7da010 and 22370b6a9783ed0bd56c9b1b731617b8b9cedcbf) from ​https://github.com/WordPress/wordpress-develop/pull/10419 for Core-61175.

Trac ticket: https://core.trac.wordpress.org/ticket/64238

## Use of AI Tools

n/a

The commits in this PR were cherry-picked from ​https://github.com/WordPress/wordpress-develop/pull/10419 for Core-61175.

See ​https://github.com/WordPress/wordpress-develop/pull/10419#issuecomment-3911582777:

I also got to the bottom of the issue with wp_insert_user() causing PHPStan to hang. Or at least, I think I did. The issue is that PHPStan couldn't figure out what $userdata's type was. So in 77d9403...512e368 I've ensured that $userdata always is a string, and I went the extra mile to ensure back-compat for passing in unexpected values to that function.

Trac ticket: https://core.trac.wordpress.org/ticket/64238

## Use of AI Tools

n/a

@peterwilsoncc Hey! I'm requesting your review because this appears to have been related to your commit in r60650.

@peterwilsoncc thank you. My guess is that 99.99999% of the time, a array|stdClass|WP_User is passed in. But I can imagine someone wanting to pass in an array-like object for the sake of lazy-loading. So I wanted to be sure this didn't break anything.

It's also true that PHPStan probably shouldn't be struggling so hard here. But I still think this is an overall improvement since it improves type safety, ensuring that down the road the function is guaranteed to always be working with an array as it expects to be.

@justlevine Would you give this a review for me?

[westonruter]

In 61656:

Users: Ensure user data supplied to wp_insert_user() is normalized to an array.

This fixes an issue where PHPStan hangs when analyzing the containing users.php file.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10953

Follow-up to [60650].

Props westonruter, justlevine, peterwilsoncc.
See #64238, #61175.

Committed in r61656 (297771e887699386de70ed087147c2bf3b42bd28).

@sabernhardt anything else you'd like revised?

[westonruter]

In 61670:

Customize: Ensure WP_Customize_Setting::update() and subclass overrides return consistent types.

This addresses PHPStan type check issues.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10952

Props westonruter, peterwilsoncc, justlevine.
See #64238, #61175.

Committed in r61670 (ff7564a)

[westonruter]

Once #61175 is closed with PHPStan support in core, we should follow up with the following change for is_wp_error():

src/wp-includes/load.php

@@ -1796 +1796 @@
  *
  * @since 2.1.0
  *
+ * @phpstan-assert-if-true WP_Error $thing
+ *
  * @param mixed $thing The variable to check.
  * @return bool Whether the variable is an instance of WP_Error.
  */

This ensures conditionals are understood correctly by PHPStan. For example, it fixes an error in this function:

<?php
function wp_remote_retrieve_headers( $response ) {
        if ( is_wp_error( $response ) || ! isset( $response['headers'] ) ) {
                return array();
        }

        return $response['headers'];
}

phpstan: Cannot access offset 'headers' on array|WP_Error.

I have nothing further.

[westonruter]

In 61676:

Themes: Fix type issues in core themes and remove PHPStan suppression comments.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10951

Props westonruter, sabernhardt, justlevine.
See #64238, #61175.

Committed in r61676 (265fbb4c71e5d07ce26ae051d55601e94626cc1f)

[westonruter]

Another patch we should land to improve static analysis:

src/wp-includes/comment.php

@@ -217 +217 @@
  *                                       correspond to a WP_Comment object, an associative array, or a numeric array,
  *                                       respectively. Default OBJECT.
  * @return WP_Comment|array|null Depends on $output value.
+ * @phpstan-return (
+ *     $output is 'ARRAY_A' ? non-empty-array<string, mixed>
+ *                          : ( $output is 'ARRAY_N' ? non-empty-array<int, mixed>
+ *                                                   : WP_Comment|null ) )
  */
 function get_comment( $comment = null, $output = OBJECT ) {
         if ( empty( $comment ) && isset( $GLOBALS['comment'] ) ) {

src/wp-includes/post.php

@@ -1640 +1640 @@
  *                               element from the array needs to match; 'and' means all elements
  *                               must match; 'not' means no elements may match. Default 'and'.
  * @return string[]|WP_Post_Type[] An array of post type names or objects.
+ * @phpstan-return ( $output is 'names' ? string[] : WP_Post_Type[] )
  */
 function get_post_types( $args = array(), $output = 'names', $operator = 'and' ) {
         global $wp_post_types;

That first change is for get_comment() and a similar change could be made for get_post().

[westonruter]

In 61699:

Build/Test Tools: Integrate PHPStan into the core development workflow.

This change introduces PHPStan static analysis configured at ​rule level 0, which includes: "basic checks, unknown classes, unknown functions, unknown methods called on $this, wrong number of arguments passed to those methods and functions, always undefined variables". Contributors may elect for a higher PHPStan rule level by creating a phpstan.neon which overrides phpstan.neon.dist.

• Fix various PHPStan level 0 errors by adding @phpstan-ignore comments, updating PHPDoc types, and adding missing return values.
• Remove existing @phpstan-ignore comments that are now obsolete or inapplicable for level 0.
• Add a new GitHub Actions workflow for PHPStan Static Analysis. Reports are currently provided as warnings with inline annotations in pull requests and do not fail the build.
• Add a phpstan Grunt task and include it in the precommit:php task to run before phpunit.
• Introduce a typecheck:php npm script and a composer phpstan script to run analysis in local development environments.
• Add documentation for PHPStan usage in tests/phpstan/README.md.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10419

Props justlevine, westonruter, johnbillion, desrosj, SirLouen, dmsnell, oglekler, joehoyle, jorbin.
See #64238, #63268, #52217, #51423.
Fixes #61175.

This was _not_ committed yet.

This was _not_ committed yet.

The @return tags for these functions indicate they may return null.
This fixes "Missing return argument" warnings that PHPStan (level 1) and IDEs report when a bare return; is used in a function documented to return a typed value including null.

## Affected Functions and Files

• WP_Filesystem() in wp-admin/includes/file.php
• delete_plugins() in wp-admin/includes/plugin.php (2 occurrences)
• delete_theme() in wp-admin/includes/theme.php (2 occurrences)
• get_category_by_path() in wp-includes/category.php

## Details

In each case, the function's @return tag already documents null as a possible return value (e.g. @return bool|null|WP_Error), but the early exit paths used a bare return;, which implicitly returns void.

Related: Trac #64238

Related: ​https://github.com/WordPress/wordpress-develop/pull/8965

LGTM

Note: These fix PHPStan rule level 3 issues.

[westonruter]

In 61716:

Code Quality: Explicitly return null when documented instead of void.

This fixes a PHPStan rule level 3 error: return.empty.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10995

Props huzaifaalmesbah, westonruter, shailu25, mukesh27, noruzzaman.
See #64238.

Committed in r61716 (954c187)

[westonruter]

In 61719:

Code Quality: Return null instead of void in paginate_links().

Developed in ​https://github.com/WordPress/wordpress-develop/pull/10999

Follow-up to r32598.

Props apermo, mukesh27, westonruter
See #64238.
Fixes #64694.

This fixes a few PHPStan "variable might not be defined" warnings..
Changes:

• src/wp-admin/includes/menu.php: Added the global declaration for $menu, $submenu, and $compat.
• src/wp-admin/includes/network.php: Initialized the $message and $message_class variables to prevent them from being undefined when the condition isn't met.

Trac: https://core.trac.wordpress.org/ticket/64238

This PR addresses strict type return.empty violations reported by PHPStan, ensuring methods return their declared or documented types rather than relying on an empty return;.

Details

• src/wp-includes/class-wp-query.php (WP_Query::setup_postdata):
  • Updated the PHPDoc to reflect that the method can return both true (success) and false (failure).
  • Replaced the early empty return; bail-outs with return false; when the post object is invalid or when generate_postdata() fails.
• src/wp-includes/theme.php (_remove_theme_support):
  • Replaced an empty return; inside the custom-header-uploads backward compatibility fallback with return true;. This matches the documented bool return type to indicate the feature support was successfully removed.
  Why this is needed

Using empty return; statements in methods/functions that have a declared or documented non-void return type causes static analysis tooling (like PHPStan) to flag them as errors. Returning explicit boolean values improves strict typing constraints and code clarity.

Trac ticket: https://core.trac.wordpress.org/ticket/64238

## Use of AI Tools
Use For PR Content.

[SergeyBiryukov]

In 61721:

Code Quality: Correct return statement in _remove_theme_support().

This matches the documented bool return type to indicate the feature support was successfully removed.

Follow-up to [20212].

Props huzaifaalmesbah.
See #64238.

[SergeyBiryukov]

In 61727:

Code Quality: Correct return statement in WP_Query::setup_postdata().

This reflects that the method can return both true (success) and false (failure).

Follow-up to [32620], [34089], [44941].

Props huzaifaalmesbah, westonruter.
See #64238.

Thanks for the PR! Merged in r61721 and r61727.

[SergeyBiryukov]

In 61753:

Code Quality: Initialize $message and $message_class in network_step1().

This prevents the variables from being undefined when the condition isn't met.

Follow-up to [56599].

Props huzaifaalmesbah, noruzzaman.
See #64238.

[westonruter]

In 61766:

Code Quality: Replace void with null in union return types in link-template.php.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11004

Follow-up to r61719, r61716, r32598.

Props apermo, xate, westonruter, noruzzaman.
See #64694, #64238.
Fixes #64699.

[westonruter]

In 61767:

Code Quality: Replace void with null in union return types in Customizer classes.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11006

Follow-up to r61766, r61719, r61716.

Props apermo, xate, mukesh27.
See #64238.
Fixes #64701.

[westonruter]

In 61768:

Code Quality: Replace void with null in union return types in general-template.php.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11005

Follow-up to r61767, r61766, r61719, r61716, r53300, r32598.

Props apermo, xate, mukesh27.
See #64238.
Fixes #64700.

This reduces the number of PHPStan errors at level 7 from 14,271 to 13,233 (-1,038 or -7.27%). See ​error report diff.

Trac ticket: https://core.trac.wordpress.org/ticket/64238

## Use of AI Tools

n/a

[westonruter]

In 61774:

Code Quality: Add @phpstan-assert-if-true to is_wp_error().

This ensures PHPStan is aware that passing a WP_Error instance to is_wp_error() will cause the function to return true. This reduces the total number of PHPStan errors at rule level 7 from 14,271 to 13,233 (-1,038 or -7.27%).

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11095

See #64238.

Committed in r61774 (b00dde1)

Trac ticket: https://core.trac.wordpress.org/ticket/64238

## Use of AI Tools

n/a

[rahultank]

Reviewed ticket #64238 — PHPStan code quality improvements for WP 7.0 (March 2026).

This is a tracked aggregate ticket for PHPStan-surfaced issues. It has 30+ commits already merged. Reviewed scope of remaining work:

• The ticket targets various type safety issues, null handling, and union type corrections across Core files
• PHPStan analysis surfaced issues in: taxonomy, screen handling, REST API, and general WordPress functions
• Unit tests are included with each fix (has-unit-tests keyword)

Latest PR: ​https://github.com/WordPress/wordpress-develop/pull/11096
PR scope:

Code quality improvements of this kind reduce PHP 8.x deprecation notices and improve static analysis confidence. The pattern of changes (fixing void return types, null coalescing, and union return types) is consistent across all sub-fixes.

This approach aligns with the PHP 8.5 compatibility goals also tracked for 7.0. Confirming the pattern of fixes is sound and follows WordPress coding standards.

[westonruter]

In 61789:

Code Quality: Normalize object as type being supplied as comment, post, site, term, and user.

When constructing these objects, the specific instance type is redundantly used in a union with a generic object. A generic object can be passed directly from database row result. This also hardens get_post() to account for passing an object that lacks an ID property. Similarly, sanitize_term() is hardened to account for an object lacking a term_id property. Comprehensive unit tests are added for get_post() and sanitize_term().

Developed in ​https://github.com/WordPress/wordpress-develop/pull/11096

Props westonruter, apermo.
See #64238, #64225.

Committed in r61789 (f997e86)

[SergeyBiryukov]

In 61853:

Code Quality: Explicitly globalize admin menu variables to avoid PHPStan warnings.

Follow-up to [15481].

Props huzaifaalmesbah, noruzzaman.
See #64238.