Verbindet mit dem Service-Manager

# ibase_service_attach

(PHP 5, PHP 7 < 7.4.0)

ibase_service_attach — Verbindet mit dem Service-Manager

### Beschreibung

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open