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

    Stellt eine Verbindung zu einem Firebird/InterBase-Server her.

    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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top