Skip to content
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待
虚位以待

MongoDB

简介

MongoDB 是最流行的 NoSQL 面向文档数据库之一,因其高写入负载(适用于分析或物联网)和高可用性(易于设置具有自动故障转移的副本集)而广受欢迎。它还可以轻松地进行数据库分片以实现水平扩展,并拥有强大的查询语言,用于执行聚合、文本搜索或地理空间查询。

与 SQL 数据库将数据存储在行或列表格中不同,MongoDB 数据库中的每条记录都是一个用 BSON(数据的二进制表示)描述的文档。应用程序随后可以以 JSON 格式检索这些信息。它支持多种数据类型,包括文档、数组、嵌入式文档和二进制数据。

在 Laravel 中使用 MongoDB 之前,我们建议通过 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 社区版服务器可用于在本地运行 MongoDB,并且可以在 Windows、macOS、Linux 上安装,或作为 Docker 容器使用。要了解如何安装 MongoDB,请参考 官方 MongoDB 社区版安装指南

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

NOTE

如果未安装 mongodb PHP 扩展,此包的安装将会失败。PHP 配置在 CLI 和 Web 服务器之间可能有所不同,因此请确保在两个配置中都启用了该扩展。

配置

你可以通过应用程序的 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 包和数据库连接来利用多种强大功能:

  • 使用 Eloquent,模型可以存储在 MongoDB 集合中。除了标准的 Eloquent 功能外,Laravel MongoDB 包还提供了额外功能,例如嵌入式关系。该包还提供了对 MongoDB 驱动的直接访问,可用于执行原始查询和聚合管道等操作。
  • 使用查询构建器编写复杂查询
  • mongodb 缓存驱动经过优化,可以利用 MongoDB 的 TTL 索引等功能自动清除过期的缓存条目。
  • 使用 mongodb 队列驱动分发和处理排队任务
  • 在 GridFS 中存储文件,通过 Flysystem 的 GridFS 适配器
  • 大多数使用数据库连接或 Eloquent 的第三方包都可以与 MongoDB 一起使用。

要继续学习如何使用 MongoDB 和 Laravel,请参考 MongoDB 的快速入门指南