ibase_connect

(PHP 4, PHP 5)

ibase_connectOuvre une connexion � une base de donn�es InterBase

Description

resource ibase_connect ([ string $database [, string $username [, string $password [, string $charset [, int $buffers [, int $dialect [, string $role [, int $sync ]]]]]]]] )

Ouvre une connexion � une base de donn�es 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/' (NetBEUI) ou '[email protected]' (IPX/SPX), 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 buffer de base � 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. Ceci ne fonctionne qu'avec InterBase 6 et sup�rieur.

role

Ne fonctionne qu'avec InterBase 5 et sup�rieur.

sync

Valeurs de retour

Retourne un identifiant de connexion InterBase en cas de succ�s, ou FALSE si une erreur survient.

Erreurs / Exceptions

Si vous avez quelques erreurs comme "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (cela se produit lorsque vous tentez d'utiliser quelques caract�res accentu�s) lorsque vous utilisez ibase_connect() et apr�s ibase_query(), vous devez sp�cifier un jeu de caract�res correct (i.e. ISO8859_1 ou votre jeu de caract�res courant).

Historique

Version Description
4.0.0 Les param�tres buffers , dialect et role ont �t� ajout�s

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