ibase_connect
(PHP 5, PHP 7 < 7.4.0)
ibase_connect — Ouvre une connexion à une base de données
Description
ibase_connect(
string $database
= ?,
string $username
= ?,
string $password
= ?,
string $charset
= ?,
int $buffers
= ?,
int $dialect
= ?,
string $role
= ?,
int $sync
= ?
): resource
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 personalisé), '//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 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.
-
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 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).
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