문서 삽입

개요

이 가이드 에서는 Laravel MongoDB 사용하여 Laravel 애플리케이션 에서 MongoDB 컬렉션에 문서를 삽입하는 방법을 학습 수 있습니다.

문서를 삽입할 때 데이터가 컬렉션의 고유 인덱스를 위반하지 않는지 확인하세요. 컬렉션의 첫 번째 문서를 삽입하거나 새 컬렉션을 만들 때 MongoDB는 _id 필드에 고유 인덱스를 자동으로 생성합니다.

Laravel 스키마 빌더를 사용하여 MongoDB 컬렉션에서 인덱스를 생성하는 방법에 대한 자세한 내용은 스키마 빌더 설명서의 인덱스 관리 섹션을 참조하세요.

Laravel 통합의 Eloquent 모델에 대해 자세히 학습 데이터 모델링하기 섹션을 참조하세요.

<?php
namespace App\Models;
use MongoDB\Laravel\Eloquent\Model;
class Concert extends Model
{
    protected $connection = 'mongodb';
    protected $fillable = ['performer', 'venue', 'genres', 'ticketsSold', 'performanceDate'];
    protected $casts = ['performanceDate' => 'datetime'];
}

문서 하나 삽입

이 섹션의 예제에서는 save() 및 create() Eloquent 메서드를 사용하여 Concert 모델의 인스턴스 MongoDB 문서 로 삽입하는 방법을 보여 줍니다.

$concert = new Concert();
$concert->performer = 'Mitsuko Uchida';
$concert->venue = 'Carnegie Hall';
$concert->genres = ['classical'];
$concert->ticketsSold = 2121;
$concert->performanceDate = Carbon::create(2024, 4, 1, 20, 0, 0, 'EST');
$concert->save();

$insertedId = $concert->id;

$insertResult = Concert::create([
    'performer' => 'The Rolling Stones',
    'venue' => 'Soldier Field',
    'genres' => [ 'rock', 'pop', 'blues' ],
    'ticketsSold' => 59527,
    'performanceDate' => Carbon::create(2024, 6, 30, 20, 0, 0, 'CDT'),
]);

여러 문서를 삽입합니다.

이 예시 에서는 insert() Eloquent 메서드를 사용하여 Concert 모델의 여러 인스턴스를 MongoDB 문서로 삽입하는 방법을 보여 줍니다. 이 대량 삽입 메서드를 사용하면 애플리케이션 에서 문서를 저장하기 위해 수행해야 하는 호출 횟수를 줄일 수 있습니다.

insert() 메서드가 성공하면 true 값을 반환합니다. 실패하면 예외가 발생합니다.

다음 예시 에서는 여러 모델을 insert() 메서드에 배열 로 전달하여 한 번의 호출로 저장합니다.

$data = [
    [
        'performer' => 'Brad Mehldau',
        'venue' => 'Philharmonie de Paris',
        'genres' => [ 'jazz', 'post-bop' ],
        'ticketsSold' => 5745,
        'performanceDate' => new UTCDateTime(Carbon::create(2025, 2, 12, 20, 0, 0, 'CET')),
    ],
    [
        'performer' => 'Billy Joel',
        'venue' => 'Madison Square Garden',
        'genres' => [ 'rock', 'soft rock', 'pop rock' ],
        'ticketsSold' => 12852,
        'performanceDate' => new UTCDateTime(Carbon::create(2025, 2, 12, 20, 0, 0, 'CET')),
    ],
];
Concert::insert($data);

완전 실행 가능한 예시

다음 섹션에서는 Laravel 통합을 사용하여 문서를 삽입하는 방법을 보여주는 완전히 실행 가능한 코드 예제를 제공합니다. 이 예제에서는 sample_mflix.movies Atlas 샘플 데이터 세트의 컬렉션 사용합니다.

$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": "..."
}

$success = DB::table('movies')
    ->insert([
        'title' => 'Marriage Story',
        'year' => 2019,
        'runtime' => 136,
    ]);
echo 'Insert operation success: ' . ($success ? 'yes' : 'no');

Insert operation success: yes

$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

$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

추가 정보

탄소 PHP API 확장에 대해 자세히 학습하려면 탄소 Github 리포지토리 참조하세요.

이미 MongoDB 에 있는 데이터를 수정하는 방법을 학습 문서 업데이트 가이드 참조하세요.