dba_popen

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_popen — Ouvre une connexion persistante à une base de données DBA

Description

dba_popen(
    string $path,
    string $mode,
    string $handler = ?,
    mixed ...$args
): resource|false

dba_popen() établit une connexion persistante à la base repérée par path avec le mode mode, en utilisant l'identifiant handler.

Liste de paramètres

path

Chemin sur votre système de fichiers.

mode

Il vaut r pour lecture seule, w pour lecture/écriture, c pour lecture/écriture, et création si la base n'existe pas, et n pour création, écrasement, et accès en lecture/écriture.

handler

Le nom du gestionnaire qui doit être utilisé pour accéder à path. Le gestionnaire reçoit tous les paramètres supplémentaires passés à la fonction dba_popen().

args

Paramètre chaîne de caractères optionnels qui sont transmis au pilote.

Les pilotes cdb, cdb_make, flatfile, inifile, qdbm et tcadb ne supportent pas de paramètres additionels.

Les pilotes db1, db2, db3, db4, dbm, gdbm, et ndbm supportent un paramètre additionel $filemode, qui a la même signification que le paramètre $mode de chmod(), et à comme valeur par défaut 0644.

Le pilote lmdb supporte deux paramètres additionels. Le premier permet de définir le $filemode (voir description ci-dessus), et le second permet de définir la $mapsize, dont la valeur devrait être un multiple de la taille de page du système d'exploitation, ou zéro pour utiliser la mapsize par défaut. La paramètre $mapsize est supporté à partir de PHP 7.3.14 et 7.4.2, respectivement.

Valeurs de retour

Retourne un gestionnaire positif en cas de succès ou false si une erreur survient.

Voir aussi