(PHP 5, PHP 7)
ibase_pconnect — Öffnet eine persistente Verbindung zu einer InterBase-Datenbank
$database
[, string $username
[, string $password
[, string $charset
[, int $buffers
[, int $dialect
[, string $role
[, int $sync
]]]]]]]] )Öffnet eine persistente Verbindung zu einer InterBase-Datenbank.
ibase_pconnect() agiert ähnlich der Funktion ibase_connect(), mit zwei Ausnahmen.
Erstens wird beim Verbindungs-Aufbau versucht, eine bereits bestehende (persistente) Verbindung zu finden, die mit den selben Parametern aufgebaut worden ist. Wird eine solche gefunden, wird statt eines neuen Verbindungs-Aufbaus die ID der bestehenden Verbindung zurückgegeben.
Zweitens wird beim Beenden des Skripts die Verbindung zum InterBase Server nicht beendet. Statt dessen wird die Verbindung für den weiteren Gebrauch beibehalten (ibase_close() beendet keine Verbindungen, die mittels ibase_pconnect() erzeugt wurden). Diese Art der Verbindung wird deshalb auch 'persistent' genannt.
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/' (bei NetBEUI)
oder 'hostname@' (IPX/SPX) vorangestellt werden.
usernameDer 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). Dies wirkt nur mit InterBase 6 und höher.
roleWirkt nur unter InterBase 5 und höher.
sync
Gibt bei Erfolg eine Firebird/Interbase Verbindungs-ID zurück, oder FALSE
im Fehlerfall.