PHP Conference Kansai 2025

ibase_connect

(PHP 5, PHP 7 < 7.4.0)

ibase_connectAbre una conexión a una base de datos

Descripción

ibase_connect(
    string $database = ?,
    string $username = ?,
    string $password = ?,
    string $charset = ?,
    int $buffers = ?,
    int $dialect = ?,
    string $role = ?,
    int $sync = ?
): resource

Abre una conexión a una base de datos Firebird/InterBase.

Si se realiza una segunda llamada con ibase_connect(), pasando los mismos argumentos, no se abrirá una nueva conexión, sino que se devolverá la conexión ya abierta. La conexión se cerrará cuando el script termine, a menos que se cierre explícitamente con ibase_close(), durante el script.

Parámetros

database

database debe ser una ruta válida hasta un fichero de base de datos en el servidor en el cual reside. Si el servidor es remoto, debe ser prefijado con un nombre de host 'hostname:' (TCP/IP), 'hostname/port:' (TCP/IP con un servidor interbase en un puerto TCP personalizado), '//hostname/' (NetBEUI) según el protocolo de comunicación utilizado.

username

El nombre de usuario. Puede ser definido con la directiva ibase.default_user del fichero php.ini.

password

La contraseña correspondiente al usuario username. Puede ser definida con la directiva ibase.default_password del fichero php.ini.

charset

charset es el juego de caracteres por defecto para la base de datos.

buffers

buffers es el número de buffers de base a asignar para la caché del servidor. Si se pasa a 0 o se omite, el servidor lo elegirá por sí mismo.

dialect

dialect selecciona el dialecto SQL para las consultas ejecutadas con esta conexión y, por defecto, utiliza el mejor dialecto disponible.

role

Funciona solo con InterBase 5 y superiores.

sync

Valores devueltos

Devuelve un identificador de conexión Firebird/InterBase en caso de éxito, o false si ocurre un error.

Errores/Excepciones

Si se encuentran errores como "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (esto ocurre cuando se intenta utilizar algunos caracteres acentuados) al utilizar ibase_connect() y después ibase_query(), se debe especificar un juego de caracteres correcto (i.e. ISO8859_1 o su juego de caracteres actual).

Ejemplos

Ejemplo #1 Ejemplo con ibase_connect()

<?php
$host
= 'localhost:/path/to/your.gdb';

$dbh = ibase_connect($host, $username, $password);
$stmt = 'SELECT * FROM tblname';
$sth = ibase_query($dbh, $stmt);
while (
$row = ibase_fetch_object($sth)) {
echo
$row->email, "\n";
}
ibase_free_result($sth);
ibase_close($dbh);
?>

Ver también

  • ibase_pconnect() - Abre una conexión persistente a una base de datos InterBase
  • ibase_close() - Cierra una conexión a una base de datos Interbase

add a note

User Contributed Notes

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