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

创建MongoDB客户端

在此页面上

  • Overview
  • 连接 URI
  • 创建 MongoDBClient
  • API 文档

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

  • 连接 URI (也称为连接string ),用于告知PHP库要连接到哪个MongoDB部署。

  • MongoDB\Client对象,用于创建与MongoDB 部署的连接并允许您对其执行操作。

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

本指南介绍了连接string的组件,并演示了如何使用 MongoDB\Client对象连接到MongoDB部署。

标准连接string包括以下组件:

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

要学习;了解有关连接字符串的更多信息,请参阅服务器手册中的连接字符串

要创建与MongoDB的连接,请在构造 MongoDB\Client 类的实例时传递连接string 。

在以下示例中,该库使用示例连接 URI 连接到localhost的端口27017上的MongoDB 部署:

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

要学习;了解有关在PHP库中创建MongoDB\Client对象的详情,请参阅以下API文档:

后退

连接至 MongoDB