dba_popen

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

dba_popenEstablece una conexión persistente a una base de datos DBA

Descripción

dba_popen(
    string $path,
    string $mode,
    ?string $handler = null,
    int $permission = 0644,
    int $map_size = 0,
    ?int $flags = null
): Dba\Connection|false

dba_popen() establece una conexión persistente a la base identificada por path con el modo mode, utilizando el identificador handler.

Parámetros

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.

Valores devueltos

Devuelve una instancia de Dba\Connection en caso de éxito o false en caso de error.

Errores/Excepciones

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.

Historial de cambios

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.

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top