Ticket #40201: 40201.diff

src/wp-includes/ms-blogs.php

@@ -258 +258 @@
  * Clear the blog details cache.
  *
  * @since MU (3.0.0)
+ * @deprecated 4.9.0 Use clean_blog_cache()
+ * @see clean_blog_cache()
  *
  * @param int $blog_id Optional. Blog ID. Defaults to current blog.
  */
 function refresh_blog_details( $blog_id = 0 ) {
+        _deprecated_function( __FUNCTION__, '4.9.0', 'clean_blog_cache()' );
+
         $blog_id = (int) $blog_id;
         if ( ! $blog_id ) {
                 $blog_id = get_current_blog_id();
         }
 
-        $details = get_site( $blog_id );
-        if ( ! $details ) {
-                // Make sure clean_blog_cache() gets the blog ID
-                // when the blog has been previously cached as
-                // non-existent.
-                $details = (object) array(
-                        'blog_id' => $blog_id,
-                        'domain' => null,
-                        'path' => null
-                );
-        }
-
-        clean_blog_cache( $details );
-
-        /**
-         * Fires after the blog details cache is cleared.
-         *
-         * @since 3.4.0
-         *
-         * @param int $blog_id Blog ID.
-         */
-        do_action( 'refresh_blog_details', $blog_id );
+        clean_blog_cache( $blog_id );
 }
 
 /**
@@ -445 +428 @@
  *
  * @global bool $_wp_suspend_cache_invalidation
  *
- * @param WP_Site $blog The site object to be cleared from cache.
+ * @param WP_Site|int $blog The site object or ID to be cleared from cache.
  */
 function clean_blog_cache( $blog ) {
         global $_wp_suspend_cache_invalidation;
@@ -454 +437 @@
                 return;
         }
 
+        if ( is_numeric( $blog ) ) {
+                $blog_id = $blog;
+                $blog = get_site( $blog_id );
+                if ( ! $blog ) {
+                        // Make sure a WP_Site object exists even when the site has been deleted.
+                        $blog = new WP_Site( (object) array(
+                                'blog_id' => $blog_id,
+                                'domain'  => null,
+                                'path'    => null,
+                        ) );
+                }
+        }
+
         $blog_id = $blog->blog_id;
         $domain_path_key = md5( $blog->domain . $blog->path );
 
@@ -478 +474 @@
         do_action( 'clean_site_cache', $blog_id, $blog, $domain_path_key );
 
         wp_cache_set( 'last_changed', microtime(), 'sites' );
+
+        /**
+         * Fires after the blog details cache is cleared.
+         *
+         * @since 3.4.0
+         * @deprecated 4.9.0 Use clean_site_cache
+         *
+         * @param int $blog_id Blog ID.
+         */
+        do_action_deprecated( 'refresh_blog_details', array( $blog_id ), '4.9.0', 'clean_site_cache' );
 }
 
 /**