Inserta varios documentos

Puedes insertar múltiples documentos en una colección llamando a la función insert() método en un modelo Eloquent o un generador de consultas.

Para insertar varios documentos, llama al método insert() y especifica los nuevos documentos como un arreglo dentro de la llamada del método. Cada entrada del arreglo contiene los valores de campo de un solo documento.

Tip

Para obtener más información sobre las operaciones de inserción, consulta la Sección Insertar documentos de la guía Operaciones de escritura.

Ejemplo

Seleccione de lo siguiente Eloquent y Query Builder pestañas para ver ejemplos de uso para la misma operación que utilizan cada sintaxis de consulta correspondiente:

Este ejemplo realiza las siguientes acciones:

Utiliza el modelo Movie Eloquent para representar la colección movies en la base de datos sample_mflix
Inserta documentos en la colección movies
Imprime si la operación de inserción ha tenido éxito

El ejemplo llama al método insert() para insertar documentos que representan películas estrenadas en 2023. Si la operación de inserción se realiza correctamente, devuelve el valor 1. Si falla, genera una excepción.

$success = Movie::insert([
    [
        'title' => 'Anatomy of a Fall',
        'release_date' => new UTCDateTime(new DateTimeImmutable('2023-08-23')),
    ],
    [
        'title' => 'The Boy and the Heron',
        'release_date' => new UTCDateTime(new DateTimeImmutable('2023-12-08')),
    ],
    [
        'title' => 'Passages',
        'release_date' => new UTCDateTime(new DateTimeImmutable('2023-06-28')),
    ],
]);
echo 'Insert operation success: ' . ($success ? 'yes' : 'no');

Insert operation success: yes

Este ejemplo realiza las siguientes acciones:

Accede a la colección movies llamando al método table() desde la fachada DB
Inserta documentos en la colección movies
Imprime si la operación de inserción ha tenido éxito

$success = DB::table('movies')
    ->insert([
        [
            'title' => 'Anatomy of a Fall',
            'release_date' => new UTCDateTime(new DateTimeImmutable('2023-08-23')),
        ],
        [
            'title' => 'The Boy and the Heron',
            'release_date' => new UTCDateTime(new DateTimeImmutable('2023-12-08')),
        ],
        [
            'title' => 'Passages',
            'release_date' => new UTCDateTime(new DateTimeImmutable('2023-06-28')),
        ],
    ]);
echo 'Insert operation success: ' . ($success ? 'yes' : 'no');

Insert operation success: yes

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

Volver

Insertar un documento

Actualizar un documento