ibase_service_attach

(PHP 5, PHP 7 < 7.4.0)

ibase_service_attach — Connexion au gestionnaire de service

Description

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

Liste de paramètres

host
Le nom ou l'adresse IP de l'hôte de la base de données. Il est possible de définir le port en ajoutant '/' et le numéro du port. Si aucun port est spécifié, le port 3050 sera utilisé.
dba_username
Le nom de tout utilisateur valide.
dba_password
Le mot de passe de l'utilisateur.

Valeurs de retour

Retourne un identifiant de lien Interbase / Firebird en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec ibase_service_attach()

<?php
    // S'attacher au serveur Firebird distant par une adresse ip
    if (($service = ibase_service_attach('10.1.1.199', 'sysdba', 'masterkey')) != FALSE) {

        // Attaché avec succès.
        // Récupérer la version du serveur (qqch comme 'LI-V3.0.4.33054 Firebird 3.0')
        $server_version  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);

        // Récupérer l'implémentation serveur (qqch comme 'Firebird/Linux/AMD/Intel/x64')
        $server_implementation = ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);

        // Se détacher du serveur (déconnexion)
        ibase_service_detach($service);

        // Afficher les informations
        echo "Server version: " . $server_version . "<br/>";
        echo "Server implementation: " . $server_implementation;
    }
    else {
        // Afficher un message en cas d'erreur
        $conn_error = ibase_errmsg();
        die($conn_error);
    }

?>

Exemple #2 Exemple deibase_service_attach() en utilisant la syntaxe hostname/port

<?php
    // S'attacher au serveur Firebird distant par nom. Utilise le Port 3050.
    if (($service = ibase_service_attach('FB-SRV-01.contoso.local/3050', 'sysdba', 'masterkey')) != FALSE) {

        // Attaché avec succès.
        // Récupérer la version du serveur (qqch comme 'LI-V3.0.4.33054 Firebird 3.0')
        $server_version  = ibase_server_info($service, IBASE_SVC_SERVER_VERSION);

        // Récupérer l'implémentation serveur (qqch comme 'Firebird/Linux/AMD/Intel/x64')
        $server_implementation = ibase_server_info($service, IBASE_SVC_IMPLEMENTATION);

        // Se détacher du serveur (déconnexion)
        ibase_service_detach($service);

        // Afficher les informations
        echo "Server version: " . $server_version . "<br/>";
        echo "Server implementation: " . $server_implementation;
    }
    else {
        // Afficher un message en cas d'erreur
        $conn_error = ibase_errmsg();
        die($conn_error);
    }

?>

Voir aussi