wp_prime_site_option_caches() │ WP 6.6.0

Загружает указанные сетевые опции текущей сети в объектный кеш одним запросом к базе данных.

Загружаются только опции, которых ещё нет в кеше.

Благодаря этому последующие вызовы get_site_option() не выполняют отдельный запрос к БД.

Опции, которых нет в БД, запоминаются отдельно, чтобы последующие вызовы не создавали лишних запросов.

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

Используйте wp_prime_network_option_caches(), когда нужно указать ID сети, для которой нужно загрузить опции.

Работает на основе: wp_prime_network_option_caches()

Хуков нет.

Возвращает

null.

  • void - ничего не возвращает.

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

wp_prime_site_option_caches( $options );
$options(string[]) (обязательный)
Массив названий опций, которые нужно загрузить в кеш.

Примеры

#1 Предварительная загрузка нескольких сетевых опций

Опции загружаются одним запросом. Последующие вызовы get_site_option() получают их из кеша.

$options = [
	'my_plugin_api_url',
	'my_plugin_api_key',
	'my_plugin_enabled',
];

wp_prime_site_option_caches( $options );

$api_url = get_site_option( 'my_plugin_api_url' );
$api_key = get_site_option( 'my_plugin_api_key' );
$enabled = get_site_option( 'my_plugin_enabled' );

Заметки

Смотрите: wp_prime_network_option_caches()

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

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

Код wp_prime_site_option_caches() WP 7.1.2

function wp_prime_site_option_caches( array $options ) {
	wp_prime_network_option_caches( null, $options );
}