ibase_restore

(PHP 5, PHP 7 < 7.4.0)

ibase_restoreLance une tâche de restauration dans le gestionnaire de services et retourne immédiatement

Description

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
add a note

User Contributed Notes

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