创建 MongoDB 客户端
概述
要连接到MongoDB部署,您必须创建以下项目
连接URI,也称为连接字符串,它告诉PHP库连接到哪个MongoDB部署。
MongoDB.Client对象,它创建到MongoDB部署的连接并允许您对其进行操作。
您还可以在这两个组件中设置选项,以自定义PHP库连接MongoDB时的行为。
本指南描述了连接字符串的组件,并展示了如何使用MongoDB.Client
对象连接到MongoDB部署。
连接URI
标准连接字符串包括以下组件
组件 | 描述 |
---|---|
mongodb:// | 必需。一个前缀,用于标识这是标准连接格式中的字符串。 |
db_username:db_password | |
host[:port] | 必需。MongoDB运行的主机和可选的端口号。如果您不包含端口号,则驱动程序使用默认端口号 27017 。 |
/defaultauthdb | 可选。如果连接字符串包含 db_username:db_password@ 认证凭据但未包含authSource 选项,则使用的认证数据库。如果您不包含此组件,则客户端将对admin 数据库进行用户认证。 |
?<options> | 可选。一个查询字符串,指定连接特定选项为 <name>=<value> 对。有关这些选项的完整描述,请参阅指定连接选项。 |
有关连接字符串的更多信息,请参阅连接字符串 在服务器手册中。
创建一个 MongoDBClient
要连接到 MongoDB,请在构造 MongoDB\Client
类的实例时传递您的连接字符串。
在下面的示例中,库使用一个示例连接 URI 连接到本地主机 localhost
的端口 27017
上的 MongoDB 部署。
$client = new MongoDB\Client("mongodb://localhost:27017");
API 文档
有关在 PHP 库中创建 MongoDB\Client
对象的更多信息,请参阅以下 API 文档。