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

Timestamp:

11/25/2025 01:58:14 AM (7 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-rewrite.php (modified) (4 diffs)

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

@@ -53 +53 @@
      *
      * @since 1.5.0
+     * @var ?string
+     */
+    public $author_structure;
+
+    /**
+     * Permalink structure for date archives.
+     *
+     * @since 1.5.0
+     * @var ?string
+     */
+    public $date_structure;
+
+    /**
+     * Permalink structure for pages.
+     *
+     * @since 1.5.0
+     * @var ?string
+     */
+    public $page_structure;
+
+    /**
+     * Base of the search permalink structure (example.com/$search_base/query).
+     *
+     * @since 1.5.0
      * @var string
      */
-    public $author_structure;
-
-    /**
-     * Permalink structure for date archives.
-     *
-     * @since 1.5.0
-     * @var string
-     */
-    public $date_structure;
-
-    /**
-     * Permalink structure for pages.
-     *
-     * @since 1.5.0
-     * @var string
-     */
-    public $page_structure;
-
-    /**
-     * Base of the search permalink structure (example.com/$search_base/query).
-     *
-     * @since 1.5.0
-     * @var string
-     */
     public $search_base = 'search';
 
@@ -85 +85 @@
      *
      * @since 1.5.0
-     * @var string
+     * @var ?string
      */
     public $search_structure;
@@ -125 +125 @@
      *
      * @since 1.5.0
-     * @var string
+     * @var ?string
      */
     public $comment_feed_structure;
@@ -133 +133 @@
      *
      * @since 1.5.0
-     * @var string
+     * @var ?string
      */
     public $feed_structure;