# clean_post_cache()

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

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

## Сигнатура

```php
clean_post_cache( int|WP_Post $post )
```

## Описание

Очистка означает удаление записи из кэша. Также будет вызвана очистка кэша объектов терминов, связанных с идентификатором записи.
Эта функция не выполняется, если $_wp_suspend_cache_invalidation не пусто. См. wp_suspend_cache_invalidation() .

## Параметры

- `$post` `int|WP_Post` — обязательный. Идентификатор записи или объект записи для удаления из кэша.

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

Файл: `wp-includes/post.php:7718`

```php
function clean_post_cache( $post ) {
	global $_wp_suspend_cache_invalidation;

	if ( ! empty( $_wp_suspend_cache_invalidation ) ) {
		return;
	}

	$post = get_post( $post );

	if ( ! $post ) {
		return;
	}

	wp_cache_delete( $post->ID, 'posts' );
	wp_cache_delete( 'post_parent:' . (string) $post->ID, 'posts' );
	wp_cache_delete( $post->ID, 'post_meta' );

	clean_object_term_cache( $post->ID, $post->post_type );

	wp_cache_delete( 'wp_get_archives', 'general' );

	/**
	 * Fires immediately after the given post's cache is cleaned.
	 *
	 * @since 2.5.0
	 *
	 * @param int     $post_id Post ID.
	 * @param WP_Post $post    Post object.
	 */
	do_action( 'clean_post_cache', $post->ID, $post );

	if ( 'page' === $post->post_type ) {
		wp_cache_delete( 'all_page_ids', 'posts' );

		/**
		 * Fires immediately after the given page's cache is cleaned.
		 *
		 * @since 2.5.0
		 *
		 * @param int $post_id Post ID.
		 */
		do_action( 'clean_page_cache', $post->ID );
	}

	wp_cache_set_posts_last_changed();
}
```

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

- 2.0.0 — Introduced.

## Связанные

Использует: [`wp_cache_set_posts_last_changed`](https://chugunov.pro/api-wordpress/functions/wp_cache_set_posts_last_changed/), [`wp_cache_delete`](https://chugunov.pro/api-wordpress/functions/wp_cache_delete/), [`clean_object_term_cache`](https://chugunov.pro/api-wordpress/functions/clean_object_term_cache/), [`do_action`](https://chugunov.pro/api-wordpress/functions/do_action/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: `WP_Customize_Manager::trash_changeset_post`, [`_wp_keep_alive_customize_changeset_dependent_auto_drafts`](https://chugunov.pro/api-wordpress/functions/_wp_keep_alive_customize_changeset_dependent_auto_drafts/), `WP_Customize_Manager::_publish_changeset_values`, [`wp_add_trashed_suffix_to_post_name_for_post`](https://chugunov.pro/api-wordpress/functions/wp_add_trashed_suffix_to_post_name_for_post/), [`wp_delete_user`](https://chugunov.pro/api-wordpress/functions/wp_delete_user/), `WP_Posts_List_Table::_display_rows_hierarchical`, [`clean_page_cache`](https://chugunov.pro/api-wordpress/functions/clean_page_cache/), [`wp_delete_attachment`](https://chugunov.pro/api-wordpress/functions/wp_delete_attachment/), [`wp_publish_post`](https://chugunov.pro/api-wordpress/functions/wp_publish_post/), [`add_ping`](https://chugunov.pro/api-wordpress/functions/add_ping/), [`wp_insert_post`](https://chugunov.pro/api-wordpress/functions/wp_insert_post/), [`wp_delete_post`](https://chugunov.pro/api-wordpress/functions/wp_delete_post/), [`set_post_type`](https://chugunov.pro/api-wordpress/functions/set_post_type/), [`wp_update_comment_count_now`](https://chugunov.pro/api-wordpress/functions/wp_update_comment_count_now/).

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