_prime_post_caches() │ WP 3.4.0

Добавляет в объектный кэш указанные записи (посты). Посты, которые уже есть в кэше, пропускаются. Также создает связанный кэш терминов и метаданых.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Работает на основе: _get_non_cached_ids(), update_post_caches()
1 раз — 0.012805 сек (тормоз) | 50000 раз — 0.78 сек (очень быстро)

Хуков нет.

Возвращает

null. Ничего.

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

_prime_post_caches( $ids, $update_term_cache, $update_meta_cache );
$ids(массив) (обязательный)
Массив ID записей, которые нужно проверить и если их еще нет в кэше, добавить в кэш.
$update_term_cache(true/false)
Нужно ли обновлять связанный кэш терминов (категорий).
По умолчанию: true
$update_meta_cache(true/false)
Нужно ли обновлять связанный кэш метаданных (произвольных полей).
По умолчанию: true

Примеры

0

#1 Добавим записи в кэш при обработке комментов

Пример из ядра, из функции get_comments().

// Prime comment post caches.
if ( $this->query_vars['update_comment_post_cache'] ) {

	$comment_post_ids = array();

	foreach ( $_comments as $_comment ) {
		$comment_post_ids[] = $_comment->comment_post_ID;
	}

	_prime_post_caches( $comment_post_ids, false, false );
}
0

#2 Добавим записи в кэш при получении постов

Пример из ядра, из функции get_posts().

$ids = $wpdb->get_col( $this->request );

if ( $ids ) {
	$this->posts = $ids;
	$this->set_found_posts( $q, $limits );
	_prime_post_caches( $ids, $q['update_post_term_cache'], $q['update_post_meta_cache'] );
} else {
	$this->posts = array();
}

Заметки

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

С версии 3.4.0 Введена.
С версии 6.1.0 This function is no longer marked as "private".

Код _prime_post_caches() WP 6.6.2

wp-includes/post.php 
function _prime_post_caches( $ids, $update_term_cache = true, $update_meta_cache = true ) {
	global $wpdb;

	$non_cached_ids = _get_non_cached_ids( $ids, 'posts' );
	if ( ! empty( $non_cached_ids ) ) {
		$fresh_posts = $wpdb->get_results( sprintf( "SELECT $wpdb->posts.* FROM $wpdb->posts WHERE ID IN (%s)", implode( ',', $non_cached_ids ) ) );

		if ( $fresh_posts ) {
			// Despite the name, update_post_cache() expects an array rather than a single post.
			update_post_cache( $fresh_posts );
		}
	}

	if ( $update_meta_cache ) {
		update_postmeta_cache( $ids );
	}

	if ( $update_term_cache ) {
		$post_types = array_map( 'get_post_type', $ids );
		$post_types = array_unique( $post_types );
		update_object_term_cache( $ids, $post_types );
	}
}

cache (object кэш кеш)