Что такое «Набор записей»

Название пришло из классических средств доступа к базам вроде Microsoft ADO и Delphi, где результат выборки был отдельным объектом Recordset с курсором и методами перехода по строкам. В PHP и WordPress такого объекта нет, но смысл тот же: SQL-запрос возвращает таблицу, и код обрабатывает её построчно.

В WordPress прямыми запросами занимается объект $wpdb. Он подключается к базе по данным из wp-config.php, подставляет префикс таблиц и отдаёт набор записей в удобном для PHP виде.

Методы и форматы результата

  • get_results() — все строки. Формат задаёт второй параметр: OBJECT (по умолчанию, массив объектов), ARRAY_A (ассоциативные массивы), ARRAY_N (нумерованные), OBJECT_K (ключом служит первая колонка).
  • get_row() — одна строка, get_col() — одна колонка в виде массива, get_var() — одно значение.

Пример запроса

global $wpdb;
$rows = $wpdb->get_results( $wpdb->prepare(
    "SELECT ID, post_title FROM {$wpdb->posts}
     WHERE post_type = %s AND post_status = 'publish'
     ORDER BY post_date DESC LIMIT %d",
    'product', 50
) );
foreach ( $rows as $row ) {
    echo esc_html( $row->post_title ), '<br>';
}

Метод prepare() обязателен, если в запрос попадает хоть одно значение извне: он экранирует его и защищает от SQL-инъекции. Пустой результат — это пустой массив, а ошибку запроса показывает свойство $wpdb->last_error.

Когда прямой запрос не нужен

Для выборки публикаций обычно удобнее WP_Query: он возвращает полноценные объекты записей, учитывает права, кеширует метаданные и работает с хуками плагинов. Прямой запрос оправдан для отчётов, массовых операций и собственных таблиц плагина. При больших объёмах набор записей забирают частями через LIMIT и OFFSET: десятки тысяч строк, загруженных разом, легко упираются в лимит памяти PHP.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «WordPress» ↗