ibase_commit
ibase_db_info
Firebird/InterBase Functions
PHP Manual

# ibase_connect

(PHP 4, PHP 5)

ibase_connect — Abrir una conexión con una base de datos InterBase

### Descripción

resource ibase_connect ([ string `$base_de_datos` [, string `$nombre_usuario` [, string `$contrasenya` [, string `$juego_caracteres` [, int `$bufers` [, int `$dialecto` [, string `$rol` [, int `$sincronizar` ]]]]]]]] )

Establece una conexión con un servidor InterBase.

En case de que se haga una segunda llamada a ibase_connect() con los mismos argumentos, no se establecerá un nuevo enlace, en cambio, el identificador de enlace previamente abierto será devuelto. El enlace al servidor será cerrado apenas finalice la ejecución del script, a menos que sea cerrado prematuramente llamando explícitamente ibase_close().

### 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.

### Errors/Exceptions

Si obtiene un error del tipo "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (esto ocurre cuando intenta usar algún caracter con acentos) cuando usa esta extensión después de llamar ibase_query(), debe definir el juego de caracteres (puede ser ISO8859_1 o su juego de caracteres actual).

### Registro de cambios

Versión | Descripción
--- | ---
4.0.0 | Fueron agregados los parámetros `bufers` , `dialecto` y `rol`

### Ejemplos

Example #1 Ejemplo de ibase_connect()

`<?php
$host = 'localhost:/ruta/a/su/base_de_datos.gdb';
$gestor_db = ibase_connect($host, $nombre_usuario, $contrasenya);
$sentencia = 'SELECT * FROM nombre_tabla';
$gestor_sent = ibase_query($gestor_db, $sentencia);
while ($fila = ibase_fetch_object($gestor_sent)) {
echo $fila->email, "\n";
}
ibase_free_result($gestor_sent);
ibase_close($gestor_db);
?>`

### Ver también

- ibase_pconnect() - Abrir una conexión persistente con una base de datos InterBase
- ibase_close() - Cerrar una conexión con una base de datos InterBase

ibase_commit
ibase_db_info
Firebird/InterBase Functions
PHP Manual