# wp_list_filter()

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

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

## Сигнатура

```php
wp_list_filter( array $input_list, array $args = array(), string $operator = 'AND' ): array
```

## Описание

Возвращает из списка объекты, соответствующие заданным аргументам.
Ключ представляет имя свойства, а значение — значение свойства.
Если у объекта больше свойств, чем указано в аргументах, это не исключает его из выборки. При использовании оператора 'AND' любое отсутствующее свойство исключает объект.
Если нужно извлечь определённое поле из всех подходящих объектов, используйте вместо этого wp_filter_object_list().

## Параметры

- `$input_list` `array` — обязательный. Массив объектов для фильтрации.
- `$args` `array` — необязательный, по умолчанию `array()`. Массив аргументов ключ => значение для сопоставления с каждым объектом.
- `$operator` `string` — необязательный, по умолчанию `'AND'`. Логическая операция, которую нужно выполнить. 'AND' означает, что должны совпасть все элементы массива. 'OR' означает, что достаточно совпадения одного элемента. 'NOT' означает, что не должен совпасть ни один элемент. Значение по умолчанию 'AND'.

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

`array`

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

Файл: `wp-includes/functions.php:5373`

```php
function wp_list_filter( $input_list, $args = array(), $operator = 'AND' ) {
	return wp_filter_object_list( $input_list, $args, $operator );
}
```

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

- 5.9.0 — Converted into a wrapper for wp_filter_object_list().
- 4.7.0 — Uses WP_List_Util class.
- 3.1.0 — Introduced.

## Связанные

Использует: [`wp_filter_object_list`](https://chugunov.pro/api-wordpress/functions/wp_filter_object_list/).
Используется в: `WP_REST_Menu_Items_Controller::prepare_item_for_response`, `WP_REST_Menu_Items_Controller::get_item_schema`, `WP_REST_Posts_Controller::prepare_tax_query`, `WP_REST_Posts_Controller::prepare_taxonomy_limit_schema`, `WP_REST_Posts_Controller::get_available_actions`, `WP_REST_Posts_Controller::get_schema_links`, `WP_REST_Posts_Controller::get_item_schema`, `WP_REST_Posts_Controller::prepare_item_for_response`, `WP_REST_Posts_Controller::handle_terms`, `WP_REST_Posts_Controller::check_assign_terms_permission`, `WP_REST_Post_Types_Controller::prepare_item_for_response`, `WP_REST_Response::remove_link`, `WP_REST_Server::get_routes`, `WP_Automatic_Updater::send_debug_email`, [`_access_denied_splash`](https://chugunov.pro/api-wordpress/functions/_access_denied_splash/).

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