Laradoc

Appearance

MongoDB ​

簡介 ​

MongoDB 是最熱門的 NoSQL 文件導向資料庫之一，因其具備高寫入負載能力（適用於分析或物聯網）以及高可用性（可輕鬆設定具有自動故障轉移的副本集）而被廣泛使用。它還可以輕鬆地對資料庫進行分片（shard）以實現水平擴充，並擁有強大的查詢語言，可用於執行聚合、文字搜尋或地理空間查詢。

MongoDB 資料庫中的每筆紀錄不是像 SQL 資料庫那樣儲存在列或欄組成的資料表中，而是以 BSON 描述的文件（Document），這是一種資料的二進位表示法。應用程式接著可以 JSON 格式取得這些資訊。它支援多種資料類型，包括文件、陣列、內嵌文件與二進位資料。

在將 MongoDB 與 Laravel 一起使用之前，我們建議透過 Composer 安裝並使用 mongodb/laravel-mongodb 套件。laravel-mongodb 套件由 MongoDB 官方維護，雖然 PHP 透過 MongoDB 驅動程式原生支援 MongoDB，但 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 安裝指南。

可以在 .env 檔案中設定 MongoDB 伺服器的連線字串：

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

若要在雲端託管 MongoDB，可以考慮使用 MongoDB Atlas。 若要從應用程式在本機存取 MongoDB Atlas 叢集，您需要在叢集的網路設定中將您自己的 IP 位址新增至專案的 IP 存取清單（IP Access List）中。

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 擴充套件，此套件的安裝將會失敗。CLI 與 Web 伺服器之間的 PHP 設定可能有所不同，因此請確保在這兩種設定中皆已啟用該擴充套件。

設定 ​

您可以透過應用程式的 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 的快速入門指南。