# query_posts()

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

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

## Сигнатура

```php
query_posts( array|string $query ): WP_Post[]|int[]
```

## Описание

Примечание: полностью переопределяет основной запрос и не предназначена для использования в плагинах или темах. Её чрезмерно упрощённый подход к изменению основного запроса может привести к проблемам, и его следует избегать везде, где это возможно. В большинстве случаев есть более удачные и производительные способы изменить основной запрос — например, через действие ‘pre_get_posts’ внутри WP_Query.
Нельзя использовать внутри Цикла WordPress.

## Параметры

- `$query` `array|string` — обязательный. Массив или строка аргументов WP_Query.

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

`WP_Post[]|int[]`

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

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

```php
function query_posts( $query ) {
	$GLOBALS['wp_query'] = new WP_Query();
	return $GLOBALS['wp_query']->query( $query );
}
```

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

- 1.5.0 — Introduced.

## Связанные

Использует: `WP_Query::__construct`.

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