开始使用MongoDB PHP库

安装依赖项

在开始开发之前，请确保本地计算机上安装了以下依赖项：

• PHP 版本 7.4 或更高版本

• Composer 版本为 2.0 或更高版本

• pie

安装MongoDB PHP扩展

运行以下命令安装 mongodb PHP扩展：

pie install mongodb/mongodb-extension

pie install mongodb/mongodb-extension:^2.1.4

创建项目目录

在根目录中，在shell中运行以下命令，为此项目创建一个名为 php-quickstart 的目录：

mkdir php-quickstart

选择与操作系统对应的标签页并运行以下命令，在php-quickstart目录中创建quickstart.php应用程序文件：

cd php-quickstart
touch quickstart.php

cd php-quickstart
type nul > quickstart.php

安装 MongoDB PHP 库

要安装MongoDB PHP库，请在php-quickstart目录中运行以下命令：

composer require mongodb/mongodb

安装该库后，将以下代码添加到quickstart.php文件顶部，以包含 Composer 的autoload.php文件：

<?php
require_once __DIR__ . '/vendor/autoload.php';

在 Atlas 上创建免费的 MongoDB 部署

完成MongoDB指南，设立新的Atlas帐户并将示例数据加载到新的免费套餐MongoDB部署。按照 Cloud Deployment 标签页中的说明在云中创建MongoDB Atlas部署。

保存您的档案

创建数据库用户后，将该用户的数据库用户名和数据库保存到安全位置，以便在下一步中使用。

查找 MongoDB Atlas 连接字符串

要检索您在上一步中创建的部署的连接字符串，登录您的Atlas帐户并导航到Database部分，然后单击新部署的Connect按钮。

然后，从Select database user选择菜单中选择您的用户。 从 选择菜单中选择“PHP”，然后从Driver Version选择菜单中选择与您安装的版本最匹配的版本。

在 Add connection string into your application code 步骤中选择 String标签页，仅查看连接string 。

复制连接字符串

单击连接string右侧的按钮将其复制到剪贴板，如以下屏幕截图所示：

更新占位符

将此连接字符串粘贴到您首选文本编辑器中的文件中，并将<username>和<password>占位符替换为数据库用户的用户名和密码。

将此文件保存到安全位置，以便在下一步中使用。

编辑PHP应用程序文件

将以下代码复制并粘贴到quickstart.php文件中，该文件将查询sample_mflix数据库中的movies集合：

<?php
require __DIR__ . '/../vendor/autoload.php';
$uri = getenv('MONGODB_URI') ?: throw new RuntimeException(
    'Set the MONGODB_URI environment variable to your Atlas URI',
);
$client = new MongoDB\Client($uri);
$collection = $client->sample_mflix->movies;
$filter = ['title' => 'The Shawshank Redemption'];
$result = $collection->findOne($filter);
if ($result) {
    echo json_encode($result, JSON_PRETTY_PRINT);
} else {
    echo 'Document not found';
}

指定连接字符串

将MONGODB_URI 环境变量分配给您从本指南的“创建连接字符串”步骤中复制的连接字符串。您可以通过运行Shell命令或在应用程序中创建 .env文件来分配此变量，如以下标签页所示：

export MONGODB_URI=<connection string>

MONGODB_URI=<connection string>

运行PHP应用程序

在项目目录中，运行以下shell命令以启动应用程序：

php quickstart.php

命令行输出包含有关检索到的电影文档的详细信息：

{
    "_id": {
        "$oid": "..."
    },
    ...
   "rated": "R",
   "metacritic": 80,
   "title": "The Shawshank Redemption",
   ...
}

如果遇到错误或看不到输出，请确保将正确的连接string分配给 MONGODB_URI 环境变量并加载示例数据。