Skip to content

MongoDB

簡介

MongoDB 是最受歡迎的 NoSQL 文件導向資料庫之一,因其高寫入負載(適用於分析或 IoT)和高可用性(易於設定具有自動故障轉移的副本集)而廣受使用。它還可以輕鬆地對資料庫進行分片以實現水平擴展性,並具有強大的查詢語言,可用於執行聚合、文本搜尋或地理空間查詢。

不同於 SQL 資料庫將資料儲存在行或列的表格中,MongoDB 資料庫中的每個記錄都是一個以 BSON 描述的文件,BSON 是資料的二進位表示。應用程式可以以 JSON 格式檢索這些資訊。它支援多種資料類型,包括文件、陣列、嵌入式文件和二進位資料。

在使用 MongoDB 與 Laravel 之前,我們建議透過 Composer 安裝並使用 mongodb/laravel-mongodb 套件。laravel-mongodb 套件由 MongoDB 官方維護,儘管 MongoDB 透過 MongoDB 驅動程式原生支援 PHP,但 Laravel MongoDB 套件提供了與 Eloquent 和其他 Laravel 功能更豐富的整合:

shell
composer require mongodb/laravel-mongodb

安裝

MongoDB 驅動程式

要連接到 MongoDB 資料庫,需要 mongodb PHP 擴充功能。如果您正在使用 Laravel Herd 進行本地開發或透過 php.new 安裝 PHP,您的系統上已經安裝了此擴充功能。但是,如果您需要手動安裝擴充功能,可以透過 PECL 進行:

shell
pecl install mongodb

有關安裝 MongoDB PHP 擴充功能的更多資訊,請查閱 MongoDB PHP 擴充功能安裝說明

啟動 MongoDB 伺服器

MongoDB Community Server 可用於本地執行 MongoDB,並可安裝在 Windows、macOS、Linux 或作為 Docker 容器。要了解如何安裝 MongoDB,請參閱 官方 MongoDB Community 安裝指南

MongoDB 伺服器的連接字串可以在您的 .env 檔案中設定:

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

對於在雲端託管 MongoDB,請考慮使用 MongoDB Atlas。 若要從您的應用程式本地存取 MongoDB Atlas 集群,您需要將您自己的 IP 位址新增至集群的網路設定中的專案 IP 存取列表。

MongoDB Atlas 的連接字串也可以在您的 .env 檔案中設定:

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

安裝 Laravel MongoDB 套件

最後,使用 Composer 安裝 Laravel MongoDB 套件:

shell
composer require mongodb/laravel-mongodb

📌 備註

如果未安裝 mongodb PHP 擴充功能,此套件的安裝將會失敗。PHP 設定在 CLI 和網頁伺服器之間可能有所不同,請確保在兩種設定中都啟用該擴充功能。

設定

您可以透過應用程式的 config/database.php 設定檔來配置您的 MongoDB 連線。在此檔案中,新增一個使用 mongodb 驅動程式的 mongodb 連線:

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

功能

一旦您的設定完成,您就可以在應用程式中使用 mongodb 套件和資料庫連線,以利用各種強大的功能:

要繼續學習如何使用 MongoDB 和 Laravel,請參閱 MongoDB 的 快速入門指南