LonghornPHP 2026

    ibase_restore

    (PHP 5, PHP 7 < 7.4.0)

    ibase_restore — Lance une tâche de restauration dans le gestionnaire de services et retourne immédiatement

    Description

    function ibase_restore(
        resource $service_handle,
        string $source_file,
        string $dest_db,
        int $options = 0,
        bool $verbose = false
    ): mixed

    Cette fonction transmet les arguments au serveur de base de données (distant). Là, il commence un nouveau processus de restauration. Par conséquent, le résultat ne sera aucune réponse.

    Liste de paramètres

    service_handle

    Une connexion au serveur de base de données créée précédemment.

    source_file

    Le chemin absolu sur le serveur où le fichier de sauvegarde est situé.

    dest_db

    Le chemin pour créer la nouvelle base de données sur le serveur. Il est également possible d'utiliser un alias de base de données.

    options

    Options supplémentaires à transmettre au serveur de base de données pour la restauration. Le paramètre options peut être une combinaison des constantes suivantes : IBASE_RES_DEACTIVATE_IDX, IBASE_RES_NO_SHADOW, IBASE_RES_NO_VALIDITY, IBASE_RES_ONE_AT_A_TIME, IBASE_RES_REPLACE, IBASE_RES_CREATE, IBASE_RES_USE_ALL_SPACE, IBASE_PRP_PAGE_BUFFERS, IBASE_PRP_SWEEP_INTERVAL, IBASE_RES_CREATE. Lire la section à propos des Constantes pré-définies pour plus d'information.

    verbose

    Étant donné que le processus de restauration est effectué sur le serveur de base de données, l’on n’a aucune chance d’obtenir sa sortie. Cet argument est inutile.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Le processus de restauration étant effectué sur le serveur (distant), cette fonction ne fait que lui transmettre les arguments. Tant que les arguments sont légaux, le résultat ne sera pas false.

    Exemples

    Exemple #1 Exemple avec ibase_restore()

    <?php
// S'attacher au serveur par adresse ip et port.
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');

// Débuter le processus de restauration sur le serveur de base de données
// Restaurer la sauvegarde de employee vers la nouvelle base de données emps.fdb
// N'utilise pas d'argument spéciaux
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');

// Libère la connexion attachée
ibase_service_detach ($service);
?>

    Exemple #2 Exemple de ibase_restore() avec des arguments

    <?php

// S'attacher au serveur par nom et port par défaut
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');

// Débuter le processus de restauration sur le serveur de base de données
// Restaure la base de données employee en utilisant un alias.
// Restaure sans index, Remplace la base de données existante.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);

// Libère la connexion attachée
ibase_service_detach ($service);
?>

    Voir aussi

    • ibase_backup() - Lance une tâche de sauvegarde dans le gestionnaire de services et retourne immédiatement

    Found A Problem?

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

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top