数据库和集合

Overview

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

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

要学习；了解有关文档数据格式的更多信息，请参阅服务器手册中的文档。

在连接配置中指定数据库

您可以在应用程序的config/database.php文件中指定连接使用的数据库名称。 此文件中的 connections属性存储所有数据库连接信息，例如连接string 、数据库名称以及可选的身份验证详细信息。 指定数据库连接后，您可以执行数据库级操作并访问权限数据库包含的集合。

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

以下示例展示了如何设立默认数据库连接，并通过设置dsn和database属性在config/database.php文件中创建与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()

listCollections

您可以执行以下任一操作来查看有关数据库中集合的信息：

• 运行shell命令

• 调用数据库或模式方法

php artisan db:show

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

列出集合字段

您可以执行以下任一操作来查看有关集合中每个字段的信息：

• 运行shell命令

• 调用模式方法

php artisan db:table <collection name>

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

创建和拖放集合

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

删除数据库

To delete a database from your MongoDB deployment, call the getMongoClient() method on the DB facade to access your client. Then, call the MongoDB PHP Library's dropDatabase() method and pass the name of the database to delete as an argument.

以下示例删除名为 test_database 的数据库：

$client = DB::getMongoClient();
$client->dropDatabase('test_database');

运行命令

您可以通过在数据库连接实例上调用command()方法来直接在数据库上运行MongoDB命令。

要运行命令，请调用command()方法并向其传递包含该命令及其参数的文档。

以下示例对使用 sample_mflix 数据库的数据库连接实例执行这些操作：

• 创建引用sample_mflix数据库的数据库连接实例

• 指定用于检索sample_mflix数据库中的集合和视图列表的命令

• 打印命令返回的每个结果的name字段的值

该示例调用command()方法来运行listCollections命令。 此方法返回一个游标，其中包含数据库中每个集合的结果文档。

$cursor = DB::connection('mongodb')
    ->command(['listCollections' => 1]);
foreach ($cursor as $coll) {
    echo $coll['name'] . "<br>\n";
}

sessions
movies
theaters
comments
embedded_movies
users