Borrar un documento

Puede borrar un documento en una colección recuperando un solo modelo Eloquent y llamando al método delete(), o llamando delete() directamente en un constructor de consultas.

Para eliminar un documento, pasa un filtro de query al método where(), ordena los documentos coincidentes y llama al método limit() para recuperar solo el primer documento. Luego, elimina este documento coincidente llamando al método delete().

Tip

Para aprender más sobre cómo borrar documentos con la integración de Laravel, consulta la sección Borrar documentos de la guía Operaciones de guardar.

Ejemplo

Selecciona de las siguientes pestañas Eloquent y Query Builder para ver ejemplos de uso de la misma operación que usa cada correspondiente sintaxis de query:

Este ejemplo realiza las siguientes acciones:

Utiliza el modelo Movie Eloquent para representar la colección movies en la base de datos sample_mflix
Elimina un documento de la colección movies que coincide con un filtro de query
Imprime el número de documentos borrados.

El ejemplo llama a los siguientes métodos en el modelo Movie:

where():: Coincide con los documentos en los que el valor del campo title es "Quiz Show"
limit(): Recupera solo el primer documento coincidente
delete()Elimina el documento recuperado

$deleted = Movie::where('title', 'Quiz Show')
    ->limit(1)
    ->delete();
echo 'Deleted documents: ' . $deleted;

Deleted documents: 1

Este ejemplo realiza las siguientes acciones:

Accede a la colección movies llamando al método table() desde la fachada DB
Elimina un documento de la colección movies que coincide con un filtro de query
Imprime el número de documentos borrados.

El ejemplo llama a los siguientes métodos para crear query:

where():: Coincide con los documentos en los que el valor del campo title es "Quiz Show"
limit(): Recupera solo el primer documento coincidente
delete()Elimina el documento recuperado

$deleted = DB::table('movies')
    ->where('title', 'Quiz Show')
    ->limit(1)
    ->delete();
echo 'Deleted documents: ' . $deleted;

Deleted documents: 1

Para aprender a editar tu aplicación Laravel para ejecutar el ejemplo de uso, consulta la página de Ejemplos de Uso.