Insertar un documento

Puede insertar un documento en una colección llamando al método create() en un modelo Eloquent o en el generador de query.

Para insertar un documento, pasa los datos que necesitas insertar como un documento que contenga los campos y valores al método create().

Tip

También se pueden utilizar los métodos save() o insert() para insertar un documento en una colección. Para aprender más sobre las operaciones de inserción, consulta la sección Insertar documentos de la guía de Operaciones de Escritura.

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
inserta un documento en la colección movies
Imprime el documento recién insertado

El ejemplo ejecuta el método create() para insertar un documento que contiene los siguientes campos y valores:

title valor de "Marriage Story"
year valor de 2019
runtime valor de 136

$movie = Movie::create([
    'title' => 'Marriage Story',
    'year' => 2019,
    'runtime' => 136,
]);
echo $movie->toJson();

{
    "title": "Marriage Story",
    "year": 2019,
    "runtime": 136,
    "updated_at": "...",
    "created_at": "...",
    "_id": "..."
}

Este ejemplo realiza las siguientes acciones:

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

El ejemplo ejecuta el método insert() para insertar un documento que contiene los siguientes campos y valores:

title valor de "Marriage Story"
year valor de 2019
runtime valor de 136

$success = DB::table('movies')
    ->insert([
        'title' => 'Marriage Story',
        'year' => 2019,
        'runtime' => 136,
    ]);
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.