ibase_pconnect
(PHP 4, PHP 5)
ibase_pconnect — Abrir una conexión persistente con una base de datos InterBase
Descripción
Abre una conexión persistente con una base de datos InterBase.
ibase_pconnect() actúa de forma muy similar a ibase_connect() con dos diferencias significativas.
Primero, cuando se crea una conexión, la función intentará primero encontrar un enlace (persistente) ya abierto con los mismos parámetros. Si se encuentra uno, se devolverá un identificador para él, en lugar de abrir una nueva conexión.
Segundo, la conexión con el servidor InterBase no será cerrada cuando finalice la ejecución del script. En su lugar, el enlace permanecerá abierto para su uso futuro (ibase_close() no cerrará enlaces establecidos con ibase_pconnect()). Este tipo de enlace es por lo tanto llamado 'persistente'.
Lista de parámetros
- base_de_datos
-
El argumento base_de_datos debe ser una ruta válida al archivo de base de datos en el servidor en el que reside. Si el servidor no es local, debe ser precedido por 'nombre_host:' (TCP/IP), '//nombre_host/' (NetBEUI) o 'nombre_host@' (IPX/SPX), dependiendo del protocolo usado.
- nombre_usuario
-
El nombre de usuario. Puede ser definido mediante la directiva de php.ini ibase.default_user.
- contrasenya
-
La contraseña para nombre_usuario . Puede ser definida con la directiva de php.ini ibase.default_password.
- juego_caracteres
-
juego_caracteres es el juego de caracteres predeterminado para una base de datos.
- bufers
-
bufers es el número de búfers de base de datos a reservar para el caché en el lado del servidor. Si es 0 o se omite, el servidor elige su propio valor predeterminado.
- dialecto
-
dialecto selecciona el dialecto SQL predeterminado para cualquier sentencia ejecutada en la conexión, y su valor por omisión es el más alto soportado por las bibliotecas cliente. Este parámetro es funcional únicamente con InterBase 6 y versiones posteriores.
- rol
-
Funcional únicamente con InterBase 5 y versiones posteriores.
- sincronizar
-
Valores retornados
Devuelve un identificador de enlace InterBase en caso de éxito, o FALSE si ocurre un error.
Registro de cambios
| Versión | Descripción |
|---|---|
| 4.0.0 | Se agregaron los parámetros bufers , dialecto y rol |