(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 (entero) 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 entero 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.
|