(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
.
path
Ruta 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_size
Argumento 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
en caso de 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 recurso. |
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 .
|