Insira vários documentos

Nesta página

Exemplo

Você pode inserir vários documentos em uma coleção chamando o método insert() em um modelo Eloquent ou um construtor de consulta.

Para inserir vários documentos, chame o método insert() e especifique os novos documentos como uma array dentro da chamada de método. Cada entrada de array contém valores de campo de um único documento.

Dica

Para saber mais sobre operações de inserção, consulte a seção Inserir Documentos do guia Operações de Gravação.

Exemplo

Selecione a partir das seguintes abas Eloquent e Query Builder para visualizar exemplos de uso para a mesma operação que usa cada sintaxe de query correspondente:

Este exemplo executa as seguintes ações:

Utiliza o modelo Movie Eloquent para representar a coleção do sample_mflix movies banco de dados do
Insere documentos na coleção movies
Imprime se a operação de inserção é bem-sucedida

O exemplo chama o método insert() para inserir documentos que representam filmes lançados em 2023. Se a operação de inserção for bem-sucedida, ela retornará um valor de 1. Se a operação falhar, ela lançará uma exceção.

$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 exemplo executa as seguintes ações:

Acessos a coleção movies chamando o método table() a partir da fase DB
Insere documentos na coleção movies
Imprime se a operação de inserção é bem-sucedida

$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 saber como editar seu aplicativo Laravel para executar o exemplo de uso, consulte a página de exemplos de uso.

Voltar

Insira um documento

Atualizar um documento