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 | Введена. |