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);
    }

?>

Siehe auch

ibase_service_detach() - Trennt die Verbindung zum Service-Manager

Improve This Page

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

＋add a note

User Contributed Notes 3 notes

down

Paul Vinkenoog ¶

16 years ago

The previous comment is incorrect. You can connect to the Service Manager as any valid user, and connecting to the Service Manager is not the same as connecting to the security database. However, some of the service functions (which you may subsequently call with the service handle returned by ibase_service_attach) are only available to SYSDBA.

down

houston_roadrunner at yahoo dot com ¶

18 years ago

When using this function it looks like you can only use SYSDBA as the user, as you are connecting to the security database. This is a restriction by the interbase/firebird server.

down

Anonymous ¶

18 years ago

An example of ibase_service_attach:
<?php
    //attach to the server running on localhost
    if (($service = ibase_service_attach('localhost', 'sysdba', 'masterkey')) != FALSE) {
        //retrieve server info
        $server_info  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION) 
                      . ' / '
                      . ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);
        //detach from server (disconnect)
        ibase_service_detach($service);
    }
    else {
        $ib_error = ibase_errmsg();
    }
echo $server_info;
?>
Should echo something like:

 WI-T2.0.0.12484 Firebird 2.0 Release Candidate 1 / Firebird/x86/Windows NT

Taken/adapted from ibWebAdmin source code

＋add a note