Description

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

Ouvre une connexion à une base de données Firebird/InterBase.

Si un deuxième appel est fait avec ibase_connect(), en passant les mêmes arguments, une nouvelle connexion ne sera pas ouverte, mais la connexion déjà ouverte sera retournée. La connexion sera fermée dès que le script se termine, à moins qu'elle ne soit fermée explicitement avec ibase_close(), durant le script.

Liste de paramètres

database: database doit être un chemin valide jusqu'à un fichier de base de données sur le serveur sur lequel il réside. Si le serveur est distant, il faut le préfixer avec un nom d'hôte 'hostname:' (TCP/IP), 'hostname/port:' (TCP/IP avec un serveur interbase sur un port TCP personnalisé), '//hostname/' (NetBEUI) en fonction du protocole de communication utilisé.
username: Le nom d'utilisateur. Peut être défini avec la directive ibase.default_user du fichier php.ini.
password: Le mot de passe correspondant à l'utilisateur username. Peut être défini avec la directive ibase.default_password du fichier php.ini.
charset: charset est le jeu de caractères par défaut pour la base de données.
buffers: buffers est le nombre de buffers de base de données à allouer pour le cache serveur. S'il est passé à 0 ou omis, le serveur le choisira de lui-même.
dialect: dialect sélectionne le dialecte SQL pour les requêtes exécutées avec cette connexion et, par défaut, il utilise le meilleur dialecte disponible.
role: Ne fonctionne qu'avec InterBase 5 et supérieur.
sync

Valeurs de retour

Retourne un identifiant de connexion Firebird/InterBase en cas de succès, ou false si une erreur survient.

Erreurs / Exceptions

Si l'on a quelques erreurs comme "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (cela se produit lors de la tentative d'utiliser des caractères accentués) lorsque l'on utilise ibase_connect() et après ibase_query(), il faut spécifier un jeu de caractères correct (c.-à-d. ISO8859_1 ou le jeu de caractères courant).

Exemples

Exemple #1 Exemple avec 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);
?>

Voir aussi

ibase_pconnect() - Ouvre une connexion persistante à une base de données InterBase
ibase_close() - Ferme une connexion à une base de données Interbase