WP_Site::get_instance( int $site_id )

Retrieves a site from the database by its ID.

Parameters

$site_id

(Required) The ID of the site to retrieve.

Return

(WP_Site|false) The site's object if found. False if not.

Source

File: wp-includes/class-wp-site.php 

	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 );
	}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/class-wp-site.php: WP_Site::__construct()

Creates a new WP_Site object.
wp-includes/wp-db.php: wpdb::get_row()

Retrieve one row from the database.
wp-includes/wp-db.php: wpdb::prepare()

Prepares a SQL query for safe execution. Uses sprintf()-like syntax.
wp-includes/cache.php: wp_cache_get()

Retrieves the cache contents from the cache by key and group.
wp-includes/cache.php: wp_cache_add()

Adds data to the cache, if the cache key doesn’t already exist.
wp-includes/load.php: is_wp_error()

Check whether variable is a ClassicPress Error.
Show 1 more use Hide more uses

Used By

Used By
Used By Description
wp-includes/ms-blogs.php: get_blog_details()

Retrieve the details for a blog from the blogs table and blog options.
wp-includes/ms-blogs.php: get_site()

Retrieves site data given a site ID or site object.

Changelog

Changelog
Version Description
WP-4.5.0 Introduced.