(PHP 4, PHP 5, PHP 7, PHP 8)
dba_popen — Establece una conexión persistente a una base de datos DBA
$path,$mode,$handler = null ,$permission = 0644,$map_size = 0,$flags = null
dba_popen() establece una conexión persistente
a la base identificada por path
con el modo mode, utilizando el identificador
handler.
pathRuta en el sistema de ficheros.
mode
Puede ser r para solo lectura, w para
lectura/escritura, c para lectura/escritura y creación si la base no existe,
y n para creación, sobrescritura y acceso en lectura/escritura.
handler
El nombre del
gestor que debe ser
utilizado para acceder a path. El gestor recibe todos los argumentos adicionales
pasados a la función dba_popen(). Si el argumento handler es null ,
entonces se invoca el gestor por defecto.
permission
Argumento opcional de tipo entero (int ) que se pasa al controlador. Tiene el mismo significado
que el argumento permissions de la función chmod() ,
y su valor por omisión es 0644.
Los controladores db1, db2,
db3, db4, dbm,
gdbm,
ndbm y lmdb admiten el argumento
permission.
map_sizeArgumento opcional de tipo int que se pasa al controlador. Su valor debe ser un múltiplo de la tamaño de página del sistema operativo, o cero para utilizar el tamaño de mapa por omisión.
El controlador lmdb acepta el argumento map_size.
flags
Permite pasar banderas a los controladores de base de datos. Actualmente, solo el controlador LMDB con
las banderas DBA_LMDB_USE_SUB_DIR y DBA_LMDB_NO_SUB_DIR es soportado.
Devuelve una instancia de Dba\Connection en caso de éxito o false si ocurre un error.
El valor false es devuelto y un error de nivel E_WARNING es emitido cuando
el argumento handler es null , pero no hay ningún gestor por defecto disponible.
| Versión | Descripción |
|---|---|
| 8.4.0 | Ahora devuelve una instancia de Dba\Connection ; anteriormente se devolvía un resource . |
| 8.2.0 |
Se añadió el argumento flags.
|
| 8.2.0 |
El argumento handler ahora es nullable.
|
| 7.3.14, 7.4.2 |
El controlador lmdb ahora soporta un argumento
adicional map_size.
|