Docs 菜单
Docs 主页
/ / /
PHP 库手册

开始使用PHP库

在此页面上

  • Overview
  • 下载并安装
  • 安装依赖项
  • 安装MongoDB PHP扩展
  • 更新PHP配置文件
  • 创建项目目录
  • 安装 MongoDB PHP 库
  • 创建 MongoDB 部署
  • 在 Atlas 上创建免费的 MongoDB 部署
  • 保存您的档案
  • 创建连接字符串
  • 查找 MongoDB Atlas 连接字符串
  • 复制连接字符串
  • 更新占位符
  • 运行示例查询
  • 编辑PHP应用程序文件
  • 指定连接字符串
  • 运行PHP应用程序
  • 后续步骤

MongoDB PHP库是MongoDB PHP扩展的高级抽象,您可以使用它来连接到MongoDB并与部署中存储的数据交互。 本指南向您展示如何创建一个应用程序,使用MongoDB PHP库连接到MongoDB Atlas上托管的MongoDB 集群并查询集群中的数据。

提示

MongoDB Atlas 是完全托管的云数据库服务,旨在托管您的 MongoDB 部署。您可以按照本指南中的步骤创建您的免费(无需信用卡)MongoDB Atlas 部署。

按照本指南将示例PHP应用程序连接到MongoDB Atlas部署。 如果您希望使用不同的驾驶员或编程语言连接MongoDB ,请参阅我们的官方驱动程序的列表。

1

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

2

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

sudo pecl install mongodb
3

要在PHP配置文件中启用mongodb扩展,请将以下行添加到php.ini文件的顶部:

extension=mongodb.so

提示

您可以通过在shell中运行以下命令来找到 php.ini文件:

php --ini
4

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

mkdir php-quickstart

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

cd php-quickstart
touch quickstart.php
cd php-quickstart
type nul > quickstart.php
5

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

composer require mongodb/mongodb

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

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

完成这些步骤后,您就拥有了一个新的项目目录、一个新的应用程序文件以及安装的库依赖项。

您可以在 MongoDB Atlas 上创建一个免费套餐 MongoDB 部署来存储和管理您的数据。MongoDB Atlas 在云端托管和管理您的 MongoDB 数据库。

1

请按照 Atlas 入门指南中的步骤,设置新的 Atlas 账户并将示例数据加载到新的免费套餐 MongoDB 部署中。

2

创建数据库用户后,请将该用户的用户名和密码保存在一个安全位置,以便在后续步骤中使用。

完成这些步骤后,您就在 Atlas 上有了一个新的免费套餐 MongoDB 部署、数据库用户档案以及加载到数据库中的示例数据。

您可以通过提供连接 URI(也称为连接字符串)来连接到 MongoDB 部署,它指示驱动程序如何连接到 MongoDB 部署以及连接时的行为方式。

连接字符串包含部署的主机名或 IP 地址和端口、身份验证机制、用户档案(如果适用)以及连接选项。

1

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

Atlas 用户界面的集群部分中的连接按钮

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

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

2

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

用户界面中连接 旁边的复制按钮stringAtlas
3

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

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

完成这些步骤后,您就拥有了与string Atlas集群对应的连接 。

检索 部署的连接string MongoDB Atlas后,您可以从 应用程序连接到该部署并查询PHP Atlas示例数据集。

1

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

<?php
require __DIR__ . '/../vendor/autoload.php';
use MongoDB\Client;
$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';
}
2

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

export MONGODB_URI=<connection string>
MONGODB_URI=<connection string>
3

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

php quickstart.php

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

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

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

完成这些步骤后,您就拥有一个PHP应用程序,它可以连接到MongoDB 部署、对示例数据运行查询并返回匹配的文档。

恭喜您完成快速入门教程!

注意

如果您在该步骤中遇到问题,请在 MongoDB Community 论坛中寻求帮助,或使用本页右侧或右下角的 Rate this page 标签页提交反馈。

在本教程中,您创建了一个PHP应用程序,该应用程序连接到MongoDB Atlas上托管的MongoDB 部署,并检索与查询匹配的文档。

通过以下资源了解详情有关MongoDB PHP库的更多信息:

  • 在 读取数据 部分了解如何执行读取操作。

  • 通过“将数据写入MongoDB ”部分了解如何执行写入操作。

后退

MongoDB PHP 库