PHP 8.3.4 Released!

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ée (distant). Là, il commence un nouveau processus de restauration. Par conséquent, vous n'obtiendrez aucune réponse.

Liste de paramètres

service_handle

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

source_file

Le chemin absolue 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. Vous pouvez également 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, vous n’avez 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, vous n'obtiendrez 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ée
// Restaurer la sauvegarde de employee vers la nouvelle base de donnée 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é
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ée
// Restaure la base de donnée employee en utilisant un alias.
// Restaure sans index, Remplace la base de donnée existante.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);

// Libère la connexion attaché
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