Пользовательские запросы SQL для WordPress

25 Мар 2023г. в 11:52

C помощью пользовательских запросов вы сможете читать любые данные и/или манипулировать ими так, как хочется. Новый мир WordPress открывается перед вами.



Зачем использовать пользовательские запросы?
Базовый функционал WordPress великолепен и отлично подходит для решения простых задач. Но если нужно сделать что-то особенное? Будете писать плагин? Но можно использовать SQL запросы! Документация имеется в WordPress Codex (Custom Queries и WPDB class - на английском языке).



Класс wpdb
Глобальный класс WordPress - ключевой для использования запросов. В действительности, каждая функция использует данный класс.



query
Для функции query нужно передать строку, в которой содержится пользовательский запрос. Возвращаемое значение является целым числом, соответствующим количеству выбранных строк или логическое значение false в случае ошибки.

1
$query = "SELECT COUNT(apple) FROM fruits";
2
$wpdb->query($query);


get_results
Функция получает несколько строк после выполнения запроса. По умолчанию результатом является массивом.

1
$query = "
2
SELECT *
3
FROM wp_terms wt
4
INNER JOIN wp_term_taxonomy wtt ON wt.term_id = wtt.term_id
5
WHERE wtt.taxonomy = 'post_tag' AND wtt.count = 0";
6

7
$wpdb->get_results($query);


get_var
Возвращается одна перменная из базы данных, но полный результат запроса кешируется для дальнейшего использования. В случае, если ничего не найдено, возвращается NULL.

1
$query = "SELECT COUNT(*) FROM users";
2
$wpdb->get_var($query);


get_row
Полная строка возвращается в качестве результата, который может быть объектом, ассоциированным массивом или индексированным массивом. Если ничего не найдено, то возвращается NULL. Переменная result_type может иметь значение OBJECT, ARRAY_A или ARRAY_N (объект, ассоциированный массив или индексированный массив). Смещение является целым числом и по умолчанию имеет значение 0.

1
$query = "
2
SELECT * FROM wp_posts
3
WHERE post_type = 'post'";
4

5
$wpdb->get_row($query, ARRAY_A, 3);


get_col
Для того, чтобы получить столбец, нужно использовать данную функцию. Она возвращает массив. Если результат запроса отсутствует, то возвращается пустой массив. Второй параметр является смещением в столбце.

1
$query = "
2
SELECT * FROM wp_posts
3
WHERE post_type = 'post'";
4

5
$wpdb->get_col($query, 3);


Подготовленный запрос
Подготовленный запрос является шаблоном для запросов SQL, которые может выполнять приложение, модифицируя переменные.

Можно защищать SQL запросы от инъекций SQL. Данные из запросов должны быть извлечены из запроса перед его выполнением. В следующем примере значения ’10′, ‘monkey’ и ‘apple’ извлечены с помощью метода prepare.

// Использование: $wpdb->prepare( 'query' [, value_parameter, value_parameter ... ] );

$wpdb->query( $wpdb->prepare(
"INSERT INTO test_table (post_id, animal, food) VALUES ( %d, %s, %s )",
array(
10,
'monkey',
'apple'
)
));

Включаем/выключаем сообщения об ошибках
Сообщения об ошибках можно включать или выключать с помощью функций show_errors и hide_errors:

$wpdb->show_errors();
$wpdb->hide_errors();

Очистка кеша
Кеш очищается функцией flush.

$wpdb->flush();

Вставляем данные
$wpdb->insert($table, $data, $format);

$wpdb->insert(
'foods',
array(
'fruit' => 'apple',
'year' => 2012
),
array(
'%s',
'%d'
)
);

Параметры в порядке использования:

название таблицы, в которую будут вставляться данные
данные для вставки (пары столбец => значение)
массив форматов, используемые для значений в массиве $data. Если данный параметр отсутствует, то все значения будут обрабатываться как строки

Обновляем данные

$wpdb->update(
'foods',
array(
'fruit' => 'apple', // строка
'year' => 'value2' // целое
),
array( 'ID' => 1 ),
array(
'%s', // значение 1
'%d' // значение 2
),
array( '%d' )
);

Используемые параметры:

имя таблицы
данные
условие отбора
формат
формат условия отбора


Информация о столбцах
Можно получать информацию о столбцах. Когда функция возвращает значение OBJECT, то значит есть неизвестные опции.

$wpdb->get_col_info('тип', смещение);

Тип: информация, которая ожидается, некоторые значения:
name – имя столбца (значение по умолчанию)
table – имя таблицы, которой принадлежит столбец
max_length – максимальная длина столбца
not_null – 1, если столбец не может иметь значение NULL
остальные значения можно найти в кодексе WordPress
Смещение: указывается столбец (0 - первый столбец)

Cсылки на таблицы WordPress
Таблицы базы данных WordPress могут быть доступны в классе wpdb:

$wpdb->posts;
$wpdb->postmeta;
$wpdb->comments;
$wpdb->commentmeta;
$wpdb->terms;
$wpdb->term_taxonomy;
$wpdb->term_relationships;
$wpdb->users;
$wpdb->usermeta;
$wpdb->links;
$wpdb->options;

Обратите внимание на то, что не нужно использовать префикс, так как класс wpdb выполняет всю работу за нас.