# _prime_term_caches()

URL: https://chugunov.pro/api-wordpress/functions/_prime_term_caches/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.6.0.

## Сигнатура

```php
_prime_term_caches( array $term_ids, bool $update_meta_cache = true )
```

## Описание

Добавляет в кэш термины с заданными ID, которых там ещё нет.

## Параметры

- `$term_ids` `array` — обязательный. Массив ID терминов.
- `$update_meta_cache` `bool` — необязательный, по умолчанию `true`. Обновлять ли кэш метаданных.

## Исходный код

Файл: `wp-includes/taxonomy.php:4118`

```php
function _prime_term_caches( $term_ids, $update_meta_cache = true ) {
	global $wpdb;

	$non_cached_ids = _get_non_cached_ids( $term_ids, 'terms' );
	if ( ! empty( $non_cached_ids ) ) {
		$fresh_terms = $wpdb->get_results( sprintf( "SELECT t.*, tt.* FROM $wpdb->terms AS t INNER JOIN $wpdb->term_taxonomy AS tt ON t.term_id = tt.term_id WHERE t.term_id IN (%s)", implode( ',', array_map( 'intval', $non_cached_ids ) ) ) );

		update_term_cache( $fresh_terms );
	}

	if ( $update_meta_cache ) {
		wp_lazyload_term_meta( $term_ids );
	}
}
```

## История изменений

- 6.3.0 — Use wp_lazyload_term_meta() for lazy-loading of term meta.
- 6.1.0 — This function is no longer marked as "private".
- 4.6.0 — Introduced.

## Связанные

Использует: [`wp_lazyload_term_meta`](https://chugunov.pro/api-wordpress/functions/wp_lazyload_term_meta/), [`_get_non_cached_ids`](https://chugunov.pro/api-wordpress/functions/_get_non_cached_ids/), [`update_term_cache`](https://chugunov.pro/api-wordpress/functions/update_term_cache/), `wpdb::get_results`.
Используется в: [`update_menu_item_cache`](https://chugunov.pro/api-wordpress/functions/update_menu_item_cache/), `WP_Term_Query::get_terms`, [`get_object_term_cache`](https://chugunov.pro/api-wordpress/functions/get_object_term_cache/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_prime_term_caches/