Запросы удаления delete

Запросы на удаление всегда должны использовать объект построителя запросов. Они запускаются с использованием метода delete() следующим образом:

$query = $connection->delete('mytable', $options);

Это создает объект запроса на удаление, который удаляет записи из таблицы mytable. Обратите внимание, что фигурные скобки не требуются для имени таблицы, поскольку построитель запросов будет обрабатывать это автоматически.

Объект запроса на удаление использует свободный API. То есть все методы (кроме execute()) возвращают сам объект запроса, позволяя объединять вызовы методов. Во многих случаях это означает, что объект запроса вообще не нужно сохранять в переменной.

Запросы на удаление концептуально очень просты и состоят только из предложения WHERE. Полная структура предложения WHERE подробно описана в разделе «Условные предложения» и будет затронута только здесь.

Полный запрос на удаление будет иметь следующую форму:

$num_deleted = $connection->delete('mytable')
  ->condition('myfield', 5)
  ->execute();

Приведенный выше запрос удалит все строки из таблицы {mytable}, где столбец myfield равен 5. Это эквивалентно следующему запросу:

DELETE FROM {mytable} WHERE myfield=5;

Метод execute() возвращает количество записей, которые были удалены в результате запроса.