数据库与集合

概述

在本指南中，您可以了解如何使用Laravel MongoDB访问和管理MongoDB数据库和集合。

MongoDB以层次结构组织数据。MongoDB部署包含一个或多个数据库，每个数据库包含一个或多个集合。在每个集合中，MongoDB以包含字段和值对的文档形式存储数据。在Laravel集成中，您可以通过Eloquent模型访问文档。

有关文档数据格式的更多信息，请参阅文档在服务器手册中。

在连接配置中指定数据库

您可以在应用程序的config/database.php文件中指定连接使用的数据库名称。该文件中的connections属性存储了所有数据库连接信息，例如您的连接字符串、数据库名称以及可选的认证详情。指定数据库连接后，您可以进行数据库级操作并访问数据库包含的集合。

如果将database属性设置为不存在数据库的名称，Laravel仍然会建立有效的连接。当您在数据库中的集合中插入任何数据时，服务器会自动创建它。

以下示例显示了如何在config/database.php文件中设置默认数据库连接，并通过设置dsn和database属性来创建对animals数据库的连接：

'default' => 'mongodb',
'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'animals',
    ], ...
]

当您设置默认数据库连接时，Laravel集成会使用该连接进行操作，但您可以在您的 config/database.php 文件中指定多个数据库连接。

以下示例展示了如何指定多个数据库连接（mongodb 和 mongodb_alt）来访问 animals 和 plants 数据库。

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'animals',
    ],
    'mongodb_alt' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'plants',
    ]
], ...

如果您的应用程序包含多个数据库连接，并且您想将模型存储在除默认数据库之外的其他数据库中，请覆盖您的 Model 类中的 $connection 属性。

以下示例展示了如何覆盖 Flower 模型类中的 $connection 属性以使用 mongodb_alt 连接。这会将Laravel集成指向存储在 plants 数据库的 flowers 集合中的模型，而不是默认数据库。

class Flower extends Model
{
    protected $connection = 'mongodb_alt';
}

访问集合

当您创建扩展 MongoDB\Laravel\Eloquent\Model 的模型类时，Laravel集成会将模型数据存储在具有与您的模型类名称蛇形复数形式命名的集合中。

例如，如果您创建一个名为 Flower 的模型类，Laravel会将模型应用于数据库中的 flowers 集合。

我们通常建议您使用Eloquent ORM来访问集合，以提高代码的可读性和可维护性。以下示例使用 Flower 类指定查找操作，因此Laravel从 flowers 集合检索结果。

Flower::where('name', 'Water Lily')->get()

如果您无法通过Eloquent模型完成操作，可以通过调用DB门面的table()方法来访问查询构建器。以下示例显示了与上一个示例相同的查询，但查询是通过使用DB::table()方法构建的。

DB::connection('mongodb')
    ->table('flowers')
    ->where('name', 'Water Lily')
    ->get()

列出集合

您可以通过以下任一操作来查看数据库中集合的信息：

• 运行 shell 命令

• 调用数据库或模式方法

php artisan db:show

$collections = DB::connection('mongodb')->getMongoDB()->listCollections();

集合字段列表

您可以通过以下任一操作查看集合中每个字段的详细信息

• 运行 shell 命令

• 调用模式方法

php artisan db:table <collection name>

$fields = Schema::getColumns('flowers');

创建和删除集合

要了解如何创建和删除集合，请参阅Schema Builder指南中的执行Laravel迁移部分。