# apply_filters_ref_array()

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

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

## Сигнатура

```php
apply_filters_ref_array( string $hook_name, array $args ): mixed
```

## Описание

См. alsoapply_filters(): эта функция идентична, но аргументы, передаваемые функциям, привязанным к $hook_name, передаются в виде массива.

## Параметры

- `$hook_name` `string` — обязательный. Имя хука-фильтра.
- `$args` `array` — обязательный. Аргументы, передаваемые функциям, привязанным к $hook_name.

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

`mixed`

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

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

```php
function apply_filters_ref_array( $hook_name, $args ) {
	global $wp_filter, $wp_filters, $wp_current_filter;

	if ( ! isset( $wp_filters[ $hook_name ] ) ) {
		$wp_filters[ $hook_name ] = 1;
	} else {
		++$wp_filters[ $hook_name ];
	}

	// Do 'all' actions first.
	if ( isset( $wp_filter['all'] ) ) {
		$wp_current_filter[] = $hook_name;
		$all_args            = func_get_args(); // phpcs:ignore PHPCompatibility.FunctionUse.ArgumentFunctionsReportCurrentValue.NeedsInspection
		_wp_call_all_hook( $all_args );
	}

	if ( ! isset( $wp_filter[ $hook_name ] ) ) {
		if ( isset( $wp_filter['all'] ) ) {
			array_pop( $wp_current_filter );
		}

		return $args[0];
	}

	if ( ! isset( $wp_filter['all'] ) ) {
		$wp_current_filter[] = $hook_name;
	}

	$filtered = $wp_filter[ $hook_name ]->apply_filters( $args[0], $args );

	array_pop( $wp_current_filter );

	return $filtered;
}
```

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

- 3.0.0 — Introduced.

## Связанные

Использует: [`_wp_call_all_hook`](https://chugunov.pro/api-wordpress/functions/_wp_call_all_hook/).
Используется в: `WP_Term_Query::get_terms`, `WP_Network_Query::get_networks`, `WP_Network_Query::get_network_ids`, `WP_Site_Query::get_sites`, `WP_Site_Query::get_site_ids`, [`apply_filters_deprecated`](https://chugunov.pro/api-wordpress/functions/apply_filters_deprecated/), `WP_Comment_Query::get_comment_ids`, `WP_Comment_Query::get_comments`, `WP_Query::set_found_posts`, `WP_Query::get_posts`, `WP_User_Query::query`, `WP_Meta_Query::get_sql`.

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