라이브러리 버전 업그레이드
이 페이지의 내용
개요
이 페이지에서는 Laravel MongoDB를 새로운 주요 버전으로 업그레이드하는 방법을 알아볼 수 있습니다. 이 페이지에는 해당되는 경우 기능 손실 없이 객체-문서 매퍼(ODM) 버전을 업그레이드하기 위해 애플리케이션에서 수행해야 하는 변경 사항도 포함되어 있습니다.
업그레이드 방법
업그레이드하기 전에 다음 작업을 수행하세요:
새 라이브러리 버전이 애플리케이션 이 연결되는 MongoDB Server 버전 및 애플리케이션 이 실행되는 Laravel 버전과 호환되는지 확인하세요. 이 정보는 호환성 페이지를 참조하세요.
이 가이드의 호환성이 손상되는변경 섹션에서 애플리케이션에서 현재 사용 중인 Laravel MongoDB 버전과 계획된 업그레이드 버전 간의 호환성이 손상되는 변경을 해결하세요.
라이브러리 버전을 업그레이드하려면 애플리케이션 디렉토리에서 다음 명령을 실행합니다.
composer require mongodb/laravel-mongodb:4.6
라이브러리의 다른 버전으로 업그레이드하려면 laravel-mongodb:
뒤의 정보를 원하는 버전 번호로 바꾸세요.
호환성이 손상되는 변경
호환성이 손상되는 호환성이 손상되는 변경 은 특정 버전의 Laravel MongoDB 에서 규칙이나 동작을 수정하여 애플리케이션 이 예상대로 작동하지 않도록 하는 것을 말합니다.
이 섹션의 호환성이 손상되는 변경은 이를 도입한 주요 버전 릴리스별로 분류됩니다. 라이브러리 버전을 업그레이드할 때 현재 버전과 업그레이드 예정 버전 간의 호환성이 손상되는 변경을 모두 해결합니다.
버전 4.x 호환성이 손상되는 변경
이 라이브러리 버전에는 다음과 같은 호환성이 손상되는 변경이 도입되었습니다.
최소 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()