Cette bibliothèque fournit une abstraction de haut niveau autour du pilote PHP de niveau inférieur (extension mongodb
).
Bien que l'extension fournisse une API limitée pour l'exécution de commandes, de requêtes et d'opérations d'écriture, cette bibliothèque implémente une API complète similaire à celle des autres pilotes MongoDB. Il contient des abstractions pour les objets client, base de données et collection, et fournit des méthodes pour les opérations CRUD et les commandes courantes (par exemple, gestion des index et des collections).
Si vous développez une application avec MongoDB, vous devriez envisager d'utiliser cette bibliothèque, ou une autre abstraction de haut niveau, au lieu de l'extension seule.
Des informations supplémentaires sur l'architecture de cette bibliothèque et l'extension mongodb
peuvent être trouvées dans Présentation de l'architecture.
La méthode préférée pour installer cette bibliothèque est avec Composer en exécutant ce qui suit à partir de la racine de votre projet :
$ composer require mongodb/mongodb
Des instructions d'installation supplémentaires peuvent être trouvées dans la documentation de la bibliothèque.
Puisque cette bibliothèque est une abstraction de haut niveau pour le pilote, elle nécessite également que l'extension mongodb
soit installée :
$ pecl install mongodb
$ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
Des instructions d'installation supplémentaires pour l'extension peuvent être trouvées dans sa documentation PHP.net.
Les versions sont créées automatiquement et la balise de version résultante est signée à l'aide de la clé GPG de l'équipe PHP. Pour vérifier la signature de la balise, téléchargez la clé et importez-la à l'aide gpg
:
gpg --import php-driver.asc
Ensuite, dans un clone local, vérifiez la signature d'une balise donnée (par exemple 1.19.0
) :
git show --show-signature 1.19.0
Note
Composer ne prend pas en charge la vérification des signatures dans le cadre de son processus d'installation.
Les problèmes relatifs à la bibliothèque doivent être signalés dans le projet PHPLIB dans JIRA de MongoDB. Les problèmes liés aux extensions doivent être signalés dans le projet PHPC.
Pour les questions générales et les demandes d'assistance, veuillez utiliser l'un des canaux d'assistance technique de MongoDB.
Si vous avez identifié une vulnérabilité de sécurité dans un pilote ou tout autre projet MongoDB, veuillez la signaler conformément aux instructions dans Créer un rapport de vulnérabilité.
Le développement est suivi dans le projet PHPLIB dans JIRA de MongoDB. La documentation pour contribuer à ce projet peut être trouvée dans CONTRIBUTING.md.