Эта библиотека обеспечивает высокоуровневую абстракцию вокруг драйвера PHP нижнего уровня (расширение mongodb
).
Хотя расширение предоставляет ограниченный API для выполнения команд, запросов и операций записи, эта библиотека реализует полнофункциональный API, аналогичный API других драйверов MongoDB. Он содержит абстракции для объектов клиента, базы данных и коллекции, а также предоставляет методы для операций 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.
Релизы создаются автоматически, а полученный тег релиза подписывается с помощью ключа GPG команды PHP. Чтобы проверить подпись тега, загрузите ключ и импортируйте его с помощью gpg
:
gpg --import php-driver.asc
Затем в локальном клоне проверьте подпись данного тега (например, 1.19.0
):
git show --show-signature 1.19.0
Примечание
Composer не поддерживает проверку подписей в процессе установки.
О проблемах, связанных с библиотекой, следует сообщать в проекте PHPLIB в JIRA MongoDB. О проблемах, связанных с расширениями, следует сообщать в проекте PHPC.
Для общих вопросов и запросов на поддержку воспользуйтесь одним из каналов технической поддержки MongoDB.
Если вы обнаружили уязвимость безопасности в драйвере или любом другом проекте MongoDB, сообщите об этом в соответствии с инструкциями в разделе «Создание отчета об уязвимостях».
Развитие отслеживается в проекте PHPLIB в JIRA MongoDB. Документацию для участия в этом проекте можно найти на сайте CONTRIBUTING.md.