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