选择连接目标

本页内容

概述

Atlas
本地部署
副本集
初始化
API 文档

概述

在本指南中，您可以了解如何使用连接字符串和MongoDB\Client对象连接到不同类型的MongoDB部署。

Atlas

要连接到Atlas上的MongoDB部署，请将以下元素包含在您的连接字符串中：

Atlas集群的URI
数据库用户名
数据库用户的密码

然后，将您的连接字符串传递给MongoDB\Client构造函数。

当您连接到Atlas时，我们建议使用稳定API客户端选项，以避免Atlas升级到MongoDB服务器的新版本时出现破坏性更改。有关稳定API功能的更多信息，请参阅稳定API页面.

以下代码演示了如何使用PHP库连接到Atlas集群。代码还使用serverApi选项指定稳定API版本。

<?php
// Replace the placeholder with your Atlas connection string
$uri = '<connection string>';
// Create a MongoDB client with server API options
$client = new MongoDB\Client($uri, [], [
    'serverApi' => new MongoDB\Driver\ServerApi('1')
]);
// Ping the server to verify that the connection works
$admin = $client->admin;
$command = new MongoDB\Driver\Command(['ping' => 1]);
$result = $admin->command($command)->toArray();
echo json_encode($result), PHP_EOL;
echo 'Pinged your deployment. You successfully connected to MongoDB!\n';

提示

按照快速入门中的创建连接字符串步骤获取您的连接字符串。

本地部署

要连接到本地MongoDB部署，请将localhost用作主机名。默认情况下，mongod进程运行在端口27017上，尽管您可以为您自己的部署自定义此设置。

以下代码演示了如何使用PHP库连接到本地MongoDB部署

<?php
$client = new MongoDB\Client("mongodb://localhost:27017");

副本集

要连接到副本集，请在您的连接字符串中指定副本集成员的主机名（或IP地址）和端口号。

如果您无法提供副本集的完整主机列表，您可以指定副本集中的一个或多个主机，并指示PHP库执行自动发现以找到其他主机。要指示驱动程序执行自动发现，请选择以下操作之一

将副本集的名称指定为replicaSet参数的值。
将false指定为directConnection参数的值。
指定副本集中的多个主机。

以下示例中，驱动程序使用示例连接URI连接到运行在三个不同主机（包括host1）的端口号27017的MongoDB副本集sampleRS。

<?php
$uri = 'mongodb://host1:27017/?replicaSet=sampleRS';
// Create a MongoDB client
$client = new MongoDB\Client($uri);

初始化

要初始化副本集，您必须直接连接到单个成员。为此，请将连接字符串中的directConnection连接选项设置为true。以下代码示例显示了如何设置此连接选项

<?php
// Replace the placeholders with your actual hostname and port
$uri = 'mongodb://<hostname>:<port>/?directConnection=true';
// Create a MongoDB client
$client = new MongoDB\Client($uri);

API 文档

有关使用MongoDB\Client类的更多信息，请参阅以下API文档

MongoDB\Client

指定连接选项

配置 TLS