get_site() │ WP 4.6.0

Получает данные сайта сети по его ID. Если аргумент не указан, получает данные текущего сайта.

Результат хранится в кеше и проходит через фильтр get_site.

Используйте get_sites(), когда нужно получить список сайтов по условиям.

Функция не определана на обычной установке (не мультисайт). Если её вызывать, то получим фатал:

Fatal error: Uncaught Error: Call to undefined function get_site()
Работает на основе: WP_Site::get_instance()
Основа для: wp_initialize_site()
Хуки из функции

Возвращает

WP_Site|null.

  • WP_Site - объект сайта.
  • null - сайт с указанным ID не найден.

Использование

get_site( $site );
$site(WP_Site|int|null)
Объект или ID сайта. Если значение пустое, используется ID текущего сайта.
По умолчанию: null

Примеры

#1 Получить данные текущего сайта

$site = get_site();

/*
$site = WP_Site Object
(
	[blog_id] => 1
	[domain] => exmaple.com
	[path] => /
	[site_id] => 1
	[registered] => 2018-07-11 10:49:32
	[last_updated] => 2026-09-23 12:21:20
	[public] => 1
	[archived] => 0
	[mature] => 0
	[spam] => 0
	[deleted] => 0
	[lang_id] => 0
)
*/

#2 Получить сайт по ID

$site = get_site( 3 );

if ( $site ) {
	echo esc_html( $site->path ); //> /subsite
}

Список изменений

С версии 4.6.0 Введена.

Код get_site() WP 7.1.2

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

Мультисайт