# wp_update_comment_count()

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

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

## Сигнатура

```php
wp_update_comment_count( int|null $post_id, bool $do_deferred = false ): bool|void
```

## Описание

Когда $do_deferred равно false (по умолчанию) и для комментариев включён отложенный режим, post_id добавляется в очередь, которая будет обновлена позже и обновляется только один раз для каждого идентификатора записи.
Если отложенный режим для комментариев не включён, запись будет обновлена. Когда $do_deferred установлено в true, все ранее отложенные идентификаторы записей будут обновлены вместе с текущим $post_id.
См. alsowp_update_comment_count_now(): о том, что может привести к возврату значения false

## Параметры

- `$post_id` `int|null` — обязательный. Идентификатор записи.
- `$do_deferred` `bool` — необязательный, по умолчанию `false`. Следует ли обработать ранее отложенные значения количества комментариев записей.

## Возвращаемое значение

`bool|void`

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

Файл: `wp-includes/comment.php:2812`

```php
function wp_update_comment_count( $post_id, $do_deferred = false ) {
	static $_deferred = array();

	if ( empty( $post_id ) && ! $do_deferred ) {
		return false;
	}

	if ( $do_deferred ) {
		$_deferred = array_unique( $_deferred );
		foreach ( $_deferred as $i => $_post_id ) {
			wp_update_comment_count_now( $_post_id );
			unset( $_deferred[ $i ] );
			/** @todo Move this outside of the foreach and reset $_deferred to an array instead */
		}
	}

	if ( wp_defer_comment_counting() ) {
		$_deferred[] = $post_id;
		return true;
	} elseif ( $post_id ) {
		return wp_update_comment_count_now( $post_id );
	}
}
```

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

- 2.1.0 — Introduced.

## Связанные

Использует: [`wp_update_comment_count_now`](https://chugunov.pro/api-wordpress/functions/wp_update_comment_count_now/), [`wp_defer_comment_counting`](https://chugunov.pro/api-wordpress/functions/wp_defer_comment_counting/).
Используется в: [`wp_set_comment_status`](https://chugunov.pro/api-wordpress/functions/wp_set_comment_status/), [`wp_update_comment`](https://chugunov.pro/api-wordpress/functions/wp_update_comment/), [`wp_defer_comment_counting`](https://chugunov.pro/api-wordpress/functions/wp_defer_comment_counting/), [`wp_insert_comment`](https://chugunov.pro/api-wordpress/functions/wp_insert_comment/), [`wp_delete_comment`](https://chugunov.pro/api-wordpress/functions/wp_delete_comment/).

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