mongodb/mongodb

MongoDB 驱动库


README

Tests Coding Standards

此库在低级 PHP 驱动 (mongodb 扩展) 基础上提供了一组高级抽象。

虽然该扩展提供了执行命令、查询和写操作的限制性 API,但此库实现了类似其他 MongoDB 驱动的完整功能 API。它包含客户端、数据库和集合对象的抽象,并提供了 CRUD 操作和常见命令(例如索引和集合管理)的方法。

如果您正在开发使用 MongoDB 的应用程序,建议您使用此库或其他高级抽象,而不是仅使用扩展。

有关此库架构和 mongodb 扩展的更多信息,请参阅 架构概述

文档

安装

安装此库的首选方法是通过在项目根目录下运行以下命令使用 Composer

$ composer require mongodb/mongodb

有关安装的更多说明,请参阅 库文档

由于此库是驱动程序的高级抽象,因此它还需要安装 mongodb 扩展

$ pecl install mongodb
$ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:\s*||"`

有关扩展的更多安装说明,请参阅其 PHP.net 文档

发布完整性

发布是自动创建的,并使用 PHP 团队的 GPG 密钥 签名结果发布标签。要验证标签签名,请下载密钥并使用 gpg 导入它

gpg --import php-driver.asc

然后,在本地克隆中,验证给定标签(例如 1.19.0)的签名

git show --show-signature 1.19.0

注意

Composer 不支持将其安装过程作为其安装过程的一部分进行签名验证。

报告问题

有关库的问题应报告在 MongoDB 的 JIRA 中的 PHPLIB 项目中。有关扩展的问题应报告在 PHPC 项目中。

有关一般问题和支持请求,请使用 MongoDB 的 技术支持 通道之一。

安全漏洞

如果您在驱动程序或任何其他 MongoDB 项目中发现了安全漏洞,请根据 创建漏洞报告 中的说明进行报告。

开发

开发在 MongoDB 的 JIRA 中的 PHPLIB 项目中跟踪。有关为此项目做出贡献的文档可在 CONTRIBUTING.md 中找到。