ibase_service_attach

(PHP 5, PHP 7 < 7.4.0)

ibase_service_attach — Verbindet mit dem Service-Manager

Beschreibung

ibase_service_attach(string $host, string $dba_username, string $dba_password): resource|false

Parameter-Liste

host: Der Name oder die IP-Adresse des Datenbank-Hosts. Sie können den Port angeben durch Hinzufügen von '/' und der Portnummer. Sofern kein Port angegeben wurde, wird Port 3050 verwendet.
dba_username: Der Name eines gültigen Benutzers.
dba_password: Das Kennwort des Benutzers.

Rückgabewerte

Gibt im Erfolgsfall eine Interbase/Firebird-Verbindungskennung zurück. Bei einem Fehler wird false zurückgegeben.

Beispiele

Beispiel #1 ibase_service_attach()-Beispiel


<?php
    // Stellt über die IP-Adresse eine Verbindung zum Remote-Firebird-Server her
    if (($service = ibase_service_attach('10.1.1.199', 'sysdba', 'masterkey')) != FALSE) {

        // Verbindung erfolgreich
        // Server-Version ermitteln (z. B. 'LI-V3.0.4.33054 Firebird 3.0')
        $server_version  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);

        // Serverimplementierung abrufen (z. B. 'Firebird/Linux/AMD/Intel/x64')
        $server_implementation = ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);

        // Vom Server trennen (Verbindung trennen)
        ibase_service_detach($service);

        // Ausgabe
        echo "Server-Version: " . $server_version . "<br/>";
        echo "Server-Implementierung: " . $server_implementation;
    }
    else {
        // Fehler ausgeben
        $conn_error = ibase_errmsg();
        die($conn_error);
    }

?>

Beispiel #2 ibase_service_attach()-Beispiel mit hostname/port-Syntax


<?php
    // Verbindung zum Remote-Firebird-Server über den Namen herstellen. Port 3050 verwenden.
    if (($service = ibase_service_attach('FB-SRV-01.contoso.local/3050', 'sysdba', 'masterkey')) != FALSE) {

        // Verbindung erfolgreich
        // Server-Version ermitteln (z. B. 'LI-V3.0.4.33054 Firebird 3.0')
        $server_version  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);

        // Serverimplementierung abrufen (z. B. 'Firebird/Linux/AMD/Intel/x64')
        $server_implementation = ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);

        // Vom Server trennen (Verbindung trennen)
        ibase_service_detach($service);

        // Ausgabe
        echo "Server-Version: " . $server_version . "<br/>";
        echo "Server-Implementierung: " . $server_implementation;
    }
    else {
        // Fehler ausgeben
        $conn_error = ibase_errmsg();
        die($conn_error);
    }

?>