# clean_user_cache()

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

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

## Сигнатура

```php
clean_user_cache( WP_User|int $user )
```

## Описание

Очищает все кэши пользователя.

## Параметры

- `$user` `WP_User|int` — обязательный. Объект или ID пользователя для удаления из кэша

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

Файл: `wp-includes/user.php:2019`

```php
function clean_user_cache( $user ) {
	if ( is_numeric( $user ) ) {
		$user = new WP_User( $user );
	}

	if ( ! $user->exists() ) {
		return;
	}

	wp_cache_delete( $user->ID, 'users' );
	wp_cache_delete( $user->user_login, 'userlogins' );
	wp_cache_delete( $user->user_nicename, 'userslugs' );

	if ( ! empty( $user->user_email ) ) {
		wp_cache_delete( $user->user_email, 'useremail' );
	}

	wp_cache_delete( $user->ID, 'user_meta' );
	wp_cache_set_users_last_changed();

	/**
	 * Fires immediately after the given user's cache is cleaned.
	 *
	 * @since 4.4.0
	 *
	 * @param int     $user_id User ID.
	 * @param WP_User $user    User object.
	 */
	do_action( 'clean_user_cache', $user->ID, $user );
}
```

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

- 6.2.0 — User metadata caches are now cleared.
- 4.4.0 — 'clean_user_cache' action was added.
- 3.0.0 — Introduced.

## Связанные

Использует: [`wp_cache_set_users_last_changed`](https://chugunov.pro/api-wordpress/functions/wp_cache_set_users_last_changed/), `WP_User::__construct`, [`wp_cache_delete`](https://chugunov.pro/api-wordpress/functions/wp_cache_delete/), [`do_action`](https://chugunov.pro/api-wordpress/functions/do_action/).
Используется в: [`wpmu_delete_user`](https://chugunov.pro/api-wordpress/functions/wpmu_delete_user/), [`refresh_user_details`](https://chugunov.pro/api-wordpress/functions/refresh_user_details/), [`update_user_status`](https://chugunov.pro/api-wordpress/functions/update_user_status/), [`wp_delete_user`](https://chugunov.pro/api-wordpress/functions/wp_delete_user/), [`wp_set_password`](https://chugunov.pro/api-wordpress/functions/wp_set_password/), [`delete_usermeta`](https://chugunov.pro/api-wordpress/functions/delete_usermeta/), [`update_usermeta`](https://chugunov.pro/api-wordpress/functions/update_usermeta/), [`wp_update_user`](https://chugunov.pro/api-wordpress/functions/wp_update_user/), [`wp_insert_user`](https://chugunov.pro/api-wordpress/functions/wp_insert_user/), [`add_user_to_blog`](https://chugunov.pro/api-wordpress/functions/add_user_to_blog/), [`remove_user_from_blog`](https://chugunov.pro/api-wordpress/functions/remove_user_from_blog/).

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