Функция GET_MAIN_SITE_ID() в WordPress 4.9.0: Получение идентификатора главного сайта

# Функция GET_MAIN_SITE_ID() │ WP 4.9.0

Функция GET_MAIN_SITE_ID() позволяет получить идентификатор главного сайта в сети WordPress.

## Использование функции

Эта функция использует внутреннюю функцию get_network() для получения информации о сети.

### Возвращаемое значение

Функция возвращает целое число (int) — идентификатор главного сайта.

### Синтаксис

```php
get_main_site_id( $network_id );

• $network_id (int) — идентификатор сети, для которой необходимо получить главный сайт. По умолчанию используется текущая сеть.

Примеры использования

Пример 1: Получение идентификатора главного сайта сети

$main_site_id = get_main_site_id();

Этот код сохранит идентификатор главного сайта в переменной $main_site_id.

Изменения в версии WordPress

• С версии 4.9.0 — функция была добавлена.

Код функции GET_MAIN_SITE_ID()

Ниже представлен код функции get_main_site_id() из файла wp-includes/functions.php (версия WP 6.7.2):

function get_main_site_id( $network_id = null ) {
if ( ! is_multisite() ) {
return get_current_blog_id();
}

$network = get_network( $network_id );
if ( ! $network ) {
    return 0;
}

return $network->site_id;

}

Пояснение кода

1. Проверка на мультисайтовость:

   • Если сайт не является мультисайтовым (то есть на нем только один блог), функция вернет идентификатор текущего блога.

2. Получение информации о сети:

   • Функция пытается получить информацию о сети с помощью get_network($network_id). Если сеть не найдена, возвращается 0.

3. Возврат идентификатора:

   • Если сеть найдена, функция вернет идентификатор главного сайта этой сети.

Связанные функции

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

• get_blog_details() — получение информации о блоге.
• get_current_blog_id() — возвращает идентификатор текущего блога.
• is_multisite() — проверяет, является ли сайт мультисайтовым.

Эти функции могут помочь вам лучше управлять сетью сайтов в WordPress.