ibase_connect
(PHP 5, PHP 7 < 7.4.0)
ibase_connect — Öffnet eine Verbindung zu einer Datenbank
Beschreibung
ibase_connect
( string $database
= ?
, string $username
= ?
, string $password
= ?
, string $charset
= ?
, int $buffers
= ?
, int $dialect
= ?
, string $role
= ?
, int $sync
= ?
) : resource
Wenn ibase_connect() mit den selben Argumenten
erneut aufgerufen wird, wird keine neue Verbindung hergestellt,
sondern die ID der bereits geöffneten Verbindung zurück gegeben.
Die Verbindung zum InterBase-Server wird am Ende des jeweiligen
Skripts automatisch beendet, es sei denn, es wird vorher die
Funktion ibase_close() aufgerufen.
Parameter-Liste
-
database
-
Das database
-Argument muss ein gültiger Pfad zu
einer bestehenden Datenbank des Servers sein. Ist der DB-Server nicht
lokal, muss ihm - in Abhängigkeit vom benutzten Protokoll - ein
'hostname:' (bei TCP/IP), 'hostname/port:' (TCP/IP für Interbase Server auf
benutzerdefiniertem TCP Port), oder '//hostname/' (bei NetBEUI) vorangestellt
werden.
-
username
-
Der Benutzername. Kann mit der ibase.default_user
php.ini Direktive festgelegt werden.
-
password
-
Das Passwort für username
. Kann mit der
ibase.default_password
php.ini Direktive festegelegt
werden.
-
charset
-
charset
ist der reguläre Zeichensatz der
Datenbank.
-
buffers
-
Mit buffers
geben sie die Anzahl
der Datenbank-Cache-Buffer (serverseitig) an. Ist der Wert 0 oder
nicht angegeben, benutzt der Server seine Default-Werte.
-
dialect
-
Mittels
dialect
bestimmen sie den Default-Wert des
anzuwendenden SQL-Dialekts für alle Anweisungen während einer
Datenbank-Verbindung (default ist der Client-seitig höchst
verfügbare Dialekt).
-
role
-
Wirkt nur unter InterBase 5 und höher.
-
sync
-
Rückgabewerte
Gibt bei Erfolg eine Firebird/Interbase Verbindungs-ID zurück, oder false
im Fehlerfall.
Fehler/Exceptions
Erhalten Sie Fehlermeldungen wie "arithmetic exception, numeric overflow, or
string truncation. Cannot transliterate character between character sets"
(diese treten auf, wenn Sie Zeichen mit Akzent verwenden), wenn Sie diese
Funktion und ibase_query() verwenden, müssen Sie den
Zeichensatz (d.h. ISO8859_1 oder Ihren aktuellen Zeichensatz) einstellen.
Beispiele
Beispiel #1 ibase_connect()-Beispiel:
<?php
$host = 'localhost:/pfad/zu/ihrer.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);
?>
Siehe auch
- ibase_pconnect() - Öffnet eine persistente Verbindung zu einer InterBase-Datenbank
- ibase_close() - Schließt eine Verbindung zu einer InterBase-Datenbank