Installation

Le driver MongoDB devrait fonctionner sur la plupart des systèmes : Windows, Mac OS X, Unix, et Linux ; des petites machines au gros serveurs ; sur des systèmes 32 et 64 bit ; avec PHP 5.1, 5.2, 5.3, 5.4 et 5.5.

Cette extension » PECL n'est pas intégrée à PHP.

Installation manuelle

Pour les développeurs des pilotes ou les personnes intéréssées par les derniers correctifs de bugs, vous pouvez compiler le pilote depuis » Github. Allez sur Github et cliquez sur "download". Lancez ensuite :


$ tar zxvf mongodb-mongodb-php-driver-<commit_id>.tar.gz
$ cd mongodb-mongodb-php-driver-<commit_id>
$ phpize
$ ./configure
$ make all
$ sudo make install

Effectuez ces changements à votre fichier php.ini:

  • Assurez-vous que la variable extension_dir pointe vers le dossier contenant le fichier mongo.so. La compilation devrait afficher l'endroit où PHP installe le driver ; l'affichage devrait ressembler à quelque chose comme :

    
    Installing '/usr/lib/php/extensions/no-debug-non-zts-20060613/mongo.so'
    
    
    Vérifiez bien qu'il s'agisse du même dossier d'extensions que celui de votre PHP en lançant:
    
    $ php -i | grep extension_dir
      extension_dir => /usr/lib/php/extensions/no-debug-non-zts-20060613 =>
                       /usr/lib/php/extensions/no-debug-non-zts-20060613
    
    
    Si ce n'est pas le cas, changez extension_dir de php.ini ou placez manuellement mongo.so.

  • Pour chargez l'extension au démarrage de PHP, ajoutez cette ligne :

    
    extension=mongo.so
    
    

Installation sur les systèmes *NIX

Exécutez :


$ sudo pecl install mongo

Si vous utilisez CentOS ou Redhat, vous pouvez utiliser les » RPM.

Ajoutez la ligne suivante à votre fichier php.ini :


extension=mongo.so

Si PECL fait un dépassement de mémoire lors de l'installation, assurez-vous que la directive memory_limit du fichier php.ini est fixée à au moins 128MB.

Installation sous Windows

Les binaires précompilés pour chaque version sont disponibles sur » S3 pour une grande variété de combinaison de versions, de sécurité de threads, et de bibliothèques VC. Décompressez l'archive et placez php_mongo.dll dans votre dossier d'extension PHP ("ext" par défaut).

Ajoutez la ligne suivante à votre fichier php.ini :


extension=php_mongo.dll

Installation sur les systèmes OS X

Si votre système ne peut trouver autoconf, vous devrez installer Xcode (disponible sur le DVD d'installation de votre OS ou en libre téléchargement depuis le site web d'Apple).

Dans la plupart des cas, l'installation depuis pecl reste le plus simple :

$ sudo pecl install mongo

Si vous utilisez XAMPP, vous devriez être capable de compiler le driver avec la commande suivante :


sudo /Applications/XAMPP/xamppfiles/bin/pecl install mongo

Gentoo

Gentoo a un paquet pour le driver PHP nommé dev-php5/mongo, qui peut installer via la commande suivante :


$ sudo emerge -va dev-php5/mongo

Si vous utilisez PECL, vous recevrez une erreur signalant que libtool n'est pas à la bonne version. Lors de la compilation depuis les sources, vous devriez avoir besoin d'exécuter aclocal et autoconf.


$ phpize
$ aclocal 
$ autoconf 
$ ./configure
$ make
$ sudo make install

Red Hat

Ceci inclut Fedora et CentOS.

La configuration par défaut d'Apache sur ces systèmes ne permet pas aux requêtes d'effectuer des connexions réseaux, ceci signifie que le driver recevra une erreur "Permission denied" lorsqu'il tentera une connexion à la base de données. Si vous rencontrez une telle erreur, tentez d'exécuter ceci :

$ /usr/sbin/setsebool -P httpd_can_network_connect 1 
Puis, redémarrez Apache (Ce comportement peut également survenir sous SELinux).

Instructions d'installation tierces

Beaucoup de personnes ont créés d'excellents tutoriels sur l'installation du driver PHP.

LoadingChargement en cours