Docs Menu
Docs Home
/ /

라이브러리 버전 업그레이드

이 페이지에서는 Laravel MongoDB를 새로운 주요 버전으로 업그레이드하는 방법을 알아볼 수 있습니다. 이 페이지에는 해당되는 경우 기능 손실 없이 객체-문서 매퍼(ODM) 버전을 업그레이드하기 위해 애플리케이션에서 수행해야 하는 변경 사항도 포함되어 있습니다.

업그레이드하기 전에 다음 작업을 수행하세요:

  • 라이브러리 버전이 애플리케이션 연결되는 MongoDB Server 버전 및 애플리케이션 실행되는 Laravel 버전과 호환되는지 확인하세요. 이 정보는 호환성 페이지를 참조하세요.

  • 이 가이드 의 호환성이 손상되는 변경 섹션에서 애플리케이션 에서 현재 사용 중인 Laravel 통합 버전과 업그레이드 예정 버전 간의 호환성이 손상되는 변경을 해결하세요.

라이브러리 버전을 업그레이드하려면 애플리케이션 디렉토리에서 다음 명령을 실행합니다.

composer require mongodb/laravel-mongodb:4.8

라이브러리의 다른 버전으로 업그레이드하려면 laravel-mongodb: 뒤의 정보를 원하는 버전 번호로 바꾸세요.

호환성이 손상되는 호환성이 손상되는 변경 은 애플리케이션 이 예상대로 작동하지 않을 수 있는 특정 버전의 Laravel 통합 규칙 또는 동작의 수정입니다.

이 섹션의 호환성이 손상되는 변경은 이를 도입한 주요 버전 릴리스별로 분류됩니다. 라이브러리 버전을 업그레이드할 때 현재 버전과 업그레이드 예정 버전 간의 호환성이 손상되는 변경을 모두 해결합니다.

이 라이브러리 버전에는 다음과 같은 호환성이 손상되는 변경이 도입되었습니다.

  • 최소 Laravel 버전은 이제 10.0입니다. Laravel 버전 업그레이드에 대한 지침은 Laravel 문서의 업그레이드 가이드를 참조하세요.

  • 이제 종속성 이름은 "mongodb/laravel-mongodb" 입니다. composer.json 파일의 종속성 이름이 "mongodb/laravel-mongodb": "^4.0" 인지 확인합니다. 그런 다음 composer update 을(를) 실행합니다.

  • 네임스페이스는 이제 MongoDB\Laravel\ 입니다. 모델 및 구성 파일에서 네임스페이스를 Jenssegers\Mongodb\ 에서 MongoDB\Laravel\ 로 변경해야 합니다.

  • Laravel이 아닌 프로젝트에 대한 지원을 제거합니다.

  • $dates 속성에 대한 지원을 제거합니다. 모델 파일에서 $dates 의 모든 인스턴스를 $casts 로 변경했는지 확인합니다.

  • Model::unset($field) 변경 사항을 유지하지 않습니다. Model::save() 을 사용하여 Model::unset($field) 에 대한 모든 호출을 따라야 합니다.

  • Query\Builder::whereAll($column, $values) 메서드를 제거합니다. 로 바꿔야 Query\Builder::whereAll($column, $values) 합니다.Query\Builder::where($column, 'all', $values)

  • Query\Builder::delete() 하나 또는 모든 문서를 삭제할 수 있습니다. 또는 값만 에 전달해야 1 합니다.null limit()

  • whereDate(), whereDay(), whereMonth(), whereYear()whereTime() 메서드는 이제 날짜 필드에 MongoDB 연산자를 사용합니다.

  • MongoDB\Laravel\Eloquent\MassPrunable 트레이트를 추가합니다. 모델에서 Illuminate\Database\Eloquent\MassPrunable 의 모든 인스턴스를 MongoDB\Laravel\Eloquent\MassPrunable (으)로 바꿔야 합니다.

  • 다음 Query\Builder 메서드에 대한 지원을 제거합니다.

    • toSql()

    • toRawSql()

    • whereColumn()

    • whereFullText()

    • groupByRaw()

    • orderByRaw()

    • unionAll()

    • union()

    • having()

    • havingRaw()

    • havingBetween()

    • whereIntegerInRaw()

    • orWhereIntegerInRaw()

    • whereIntegerNotInRaw()

    • orWhereIntegerNotInRaw()

돌아가기

호환성

이 페이지의 내용