ibase_service_attach

Connect to the service manager

&reftitle.description; ``resource``false```ibase_service_attach` `string` `host` `string` `dba_username` `string` `dba_password`
&reftitle.parameters;

`host`

- The name or ip address of the database host. You can define the port by adding '/' and port number. If no port is specified, port 3050 will be used.

`dba_username`

- The name of any valid user.

`dba_password`

- The user's password.

&reftitle.returnvalues;

Returns a Interbase / Firebird link identifier on success&return.falseforfailure;.

&reftitle.examples;

### `ibase_service_attach` example

    <?php
        // Attach to the remote Firebird server by ip address
        if (($service = ibase_service_attach('10.1.1.199', 'sysdba', 'masterkey')) != FALSE) {

            // Successfully attached.
            // Fetch server version (something like 'LI-V3.0.4.33054 Firebird 3.0')
            $server_version  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);

            // Fetch server implementation (something like 'Firebird/Linux/AMD/Intel/x64')
            $server_implementation = ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);

            // Detach from server (disconnect)
            ibase_service_detach($service);

            // Output the info
            echo "Server version: " . $server_version . "<br/>";
            echo "Server implementation: " . $server_implementation;
        }
        else {
            // Output message on error
            $conn_error = ibase_errmsg();
            die($conn_error);
        }

    ?>

### `ibase_service_attach` example using `hostname/port` syntax

    <?php
        // Attach to the remote Firebird server by name. Use Port 3050.
        if (($service = ibase_service_attach('FB-SRV-01.contoso.local/3050', 'sysdba', 'masterkey')) != FALSE) {

            // Successfully attached.
            // Fetch server version (something like 'LI-V3.0.4.33054 Firebird 3.0')
            $server_version  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);

            // Fetch server implementation (something like 'Firebird/Linux/AMD/Intel/x64')
            $server_implementation = ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);

            // Detach from server (disconnect)
            ibase_service_detach($service);

            // Output the info
            echo "Server version: " . $server_version . "<br/>";
            echo "Server implementation: " . $server_implementation;
        }
        else {
            // Output message on error
            $conn_error = ibase_errmsg();
            die($conn_error);
        }

    ?>

&reftitle.seealso;

- `ibase_service_detach`