Query di eliminazione (delete)
Le query di eliminazione devono sempre utilizzare l’oggetto query builder. Vengono avviate usando il metodo delete() nel modo seguente:
$query = $connection->delete('mytable', $options);
Questo crea un oggetto query di eliminazione, che rimuove i record dalla tabella mytable. Nota che non sono necessarie le parentesi graffe per il nome della tabella, poiché il query builder lo gestirà automaticamente.
L’oggetto query di eliminazione utilizza un’API fluente. Cioè, tutti i metodi (eccetto execute()) restituiscono lo stesso oggetto query, consentendo di concatenare le chiamate ai metodi. In molti casi questo significa che non è nemmeno necessario salvare l’oggetto query in una variabile.
Le query di eliminazione sono concettualmente molto semplici e consistono solo nella clausola WHERE. La struttura completa della clausola WHERE è descritta dettagliatamente nella sezione «Clausole condizionali» e qui verrà trattata solo brevemente.
Una query di eliminazione completa avrà la seguente forma:
$num_deleted = $connection->delete('mytable')
->condition('myfield', 5)
->execute();
La query sopra eliminerà tutte le righe dalla tabella {mytable}, dove la colonna myfield è uguale a 5. È equivalente alla seguente query:
DELETE FROM {mytable} WHERE myfield=5;
Il metodo execute() restituisce il numero di record che sono stati eliminati dal database come risultato della query.