Multisite: Introduce the WP_Site class.
* A `WP_Site` object initially matches a row from `wp_blogs`. * A site can be retrieved by its ID through `WP_Site::get_instance()`. * Adds `sites` to the global cache group and captures instance lookups. * The multisite bootstrap now ensures `$current_blog` is an instance of `WP_Site`. Props johnjamesjacoby, jeremyfelt. See #32450. Built from https://develop.svn.wordpress.org/trunk@36393 git-svn-id: http://core.svn.wordpress.org/trunk@36360 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
f3c20d5011
commit
0b69f2cd63
|
@ -0,0 +1,200 @@
|
||||||
|
<?php
|
||||||
|
/**
|
||||||
|
* Site API: WP_Site class
|
||||||
|
*
|
||||||
|
* @package WordPress
|
||||||
|
* @subpackage Multisite
|
||||||
|
* @since 4.5.0
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Core class used for interacting with a multisite site.
|
||||||
|
*
|
||||||
|
* This class is used during load to populate the `$current_blog` global and
|
||||||
|
* setup the current site.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
*/
|
||||||
|
final class WP_Site {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Site ID.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $blog_id;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Domain of the site.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $domain = '';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Path of the site.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $path = '';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The ID of the site's parent network.
|
||||||
|
*
|
||||||
|
* Named "site" vs. "network" for legacy reasons. An individual site's "site" is
|
||||||
|
* its network.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $site_id = '0';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The date on which the site was created or registered.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string Date in MySQL's datetime format.
|
||||||
|
*/
|
||||||
|
public $registered = '0000-00-00 00:00:00';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The date and time on which site settings were last updated.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string Date in MySQL's datetime format.
|
||||||
|
*/
|
||||||
|
public $last_updated = '0000-00-00 00:00:00';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the site should be treated as public.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $public = '1';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the site should be treated as archived.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $archived = '0';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the site should be treated as mature.
|
||||||
|
*
|
||||||
|
* Handling for this does not exist throughout WordPress core, but custom
|
||||||
|
* implementations exist that require the property to be present.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $mature = '0';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the site should be treated as spam.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $spam = '0';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether the site should be treated as deleted.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $deleted = '0';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The language pack associated with this site.
|
||||||
|
*
|
||||||
|
* A numeric string, for compatibility reasons.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
* @var string
|
||||||
|
*/
|
||||||
|
public $lang_id = '0';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Retrieve a site from the database by its ID.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
*
|
||||||
|
* @global wpdb $wpdb WordPress database abstraction object.
|
||||||
|
*
|
||||||
|
* @param int $site_id The ID of the site to retrieve.
|
||||||
|
* @return WP_Site|bool The site's object if found. False if not.
|
||||||
|
*/
|
||||||
|
public static function get_instance( $site_id ) {
|
||||||
|
global $wpdb;
|
||||||
|
|
||||||
|
$site_id = (int) $site_id;
|
||||||
|
if ( ! $site_id ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
$_site = wp_cache_get( $site_id, 'sites' );
|
||||||
|
|
||||||
|
if ( ! $_site ) {
|
||||||
|
$_site = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$wpdb->blogs} WHERE blog_id = %d LIMIT 1", $site_id ) );
|
||||||
|
|
||||||
|
if ( empty( $_site ) || is_wp_error( $_site ) ) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
wp_cache_add( $site_id, $_site, 'sites' );
|
||||||
|
}
|
||||||
|
|
||||||
|
return new WP_Site( $_site );
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create a new WP_Site object.
|
||||||
|
*
|
||||||
|
* Will populate object properties from the object provided and assign other
|
||||||
|
* default properties based on that information.
|
||||||
|
*
|
||||||
|
* @since 4.5.0
|
||||||
|
* @access public
|
||||||
|
*
|
||||||
|
* @param WP_Site|object $site A site object.
|
||||||
|
*/
|
||||||
|
public function __construct( $site ) {
|
||||||
|
foreach( get_object_vars( $site ) as $key => $value ) {
|
||||||
|
$this->$key = $value;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -210,7 +210,7 @@ function get_blog_details( $fields = null, $get_all = true ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
if ( empty($details) ) {
|
if ( empty($details) ) {
|
||||||
$details = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->blogs WHERE blog_id = %d /* get_blog_details */", $blog_id ) );
|
$details = WP_Site::get_instance( $blog_id );
|
||||||
if ( ! $details ) {
|
if ( ! $details ) {
|
||||||
// Set the full cache.
|
// Set the full cache.
|
||||||
wp_cache_set( $blog_id, -1, 'blog-details' );
|
wp_cache_set( $blog_id, -1, 'blog-details' );
|
||||||
|
@ -218,6 +218,10 @@ function get_blog_details( $fields = null, $get_all = true ) {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if ( ! $details instanceof WP_Site ) {
|
||||||
|
$details = new WP_Site( $details );
|
||||||
|
}
|
||||||
|
|
||||||
if ( ! $get_all ) {
|
if ( ! $get_all ) {
|
||||||
wp_cache_set( $blog_id . $all, $details, 'blog-details' );
|
wp_cache_set( $blog_id . $all, $details, 'blog-details' );
|
||||||
return $details;
|
return $details;
|
||||||
|
@ -442,6 +446,7 @@ function clean_blog_cache( $blog ) {
|
||||||
$blog_id = $blog->blog_id;
|
$blog_id = $blog->blog_id;
|
||||||
$domain_path_key = md5( $blog->domain . $blog->path );
|
$domain_path_key = md5( $blog->domain . $blog->path );
|
||||||
|
|
||||||
|
wp_cache_delete( $blog_id, 'sites' );
|
||||||
wp_cache_delete( $blog_id , 'blog-details' );
|
wp_cache_delete( $blog_id , 'blog-details' );
|
||||||
wp_cache_delete( $blog_id . 'short' , 'blog-details' );
|
wp_cache_delete( $blog_id . 'short' , 'blog-details' );
|
||||||
wp_cache_delete( $domain_path_key, 'blog-lookup' );
|
wp_cache_delete( $domain_path_key, 'blog-lookup' );
|
||||||
|
@ -655,7 +660,7 @@ function switch_to_blog( $new_blog, $deprecated = null ) {
|
||||||
if ( is_array( $global_groups ) ) {
|
if ( is_array( $global_groups ) ) {
|
||||||
wp_cache_add_global_groups( $global_groups );
|
wp_cache_add_global_groups( $global_groups );
|
||||||
} else {
|
} else {
|
||||||
wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'useremail', 'userslugs', 'site-transient', 'site-options', 'site-lookup', 'blog-lookup', 'blog-details', 'rss', 'global-posts', 'blog-id-cache', 'networks' ) );
|
wp_cache_add_global_groups( array( 'users', 'userlogins', 'usermeta', 'user_meta', 'useremail', 'userslugs', 'site-transient', 'site-options', 'site-lookup', 'blog-lookup', 'blog-details', 'rss', 'global-posts', 'blog-id-cache', 'networks', 'sites' ) );
|
||||||
}
|
}
|
||||||
wp_cache_add_non_persistent_groups( array( 'comment', 'counts', 'plugins' ) );
|
wp_cache_add_non_persistent_groups( array( 'comment', 'counts', 'plugins' ) );
|
||||||
}
|
}
|
||||||
|
|
|
@ -13,6 +13,9 @@
|
||||||
/** WP_Network class */
|
/** WP_Network class */
|
||||||
require_once( ABSPATH . WPINC . '/class-wp-network.php' );
|
require_once( ABSPATH . WPINC . '/class-wp-network.php' );
|
||||||
|
|
||||||
|
/** WP_Site class */
|
||||||
|
require_once( ABSPATH . WPINC . '/class-wp-site.php' );
|
||||||
|
|
||||||
/** Multisite loader */
|
/** Multisite loader */
|
||||||
require_once( ABSPATH . WPINC . '/ms-load.php' );
|
require_once( ABSPATH . WPINC . '/ms-load.php' );
|
||||||
|
|
||||||
|
@ -222,5 +225,9 @@ if ( ! $current_site instanceof WP_Network ) {
|
||||||
$current_site = new WP_Network( $current_site );
|
$current_site = new WP_Network( $current_site );
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if ( ! $current_blog instanceof WP_Site ) {
|
||||||
|
$current_blog = new WP_Site( $current_blog );
|
||||||
|
}
|
||||||
|
|
||||||
// Define upload directory constants
|
// Define upload directory constants
|
||||||
ms_upload_constants();
|
ms_upload_constants();
|
||||||
|
|
|
@ -4,7 +4,7 @@
|
||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '4.5-alpha-36392';
|
$wp_version = '4.5-alpha-36393';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||||
|
|
Loading…
Reference in New Issue