# clean_attachment_cache()

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

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

## Сигнатура

```php
clean_attachment_cache( int $id, bool $clean_terms = false )
```

## Описание

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

## Параметры

- `$id` `int` — обязательный. Идентификатор вложения в кэше, которое нужно очистить.
- `$clean_terms` `bool` — необязательный, по умолчанию `false`. Очищать ли кэш терминов.

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

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

```php
function clean_attachment_cache( $id, $clean_terms = false ) {
	global $_wp_suspend_cache_invalidation;

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

	$id = (int) $id;

	wp_cache_delete( $id, 'posts' );
	wp_cache_delete( $id, 'post_meta' );

	if ( $clean_terms ) {
		clean_object_term_cache( $id, 'attachment' );
	}

	/**
	 * Fires after the given attachment's cache is cleaned.
	 *
	 * @since 3.0.0
	 *
	 * @param int $id Attachment ID.
	 */
	do_action( 'clean_attachment_cache', $id );
}
```

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

- 3.0.0 — Introduced.

## Связанные

Использует: [`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/).
Используется в: [`wp_media_attach_action`](https://chugunov.pro/api-wordpress/functions/wp_media_attach_action/).

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