# update_post_thumbnail_cache()

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

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

## Сигнатура

```php
update_post_thumbnail_cache( WP_Query|null $wp_query = null )
```

## Описание

Обновляет кэш миниатюр в текущем цикле.

## Параметры

- `$wp_query` `WP_Query|null` — необязательный, по умолчанию `null`. Экземпляр WP_Query . По умолчанию — глобальная переменная $wp_query .

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

Файл: `wp-includes/post-thumbnail-template.php:104`

```php
function update_post_thumbnail_cache( $wp_query = null ) {
	if ( ! $wp_query ) {
		$wp_query = $GLOBALS['wp_query'];
	}

	if ( $wp_query->thumbnails_cached ) {
		return;
	}

	$thumb_ids = array();

	/*
	 * $wp_query may contain an array of post objects or post IDs.
	 *
	 * This ensures the cache is primed for all post objects to avoid
	 * `get_post()` calls in `get_the_post_thumbnail()` triggering an
	 * additional database call for each post.
	 */
	$parent_post_ids = array();
	foreach ( $wp_query->posts as $post ) {
		if ( $post instanceof WP_Post ) {
			$parent_post_ids[] = $post->ID;
		} elseif ( is_int( $post ) ) {
			$parent_post_ids[] = $post;
		}
	}
	_prime_post_caches( $parent_post_ids, false, true );

	foreach ( $wp_query->posts as $post ) {
		$id = get_post_thumbnail_id( $post );
		if ( $id ) {
			$thumb_ids[] = $id;
		}
	}

	if ( ! empty( $thumb_ids ) ) {
		_prime_post_caches( $thumb_ids, false, true );
	}

	$wp_query->thumbnails_cached = true;
}
```

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

- 3.2.0 — Introduced.

## Связанные

Использует: [`get_post_thumbnail_id`](https://chugunov.pro/api-wordpress/functions/get_post_thumbnail_id/), [`_prime_post_caches`](https://chugunov.pro/api-wordpress/functions/_prime_post_caches/).
Используется в: `WP_REST_Posts_Controller::get_items`, `WP_Media_List_Table::prepare_items`, [`get_the_post_thumbnail`](https://chugunov.pro/api-wordpress/functions/get_the_post_thumbnail/).

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