Cette extension est développée au-dessus des bibliothèques libmongoc et libbson. Il fournit une API minimale pour les fonctionnalités de base du pilote : commandes, requêtes, écritures, gestion des connexions et sérialisation BSON.
Les bibliothèques PHP Userland qui dépendent de cette extension peuvent fournir des API de niveau supérieur, telles que des générateurs de requêtes, des méthodes d'aide aux commandes individuelles et GridFS. Les développeurs d'applications devraient envisager d'utiliser cette extension en conjonction avec la bibliothèque PHP MongoDB, qui implémente les mêmes API de niveau supérieur que celles trouvées dans les pilotes MongoDB pour d'autres langages.
https://www.php.net/mongodb
https://www.mongodb.com/docs/drivers/php-drivers/
Pour créer et installer le pilote :
$ pecl install mongodb $ echo "extension=mongodb.so" >> `php --ini | grep "Loaded Configuration" | sed -e "s|.*:s*||"`
Des instructions d'installation supplémentaires peuvent être trouvées dans la documentation PHP.net.
Cette extension est destinée à être utilisée avec la bibliothèque PHP MongoDB, qui est distribuée sous le nom de package mongodb/mongodb
pour Composer.
Les releases sont créées automatiquement et signées à l'aide de la clé GPG de l'équipe PHP. Cela s'applique à la balise git ainsi qu'à tous les packages de version fournis dans le cadre d'une version GitHub. Pour vérifier les packages fournis, téléchargez la clé et importez-la à l'aide de gpg
:
gpg --import php-driver.asc
Les packages PECL sont disponibles sous forme d'artefacts de version sur GitHub, ainsi que sur la page d'accueil de PECL. La version GitHub contiendra également un fichier de signature détaché pour le package PECL (nommé mongodb-XYZtgz.sig
).
Pour vérifier l'intégrité du package téléchargé, exécutez la commande suivante :
gpg --vérifier mongodb-XYZtgz.sig mongodb-XYZtgz
Note
Aucune vérification n'est effectuée lors de l'utilisation pecl
pour installer le package. Pour garantir l'intégrité de la version lors de l'utilisation pecl
, téléchargez l'archive tar manuellement à partir de la version GitHub, vérifiez la signature, puis installez le package à partir de l'archive tar téléchargée à l'aide de pecl install mongodb-XYZtgz
.
Les binaires Windows distribués via les versions de GitHub contiennent une signature détachée pour le fichier php_mongodb.dll
nommé php_mongodb.dll.sig
. Pour vérifier l'intégrité de la DLL, exécutez la commande suivante :
gpg --vérifier php_mongodb.dll.sig php_mongodb.dll.tgz
Note
Les binaires Windows distribués directement via PECL ne sont pas signés par MongoDB et ne peuvent pas être vérifiés. Si vous devez vérifier l'intégrité du binaire téléchargé, téléchargez-le toujours à partir de la version GitHub.
Les problèmes liés à l'extension doivent être signalés dans le projet PHPC dans JIRA de MongoDB. Les problèmes liés à la bibliothèque doivent être signalés dans le projet PHPLIB.
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 PHPC dans JIRA de MongoDB. La documentation pour contribuer à ce projet peut être trouvée dans CONTRIBUTING.md.