Это расширение разработано на основе библиотек libmongoc и libbson. Он предоставляет минимальный API для основных функций драйвера: команды, запросы, запись, управление соединениями и сериализация BSON.
Библиотеки пользовательского пространства PHP, зависящие от этого расширения, могут предоставлять API более высокого уровня, такие как построители запросов, вспомогательные методы отдельных команд и GridFS. Разработчикам приложений следует рассмотреть возможность использования этого расширения в сочетании с PHP-библиотекой MongoDB, которая реализует те же API-интерфейсы более высокого уровня, что и драйверы MongoDB для других языков.
https://www.php.net/mongodb
https://www.mongodb.com/docs/drivers/php-drivers/
Чтобы собрать и установить драйвер:
$ pecl install mongodb $ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
Дополнительные инструкции по установке можно найти в документации PHP.net.
Это расширение предназначено для использования вместе с PHP-библиотекой MongoDB, которая распространяется как пакет mongodb/mongodb
для Composer.
Релизы создаются автоматически и подписываются с использованием ключа GPG команды PHP. Это относится к тегу git, а также ко всем пакетам выпуска, предоставляемым как часть выпуска GitHub. Чтобы проверить предоставленные пакеты, загрузите ключ и импортируйте его с помощью gpg
:
gpg --import php-driver.asc
Пакеты PECL доступны в виде артефактов выпуска на GitHub, а также на домашней странице PECL. Релиз GitHub также будет содержать отдельный файл подписи для пакета PECL (с именем mongodb-XYZtgz.sig
).
Чтобы проверить целостность загруженного пакета, выполните следующую команду:
gpg --verify mongodb-XYZtgz.sig mongodb-XYZtgz
Примечание
При использовании pecl
для установки пакета проверка не выполняется. Чтобы обеспечить целостность выпуска при использовании pecl
, загрузите архив вручную из выпуска GitHub, проверьте подпись, затем установите пакет из загруженного архива с помощью pecl install mongodb-XYZtgz
.
Двоичные файлы Windows, распространяемые через выпуски GitHub, содержат отдельную подпись для файла php_mongodb.dll
с именем php_mongodb.dll.sig
. Чтобы проверить целостность DLL, выполните следующую команду:
gpg --verify php_mongodb.dll.sig php_mongodb.dll.tgz
Примечание
Двоичные файлы Windows, распространяемые непосредственно через PECL, не подписаны MongoDB и не могут быть проверены. Если вам необходимо проверить целостность загруженного двоичного файла, всегда загружайте его из выпуска GitHub.
О проблемах, связанных с расширением, следует сообщать в проекте PHPC в JIRA MongoDB. О проблемах, связанных с библиотекой, следует сообщать в проекте PHPLIB.
Для общих вопросов и запросов на поддержку воспользуйтесь одним из каналов технической поддержки MongoDB.
Если вы обнаружили уязвимость безопасности в драйвере или любом другом проекте MongoDB, сообщите об этом в соответствии с инструкциями в разделе «Создание отчета об уязвимостях».
Развитие отслеживается в проекте PHPC в JIRA MongoDB. Документацию для участия в этом проекте можно найти на сайте CONTRIBUTING.md.