Changeset 61299 for trunk/src/wp-includes/class-wp-query.php

Timestamp:

11/25/2025 01:58:14 AM (11 months ago)

Author:

westonruter

Message:

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.

File:

• trunk/src/wp-includes/class-wp-query.php (modified) (7 diffs)

trunk/src/wp-includes/class-wp-query.php

@@ -23 +23 @@
          *
          * @since 1.5.0
-         * @var array
+         * @var ?array
          */
         public $query;
@@ -73 +73 @@
          *
          * @since 1.5.0
-         * @var int
+         * @var ?int
          */
         public $queried_object_id;
@@ -81 +81 @@
          *
          * @since 2.0.1
-         * @var string
+         * @var ?string
          */
         public $request;
@@ -89 +89 @@
          *
          * @since 1.5.0
-         * @var WP_Post[]|int[]
+         * @var WP_Post[]|int[]|null
          */
         public $posts;
@@ -140 +140 @@
          *
          * @since 2.2.0
-         * @var WP_Comment[]
+         * @var ?WP_Comment[]
          */
         public $comments;
@@ -164 +164 @@
          *
          * @since 2.2.0
-         * @var WP_Comment
+         * @var ?WP_Comment
          */
         public $comment;
@@ -467 +467 @@
          *
          * @since 3.7.0
-         * @var array
+         * @var ?array
          */
         private $stopwords;