Diese Erweiterung wird auf Basis der Bibliotheken libmongoc und libbson entwickelt. Es bietet eine minimale API für die Kernfunktionen des Treibers: Befehle, Abfragen, Schreibvorgänge, Verbindungsverwaltung und BSON-Serialisierung.
Userland-PHP-Bibliotheken, die von dieser Erweiterung abhängen, stellen möglicherweise APIs höherer Ebene bereit, z. B. Abfrage-Builder, einzelne Befehlshilfemethoden und GridFS. Anwendungsentwickler sollten die Verwendung dieser Erweiterung in Verbindung mit der MongoDB-PHP-Bibliothek in Betracht ziehen, die dieselben übergeordneten APIs implementiert, die in MongoDB-Treibern für andere Sprachen zu finden sind.
https://www.php.net/mongodb
https://www.mongodb.com/docs/drivers/php-drivers/
So erstellen und installieren Sie den Treiber:
$ pecl install mongodb $ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
Weitere Installationsanweisungen finden Sie in der PHP.net-Dokumentation.
Diese Erweiterung soll zusammen mit der MongoDB-PHP-Bibliothek verwendet werden, die als mongodb/mongodb
-Paket für Composer verteilt wird.
Releases werden automatisch erstellt und mit dem GPG-Schlüssel des PHP-Teams signiert. Dies gilt sowohl für das Git-Tag als auch für alle Release-Pakete, die im Rahmen einer GitHub-Release bereitgestellt werden. Um die bereitgestellten Pakete zu überprüfen, laden Sie den Schlüssel herunter und importieren Sie ihn mit gpg
:
gpg --import php-driver.asc
PECL-Pakete werden als Release-Artefakte auf GitHub sowie auf der PECL-Homepage zur Verfügung gestellt. Die GitHub-Version wird auch eine separate Signaturdatei für das PECL-Paket (mit dem Namen mongodb-XYZtgz.sig
) enthalten.
Führen Sie den folgenden Befehl aus, um die Integrität des heruntergeladenen Pakets zu überprüfen:
gpg --verify mongodb-XYZtgz.sig mongodb-XYZtgz
Notiz
Bei Verwendung pecl
zur Installation des Pakets erfolgt keine Überprüfung. Um die Release-Integrität bei der Verwendung pecl
sicherzustellen, laden Sie den Tarball manuell von der GitHub-Version herunter, überprüfen Sie die Signatur und installieren Sie dann das Paket vom heruntergeladenen Tarball mit pecl install mongodb-XYZtgz
.
Über GitHub-Versionen verteilte Windows-Binärdateien enthalten eine separate Signatur für die Datei php_mongodb.dll
mit dem Namen php_mongodb.dll.sig
. Führen Sie den folgenden Befehl aus, um die Integrität der DLL zu überprüfen:
gpg --verify php_mongodb.dll.sig php_mongodb.dll.tgz
Notiz
Direkt über PECL verteilte Windows-Binärdateien werden nicht von MongoDB signiert und können nicht überprüft werden. Wenn Sie die Integrität der heruntergeladenen Binärdatei überprüfen müssen, laden Sie sie immer von der GitHub-Version herunter.
Probleme im Zusammenhang mit der Erweiterung sollten im PHPC-Projekt in MongoDBs JIRA gemeldet werden. Bibliotheksbezogene Probleme sollten im PHPLIB-Projekt gemeldet werden.
Für allgemeine Fragen und Supportanfragen nutzen Sie bitte einen der technischen Supportkanäle von MongoDB.
Wenn Sie eine Sicherheitslücke in einem Treiber oder einem anderen MongoDB-Projekt festgestellt haben, melden Sie diese bitte gemäß den Anweisungen unter Erstellen eines Schwachstellenberichts.
Die Entwicklung wird im PHPC-Projekt in MongoDBs JIRA verfolgt. Die Dokumentation für Beiträge zu diesem Projekt finden Sie unter CONTRIBUTING.md.