ibase_commit
ibase_db_info
Fonctions Firebird/InterBase
PHP Manual

# ibase_connect

(PHP 4, PHP 5)

ibase_connect — Ouvre 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 'hostname@' (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()
- ibase_close()

ibase_commit
ibase_db_info
Fonctions Firebird/InterBase
PHP Manual