wpdb::delete()
Видаляє рядки з таблиці за умовою, зазначеною у параметрі $where .
Включає захист від SQL ін’єкцій, це означає, що можна передавати неочищені дані, наприклад: $_GET['foo']…
{} Це метод класу: wpdb{}
Хуків немає.
Повертає
int|false. Число видалених рядків або 0, якщо нічого не видалено. false повертається за помилки запиту.
Використання
Global $wpdb; $wpdb->delete( $table, $where, $where_format );
- $table
(рядок) (обов’язковий) - Назва таблиці.
- $where
(масив) (обов’язковий) - Масив умов, за якими вибиратимуться рядки для видалення у форматі
[ 'название колонки' => 'чему равно' ]. Декілька умов будуть об’їдені через
AND. Якщо в значенні вказати
NULL, то в запиті отримаємо порівняння
IS NULL, відповідний формат при цьому ігнорується. - $where_format
(масив/рядок) Масив форматів даних, які будуть асоційовані із зазначеними значеннями у параметрі $where . Якщо зазначений рядок, то він (формат) буде асоційований з усіма даними. При вказівці формату WordPress переводить передані дані у вказаний формат перед створенням запиту. Можливі формати:
%s– Рядок%d– ціле число%f– дробове число
Якщо не вказати, то для всіх значень $data буде вказано формат
строка, якщо інше не зазначено у властивості wpdb::$field_types .
Типово: null
Приклади
#1 Приклад видалення даних із БД
// Видалимо рядок із полем ID=1 з таблиці table $wpdb->delete( 'table', [ 'ID' => 1 ] ); // Вкажемо формат значення $where $wpdb->delete( 'table', [ 'ID'=>'1' ], [ '%d' ] ); // 1 буде оброблено як число (% d).
нотатки
- Дивіться: wpdb::prepare()
- Дивіться: wpdb::$field_types
- Дивіться: wp_set_wpdb_vars()
список змін
| З версії 3.4.0 | Введено. |