get_site( WP_Site|int|null $site = null )

Retrieves site data given a site ID or site object.

Description

Site data will be cached and returned after being passed through a filter. If the provided site is empty, the current site global will be used.

Parameters

$site

(WP_Site|int|null) (Optional) Site to retrieve. Default is the current site.

Default value: null

Return

(WP_Site|null) The site object or null if not found.

Source

File: wp-includes/ms-site.php

function get_site( $site = null ) {
	if ( empty( $site ) ) {
		$site = get_current_blog_id();
	}

	if ( $site instanceof WP_Site ) {
		$_site = $site;
	} elseif ( is_object( $site ) ) {
		$_site = new WP_Site( $site );
	} else {
		$_site = WP_Site::get_instance( $site );
	}

	if ( ! $_site ) {
		return null;
	}

	/**
	 * Fires after a site is retrieved.
	 *
	 * @since 4.6.0
	 *
	 * @param WP_Site $_site Site data.
	 */
	$_site = apply_filters( 'get_site', $_site );

	return $_site;
}

Changelog

Version Description
4.6.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_site