MongoDB

소개

MongoDB는 가장 인기 있는 NoSQL 문서 지향 데이터베이스 중 하나로, 높은 쓰기 부하(분석 또는 IoT에 유용)와 높은 가용성(자동 장애 조치가 가능한 복제 세트 설정이 쉬움)으로 사용됩니다. 또한 데이터베이스를 쉽게 샤딩하여 수평 확장이 가능하며, 집계, 텍스트 검색, 지리 공간 쿼리 등을 위한 강력한 쿼리 언어를 제공합니다.

MongoDB는 SQL 데이터베이스처럼 행과 열의 테이블에 데이터를 저장하는 대신, 각 레코드를 BSON으로 설명된 문서로 저장합니다. BSON은 데이터의 이진 표현이며, 애플리케이션은 이 정보를 JSON 형식으로 가져올 수 있습니다. 문서, 배열, 중첩 문서, 이진 데이터 등 다양한 데이터 타입을 지원합니다.

Laravel에서 MongoDB를 사용하기 전에 Composer를 통해 mongodb/laravel-mongodb 패키지를 설치하고 사용하는 것을 권장합니다. laravel-mongodb 패키지는 MongoDB에서 공식적으로 관리하며, MongoDB는 PHP에서 MongoDB 드라이버를 통해 기본적으로 지원되지만, Laravel MongoDB 패키지는 Eloquent 및 기타 Laravel 기능과의 더 풍부한 통합을 제공합니다:

composer require mongodb/laravel-mongodb

설치

MongoDB 드라이버

MongoDB 데이터베이스에 연결하려면 mongodb PHP 확장이 필요합니다. Laravel Herd를 사용하거나 php.new를 통해 PHP를 설치한 경우, 이미 이 확장이 시스템에 설치되어 있습니다. 그러나 확장을 수동으로 설치해야 하는 경우, PECL을 통해 설치할 수 있습니다:

pecl install mongodb

MongoDB PHP 확장 설치에 대한 자세한 내용은 MongoDB PHP 확장 설치 안내를 참고하세요.

MongoDB 서버 시작하기

MongoDB Community Server는 로컬에서 MongoDB를 실행하는 데 사용할 수 있으며, Windows, macOS, Linux 또는 Docker 컨테이너로 설치할 수 있습니다. MongoDB 설치 방법은 공식 MongoDB Community 설치 가이드를 참고하세요.

MongoDB 서버의 연결 문자열은 .env 파일에 설정할 수 있습니다:

MONGODB_URI="mongodb://localhost:27017"
MONGODB_DATABASE="laravel_app"

클라우드에서 MongoDB를 호스팅하려면 MongoDB Atlas를 사용하는 것을 고려해보세요. 애플리케이션에서 로컬로 MongoDB Atlas 클러스터에 접근하려면, 클러스터의 네트워크 설정에서 자신의 IP 주소를 추가해야 합니다.

MongoDB Atlas의 연결 문자열도 .env 파일에 설정할 수 있습니다:

MONGODB_URI="mongodb+srv://<username>:<password>@<cluster>.mongodb.net/<dbname>?retryWrites=true&w=majority"
MONGODB_DATABASE="laravel_app"

Laravel MongoDB 패키지 설치

마지막으로, Composer를 사용하여 Laravel MongoDB 패키지를 설치하세요:

composer require mongodb/laravel-mongodb

NOTE

mongodb PHP 확장이 설치되어 있지 않으면 이 패키지 설치가 실패합니다. PHP 설정은 CLI와 웹 서버에서 다를 수 있으므로, 두 환경 모두에서 확장이 활성화되어 있는지 확인하세요.

설정

애플리케이션의 config/database.php 설정 파일을 통해 MongoDB 연결을 구성할 수 있습니다. 이 파일 내에 mongodb 드라이버를 사용하는 mongodb 연결을 추가하세요:

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => env('MONGODB_URI', 'mongodb://localhost:27017'),
        'database' => env('MONGODB_DATABASE', 'laravel_app'),
    ],
],

기능

설정이 완료되면, 애플리케이션에서 mongodb 패키지와 데이터베이스 연결을 사용하여 다양한 강력한 기능을 활용할 수 있습니다:

• Eloquent 사용 시, 모델을 MongoDB 컬렉션에 저장할 수 있습니다. 표준 Eloquent 기능 외에도, Laravel MongoDB 패키지는 임베디드 관계와 같은 추가 기능을 제공합니다. 또한 MongoDB 드라이버에 직접 접근하여 원시 쿼리 및 집계 파이프라인과 같은 작업을 실행할 수 있습니다.
• 쿼리 빌더를 사용하여 복잡한 쿼리 작성이 가능합니다.
• mongodb 캐시 드라이버는 TTL 인덱스와 같은 MongoDB 기능을 활용하여 만료된 캐시 항목을 자동으로 삭제하도록 최적화되어 있습니다.
• mongodb 큐 드라이버로 큐 작업을 디스패치하고 처리할 수 있습니다.
• GridFS를 통한 파일 저장이 Flysystem의 GridFS 어댑터를 통해 가능합니다.
• 데이터베이스 연결 또는 Eloquent를 사용하는 대부분의 서드파티 패키지는 MongoDB와 함께 사용할 수 있습니다.

MongoDB와 Laravel을 사용하는 방법을 더 배우려면 MongoDB의 빠른 시작 가이드를 참고하세요.