(PHP 5, PHP 7 < 7.4.0)
ibase_restore — Lance une tâche de restauration dans le gestionnaire de services et retourne immédiatement
$service_handle
,$source_file
,$dest_db
,$options
= 0,$verbose
= false
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.
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.
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
.
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);
?>