문서 수정

개요

이 가이드 에서는 Laravel MongoDB 사용하여 Laravel 애플리케이션 에서 MongoDB 컬렉션 의 문서를 수정하는 방법을 학습 수 있습니다. 업데이트 작업을 사용하여 기존 문서를 수정하거나 검색 기준과 일치하는 문서가 없는 경우 문서 를 삽입합니다.

Eloquent 모델의 인스턴스에 변경 사항을 유지하거나 Eloquent의 유창한 구문을 사용하여 Laravel 컬렉션 객체를 반환하는 메서드에 대한 업데이트 작업을 연결할 수 있습니다.

이 가이드 다음과 같은 업데이트 작업의 예를 제공합니다.

• 문서 업데이트

• 여러 문서 업데이트하기

• 한 번의 작업으로 업데이트 또는 삽입

• 문서의 배열 업데이트

<?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() 메서드를 호출하여 변경 사항을 저장합니다.

• update() 메서드를 호출하여 모델의 인스턴스 를 조회 하고 업데이트를 수행하는 메서드를 체인으로 연결합니다.

다음 예에서는 모델의 인스턴스를 수정하고 해당 save() 메서드를 호출하여 문서를 업데이트하는 방법을 보여 줍니다.

$concert = Concert::first();
$concert->venue = 'Manchester Arena';
$concert->ticketsSold = 9543;
$concert->save();

save() 메서드가 성공하면 메서드를 호출한 모델 인스턴스에 업데이트된 값이 포함됩니다.

작업이 실패하면 Laravel 통합이 모델 인스턴스 에 null 값을 할당합니다.

다음 예에서는 일치하는 첫 번째 문서를 검색하고 업데이트하는 메서드를 연결하여 문서를 업데이트하는 방법을 보여 줍니다.

$concert = Concert::where(['performer' => 'Brad Mehldau'])
    ->orderBy('id')
    ->first()
    ->update(['venue' => 'Manchester Arena', 'ticketsSold' => 9543]);

update() 메서드가 성공하면 작업이 업데이트된 문서 수를 반환합니다.

호출의 조회 부분이 어떤 문서와도 일치하지 않는 경우 Laravel 통합은 다음 오류를 반환합니다.

Error: Call to a member function update() on null

여러 문서 업데이트하기

하나 이상의 문서에서 업데이트를 수행하려면 where() 와 같이 문서를 Laravel 컬렉션 객체로 조회하는 메서드의 결과에 update() 메서드를 연결합니다.

다음 예는 일치하는 문서를 검색하고 업데이트하기 위해 호출을 연결하는 방법을 보여줍니다.

Concert::whereIn('venue', ['Philharmonie de Paris', 'Soldier Field'])
    ->update(['venue' => 'Concertgebouw', 'ticketsSold' => 0]);

update() 메서드가 성공하면 작업이 업데이트된 문서 수를 반환합니다.

호출의 조회 부분이 컬렉션 의 어떤 문서와도 일치하지 않으면 Laravel 통합은 다음 오류를 반환합니다.

Error: Call to a member function update() on null

한 번의 작업으로 업데이트 또는 삽입

업서트 작업을 사용하면 한 번의 작업으로 업데이트 또는 삽입을 수행할 수 있습니다. 이 작업은 문서를 업데이트하거나 문서가 없는 경우 문서를 삽입하는 작업을 간소화합니다.

v4.7 부터 시작됩니다. 다음 방법 중 하나를 사용하여 업서트 작업을 수행할 수 있습니다.

• upsert(): 이 방법을 사용하면 배치 업서트 를 수행하여 한 번의 작업으로 여러 문서를 변경하거나 삽입할 수 있습니다.

• update(): 이 메서드를 사용하는 경우 쿼리 필터하다 와 일치하는 모든 문서를 업데이트 하거나 일치하는 문서 를 삽입하려면 upsert 옵션을 지정해야 합니다. 이 업서트 메서드만 v4.6 이전 버전에서 지원됩니다.

YourModel::upsert(
   [/* documents to update or insert */],
   '/* unique field */',
   [/* fields to update */],
);

Concert::upsert([
    ['performer' => 'Angel Olsen', 'venue' => 'Academy of Music', 'ticketsSold' => 275],
    ['performer' => 'Darondo', 'venue' => 'Cafe du Nord', 'ticketsSold' => 300],
], 'performer', ['ticketsSold']);

{
  "_id": "...",
  "performer": "Angel Olsen",
  "venue": "State Theatre",
  "genres": [
    "indie",
    "rock"
  ],
  "ticketsSold": 275,
  "updated_at": ...
},
{
  "_id": "...",
  "performer": "Darondo",
  "venue": "Cafe du Nord",
  "ticketsSold": 300,
  "updated_at": ...
}

YourModel::where(/* match criteria */)
   ->update(
       [/* update data */],
       ['upsert' => true]);

Concert::where(['performer' => 'Jon Batiste', 'venue' => 'Radio City Music Hall'])
    ->update(
        ['genres' => ['R&B', 'soul'], 'ticketsSold' => 4000],
        ['upsert' => true],
    );

{
  "_id": "660c...",
  "performer": "Jon Batiste",
  "venue": "Radio City Music Hall",
  "genres": [
    "R&B",
    "soul"
  ],
  "ticketsSold": 4000,
  "updated_at": ...
}

문서의 배열 업데이트

이 섹션에서는 MongoDB 문서에서 배열 값을 업데이트하는 다음 작업의 예를 볼 수 있습니다.

• 배열 에 값 추가

• 배열 에서 값 제거

• 배열 요소의 값 업데이트

이 예에서는 다음 삽입 작업으로 생성된 샘플 문서를 수정합니다.

Concert::create([
    'performer' => 'Mitsuko Uchida',
    'genres' => ['classical', 'dance-pop'],
]);

YourModel::where(<match criteria>)
   ->push(
       <field name>,
       [<values>], // array or single value to add
       unique: true); // whether to skip existing values

Concert::where('performer', 'Mitsuko Uchida')
    ->push(
        'genres',
        ['baroque'],
    );

{
  "_id": "660eb...",
  "performer": "Mitsuko Uchida",
  "genres": [
      "classical",
      "dance-pop",
  ],
  "updated_at": ...,
  "created_at": ...
}

YourModel::where(<match criteria>)
   ->pull(
       <field name>,
       [<values>]); // array or single value to remove

Concert::where('performer', 'Mitsuko Uchida')
    ->pull(
        'genres',
        ['dance-pop', 'classical'],
    );

{
  "_id": "660e...",
  "performer": "Mitsuko Uchida",
  "genres": [],
  "updated_at": ...,
  "created_at": ...
}

DB::connection('mongodb')
   ->getCollection(<collection name>)
   ->updateOne(
       <match criteria>,
       ['$set' => ['<array field>.$' => <replacement value>]]);

$match = ['performer' => 'Mitsuko Uchida', 'genres' => 'dance-pop'];
$update = ['$set' => ['genres.$' => 'contemporary']];
DB::connection('mongodb')
    ->getCollection('concerts')
    ->updateOne($match, $update);

{
  "_id": "660e...",
  "performer": "Mitsuko Uchida",
  "genres": [
    "classical",
    "contemporary"
  ],
  "updated_at": ...,
  "created_at": ...
}

추가 정보

Laravel 통합을 사용하여 문서를 업데이트 방법을 보여주는 실행 가능한 코드 예제를 보려면 다음 사용 예제를 참조하세요.

• 문서 업데이트

• 여러 문서 업데이트하기

MongoDB 컬렉션 에 문서를 삽입하는 방법을 학습 문서 삽입 가이드 참조하세요.