Installation

En utilisant l'option de compilation --enable-dba=shared, il est possible de compiler un module dynamique qui activera le support des bases de données de style DBM pour PHP. Il faut aussi ajouter le support d'au moins l'un des gestionnaires suivants, en spécifiant l'option de configuration --with-XXXX ou --enable-XXXX lors de la configuration de PHP.

Avertissement

Après avoir configuré et compilé PHP, il faut exécuter les tests suivants à partir de la ligne de commande : php run-tests.php ext/dba. Cela montre si la combinaison de pilotes fonctionne. Les plus problématiques sont dbm et ndbm qui entrent en conflit avec nombre d'installations. Ceci est dû au fait que sur de nombreux systèmes, ces bibliothèques font partie de plus d'une bibliothèque. Le test de configuration empêche juste de configurer des descripteurs dont la combinaison est défectueuse alors qu'ils fonctionnent correctement séparément.

**Gestionnaires DBA supportés**
Gestionnaire	Option de configuration
`dbm`	Pour activer le support de dbm, ajoutez l'option de compilation --with-dbm[=DIR]. Note: dbm est une surcouche qui aboutit souvent à des échecs. Ainsi, l'on ne doit utiliser dbm que si l'on est sûr qu'il fonctionne et que ce format est nécessaire.
`ndbm`	Pour activer le support de ndbm, ajoutez l'option de compilation --with-ndbm[=DIR]. Note: ndbm est une surcouche qui aboutit souvent à des échecs. Ainsi, l'on ne doit utiliser ndbm que si l'on est sûr qu'il fonctionne et que ce format est nécessaire.
`gdbm`	Pour activer le support de gdbm, ajoutez l'option de compilation --with-gdbm[=DIR].
`db2`	Pour activer le support d'Oracle Berkeley DB 2, ajoutez l'option de compilation --with-db2[=DIR]. Note: db2 entre en conflit avec db3 et db4.
`db3`	Pour activer le support d'Oracle Berkeley DB 3, ajoutez l'option de compilation --with-db3[=DIR]. Note: db3 entre en conflit avec db2 et db4.
`db4`	Pour activer le support d'Oracle Berkeley DB 4 ou 5, ajoutez l'option de compilation --with-db4[=DIR]. Note: db4 entre en conflit avec db2 et db3. Note: Les bibliothèques db avec des versions allant de 4.1 à 4.1.24 ne peuvent être utilisées avec aucune version de PHP. Le support de BDB 5 a été ajouté en PHP 5.3.3.
`cdb`	Pour activer le support de cdb, ajoutez l'option de compilation --with-cdb[=DIR]. Note: Il est possible d'omettre d'utiliser DIR, afin d'exploiter la bibliothèque cdb fournie avec PHP, qui ajoute un gestionnaire cdb_make, permet la création de fichiers cdb et permet l'accès aux fichiers cdb via le réseau avec les flux de PHP.
`flatfile`	Pour activer le support des fichiers, ajoutez l'option de compilation --enable-flatfile. Antérieurement à PHP 5.2.1, l'option --with-flatfile devait être utilisée à la place. Note: Ceci a été ajouté pour assurer la compatibilité avec l'extension `dbm` qui est obsolète. Utiliser ce gestionnaire seulement quand l'on ne peut installer aucun autre gestionnaire et qu'il n'est pas possible d'utiliser le gestionnaire cdb intégré.
`inifile`	Pour activer le support de `inifile`, ajoutez l'option de compilation --enable-inifile. Antérieurement à PHP 5.2.1, l'option --with-inifile devait être utilisée à la place. Note: Cette option a été ajoutée pour permettre de lire et écrire dans des fichiers d'initialisation de type Microsoft (`.ini`), comme le `php.ini` par exemple.
`qdbm`	Pour activer le support de qdbm, ajoutez l'option de compilation --with-qdbm[=DIR]. Note: qdbm entre en conflit avec dbm et gdbm. Note: La bibliothèque qdbm peut être téléchargée depuis » http://fallabs.com/qdbm/index.html.
`tcadb`	Pour activer le support de Tokyo Cabinet, ajoutez l'option de compilation --with-tcadb[=DIR]. Note: La bibliothèque Tokyo Cabinet peut être téléchargée depuis » http://fallabs.com/tokyocabinet/.
`lmdb`	Pour activer le support de Lightning Memory-Mapped Database, ajouter l'option de configuration --with-lmdb[=DIR]. Note: Ceci a été ajouté en PHP 7.2.0. La bibliothèque Lightning Memory-Mapped Database peut être téléchargée depuis » https://symas.com/lmdb/.