# posts_clauses

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

Тип: хук-фильтр.
Появился в версии: 3.1.0.

## Сигнатура

```php
apply_filters_ref_array( 'posts_clauses', string[] $clauses, WP_Query $query )
```

## Описание

Охватывает секции WHERE, GROUP BY, JOIN, ORDER BY, DISTINCT, fields (SELECT) и LIMIT.

## Параметры

- `$clauses` `string[]` — обязательный. Ассоциативный массив секций запроса.
  
  where stringСекция WHERE запроса.
  
  groupby stringСекция GROUP BY запроса.
  
  join stringСекция JOIN запроса.
  
  orderby stringСекция ORDER BY запроса.
  
  distinct stringСекция DISTINCT запроса.
  
  fields stringСекция SELECT запроса.
  
  limits stringСекция LIMIT запроса.
- `$query` `WP_Query` — обязательный. Экземпляр WP_Query (передаётся по ссылке).

## Фильтруемое значение

Ассоциативный массив секций запроса.

where stringСекция WHERE запроса.

groupby stringСекция GROUP BY запроса.

join stringСекция JOIN запроса.

orderby stringСекция ORDER BY запроса.

distinct stringСекция DISTINCT запроса.

fields stringСекция SELECT запроса.

limits stringСекция LIMIT запроса.

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

Файл: `wp-includes/class-wp-query.php:3016`

```php
$clauses = (array) apply_filters_ref_array( 'posts_clauses', array( compact( $pieces ), &$this ) );
```

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

- 3.1.0 — Introduced.

## Связанные

Используется в: `WP_Query::get_posts`.

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