라이브러리 버전 업그레이드
이 페이지의 내용
개요
이 페이지에서는 새 버전의 MongoDB PHP 라이브러리로 업그레이드 할 때 애플리케이션 을 변경해야 하는 사항에 학습 수 있습니다. 이 페이지에는 PHP 확장을 새 버전으로 업그레이드 하는 방법도 포함되어 있습니다.
업그레이드 방법
업그레이드하기 전에 다음 작업을 수행하세요:
새 PHP 라이브러리 버전이 애플리케이션 이 연결되는 MongoDB Server 버전 및 애플리케이션 컴파일에 사용되는 PHP 버전과 호환되는지 확인합니다. 버전 호환성 정보는 MongoDB PHP 라이브러리 호환성 페이지를 참조하세요.
애플리케이션 에서 사용 중인 라이브러리 버전과 업그레이드 예정 버전 간의 호환성이 손상되는 변경은 호환성이 손상되는 변경 섹션에서 확인하세요.
팁
라이브러리 버전을 업그레이드할 때 MongoDB Server 버전 간의 호환성을 보장하려면 Stable API 를 사용하세요.
PHP 확장과 라이브러리의 메이저 버전과 마이너 버전이 동기화 되었습니다. 즉, 확장에 대한 업그레이드 명령을 실행 하여 PHP 라이브러리도 업그레이드 할 수 있습니다.
라이브러리와 확장의 패치 버전(xxx)이 동기화 되지 않습니다. 해당 명령을 실행하여 라이브러리 또는 확장의 패치 버전으로 업데이트 합니다.
PHP 확장을 업그레이드 하려면 <version-number>
을 업그레이드 하려는 버전 번호로 바꾸고 애플리케이션 디렉토리 에서 다음 명령을 실행 합니다.
pecl upgrade mongodb-<version-number>
PHP 라이브러리 버전을 업그레이드 하려면 <version-number>
을(를) 업그레이드 하려는 버전 번호로 바꾸고 애플리케이션 디렉토리 에서 다음 명령을 실행 합니다.
composer require mongodb/mongodb:<version-number>
자세한 설치 지침은 PHP.net 설명서에서 확인할 수 있습니다.
호환성이 손상되는 변경
호환성이 손상되는 변경 은 라이브러리의 특정 버전에서 시작되는 규칙 또는 동작의 변경입니다. This type of change may prevent your application from working properly if not addressed before upgrading the library.
이 섹션의 호환성이 손상되는 변경은 이를 도입한 라이브러리 버전별로 분류됩니다. 라이브러리 버전을 업그레이드할 때 현재 버전과 업그레이드 버전 간의 호환성이 손상되는 변경을 모두 주소 합니다.
출시하다 변경 사항에 대한 자세한 내용은 에서 출시하다 노트 및 각 출시하다 에 대한 관련 JIRA 티켓을 Github 참조하세요.
버전 1.20 호환성이 손상되는 변경
이 라이브러리 버전에는 다음과 같은 호환성이 손상되는 변경이 도입되었습니다.
MongoDB Server 3.6 에 대한 지원 을 중단합니다.
버전 1.19 및 이전 버전
라이브러리 버전 1.19 이하의 경우 에서 출시하다 노트 및 각 출시하다 에 대한 관련 JIRA 티켓을 Github 참조하세요.