Diese Bibliothek bietet eine Abstraktion auf hoher Ebene rund um den PHP-Treiber auf niedrigerer Ebene ( mongodb
-Erweiterung).
Während die Erweiterung eine eingeschränkte API zum Ausführen von Befehlen, Abfragen und Schreibvorgängen bereitstellt, implementiert diese Bibliothek eine voll funktionsfähige API, die der anderer MongoDB-Treiber ähnelt. Es enthält Abstraktionen für Client-, Datenbank- und Sammlungsobjekte und stellt Methoden für CRUD-Operationen und allgemeine Befehle (z. B. Index- und Sammlungsverwaltung) bereit.
Wenn Sie eine Anwendung mit MongoDB entwickeln, sollten Sie die Verwendung dieser Bibliothek oder einer anderen Abstraktion auf hoher Ebene anstelle der Erweiterung allein in Betracht ziehen.
Weitere Informationen zur Architektur dieser Bibliothek und der mongodb
Erweiterung finden Sie im Architekturüberblick.
Die bevorzugte Methode zur Installation dieser Bibliothek ist die Verwendung von Composer, indem Sie Folgendes in Ihrem Projektstammverzeichnis ausführen:
$ composer require mongodb/mongodb
Weitere Installationsanweisungen finden Sie in der Bibliotheksdokumentation.
Da es sich bei dieser Bibliothek um eine High-Level-Abstraktion für den Treiber handelt, muss auch die mongodb
Erweiterung installiert werden:
$ pecl install mongodb
$ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
Weitere Installationsanweisungen für die Erweiterung finden Sie in der PHP.net-Dokumentation.
Releases werden automatisch erstellt und das resultierende Release-Tag wird mit dem GPG-Schlüssel des PHP-Teams signiert. Um die Tag-Signatur zu überprüfen, laden Sie den Schlüssel herunter und importieren Sie ihn mit gpg
:
gpg --import php-driver.asc
Überprüfen Sie dann in einem lokalen Klon die Signatur eines bestimmten Tags (z. B. 1.19.0
):
git show --show-signature 1.19.0
Notiz
Composer unterstützt die Überprüfung von Signaturen im Rahmen seines Installationsprozesses nicht.
Probleme im Zusammenhang mit der Bibliothek sollten im PHPLIB-Projekt in MongoDBs JIRA gemeldet werden. Erweiterungsbezogene Probleme sollten im PHPC-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 PHPLIB-Projekt in MongoDBs JIRA verfolgt. Die Dokumentation für Beiträge zu diesem Projekt finden Sie unter CONTRIBUTING.md.