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

Timestamp:

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

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

@@ -115 +115 @@
      *
      * @since 3.4.0
-     * @var array
+     * @var ?array
      */
     private $headers_sanitized;
@@ -123 +123 @@
      *
      * @since 6.2.0
-     * @var bool
+     * @var ?bool
      */
     private $block_theme;
@@ -133 +133 @@
      *
      * @since 3.4.0
-     * @var string
+     * @var ?string
      */
     private $name_translated;
@@ -141 +141 @@
      *
      * @since 3.4.0
-     * @var WP_Error
+     * @var ?WP_Error
      */
     private $errors;
@@ -163 +163 @@
      *
      * @since 3.4.0
+     * @var ?string
+     */
+    private $template;
+
+    /**
+     * A reference to the parent theme, in the case of a child theme.
+     *
+     * @since 3.4.0
+     * @var ?WP_Theme
+     */
+    private $parent;
+
+    /**
+     * URL to the theme root, usually an absolute URL to wp-content/themes
+     *
+     * @since 3.4.0
+     * @var ?string
+     */
+    private $theme_root_uri;
+
+    /**
+     * Flag for whether the theme's textdomain is loaded.
+     *
+     * @since 3.4.0
+     * @var ?bool
+     */
+    private $textdomain_loaded;
+
+    /**
+     * Stores an md5 hash of the theme root, to function as the cache key.
+     *
+     * @since 3.4.0
      * @var string
      */
-    private $template;
-
-    /**
-     * A reference to the parent theme, in the case of a child theme.
-     *
-     * @since 3.4.0
-     * @var WP_Theme
-     */
-    private $parent;
-
-    /**
-     * URL to the theme root, usually an absolute URL to wp-content/themes
-     *
-     * @since 3.4.0
-     * @var string
-     */
-    private $theme_root_uri;
-
-    /**
-     * Flag for whether the theme's textdomain is loaded.
-     *
-     * @since 3.4.0
-     * @var bool
-     */
-    private $textdomain_loaded;
-
-    /**
-     * Stores an md5 hash of the theme root, to function as the cache key.
-     *
-     * @since 3.4.0
-     * @var string
-     */
     private $cache_hash;
 
@@ -203 +203 @@
      *
      * @since 6.4.0
-     * @var string[]
+     * @var ?string[]
      */
     private $block_template_folders;