# do_action_deprecated()

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

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

> Устаревший элемент.

## Сигнатура

```php
do_action_deprecated( string $hook_name, array $args, string $version, string $replacement = '', string $message = '' )
```

## Описание

Когда хук-действие становится устаревшим, вызов do_action() заменяется на do_action_deprecated() , который выдаёт уведомление об устаревании, а затем запускает исходный хук.
См. also_deprecated_hook()

## Параметры

- `$hook_name` `string` — обязательный. Имя хука-действия.
- `$args` `array` — обязательный. Массив дополнительных аргументов функции, передаваемых в do_action() .
- `$version` `string` — обязательный. Версия WordPress, в которой хук стал устаревшим.
- `$replacement` `string` — необязательный, по умолчанию `''`. Хук, который следовало использовать.
- `$message` `string` — необязательный, по умолчанию `''`. Сообщение об изменении.

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

Файл: `wp-includes/plugin.php:749`

```php
function do_action_deprecated( $hook_name, $args, $version, $replacement = '', $message = '' ) {
	if ( ! has_action( $hook_name ) ) {
		return;
	}

	_deprecated_hook( $hook_name, $version, $replacement, $message );

	do_action_ref_array( $hook_name, $args );
}
```

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

- 4.6.0 — Introduced.

## Связанные

Использует: [`_deprecated_hook`](https://chugunov.pro/api-wordpress/functions/_deprecated_hook/), [`has_action`](https://chugunov.pro/api-wordpress/functions/has_action/), [`do_action_ref_array`](https://chugunov.pro/api-wordpress/functions/do_action_ref_array/).
Используется в: [`wp_check_comment_disallowed_list`](https://chugunov.pro/api-wordpress/functions/wp_check_comment_disallowed_list/), [`wp_insert_site`](https://chugunov.pro/api-wordpress/functions/wp_insert_site/), [`wp_delete_site`](https://chugunov.pro/api-wordpress/functions/wp_delete_site/), [`register_and_do_post_meta_boxes`](https://chugunov.pro/api-wordpress/functions/register_and_do_post_meta_boxes/), [`get_password_reset_key`](https://chugunov.pro/api-wordpress/functions/get_password_reset_key/), [`wpmu_delete_blog`](https://chugunov.pro/api-wordpress/functions/wpmu_delete_blog/), [`set_site_transient`](https://chugunov.pro/api-wordpress/functions/set_site_transient/), [`set_transient`](https://chugunov.pro/api-wordpress/functions/set_transient/), [`_transition_post_status`](https://chugunov.pro/api-wordpress/functions/_transition_post_status/), [`clean_blog_cache`](https://chugunov.pro/api-wordpress/functions/clean_blog_cache/).

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