Changeset 61299 for trunk/src/wp-includes/class-wp-theme.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-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;