文档菜单
文档首页
/ / /
PHP 库手册
/

创建 MongoDB 客户端

本页内容

  • 概述
  • 连接URI
  • 创建MongoDBClient
  • API 文档

要连接到MongoDB部署,您必须创建以下项目

  • 连接URI,也称为连接字符串,它告诉PHP库连接到哪个MongoDB部署。

  • MongoDB.Client对象,它创建到MongoDB部署的连接并允许您对其进行操作。

您还可以在这两个组件中设置选项,以自定义PHP库连接MongoDB时的行为。

本指南描述了连接字符串的组件,并展示了如何使用MongoDB.Client对象连接到MongoDB部署。

标准连接字符串包括以下组件

组件
描述
mongodb://
必需。一个前缀,用于标识这是标准连接格式中的字符串。
db_username:db_password
可选。认证凭据。如果您包含这些凭据,则客户端将用户与在authSource中指定的数据库进行认证。有关authSource连接选项的更多信息,请参阅认证机制.
host[:port]
必需。MongoDB运行的主机和可选的端口号。如果您不包含端口号,则驱动程序使用默认端口号27017
/defaultauthdb
可选。如果连接字符串包含db_username:db_password@认证凭据但未包含authSource选项,则使用的认证数据库。如果您不包含此组件,则客户端将对admin数据库进行用户认证。
?<options>
可选。一个查询字符串,指定连接特定选项为<name>=<value>对。有关这些选项的完整描述,请参阅指定连接选项

有关连接字符串的更多信息,请参阅连接字符串 在服务器手册中。

要连接到 MongoDB,请在构造 MongoDB\Client 类的实例时传递您的连接字符串。

在下面的示例中,库使用一个示例连接 URI 连接到本地主机 localhost 的端口 27017 上的 MongoDB 部署。

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

有关在 PHP 库中创建 MongoDB\Client 对象的更多信息,请参阅以下 API 文档。

返回

连接到 MongoDB