ibase_backup

(PHP 5, PHP 7 < 7.4.0)

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

Description

function ibase_backup(
    resource $service_handle,
    string $source_db,
    string $dest_file,
    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 sauvegarde. 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_db: Le chemin absolu vers la base de données sur le serveur de base de données. Il est également possible d'utiliser un alias de base de données.
dest_file: Le chemin absolu vers le fichier de sauvegarde sur le serveur de base de données.
options: Options supplémentaires à transmettre au serveur de base de données pour la sauvegarde. Le paramètre options peut être une combinaison des constantes suivantes : IBASE_BKP_IGNORE_CHECKSUMS, IBASE_BKP_IGNORE_LIMBO, IBASE_BKP_METADATA_ONLY, IBASE_BKP_NO_GARBAGE_COLLECT, IBASE_BKP_OLD_DESCRIPTIONS, IBASE_BKP_NON_TRANSPORTABLE ou IBASE_BKP_CONVERT. Lire la section à propos des Constantes pré-définies pour plus d'information.
verbose: Étant donné que le processus de sauvegarde 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 sauvegarde é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_backup()

<?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 sauvegarde sur le serveur de base de données
// Sauvegarde la base de données employee en utilisant le chemin complet vers /srv/backup/employees.fbk
// N'utilise pas d'argument spéciaux
ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');

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

Exemple #2 Exemple de ibase_backup() 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 sauvegarde sur le serveur de base de données
// Sauvegarde la base de données employee en utilisant un alias vers /srv/backup/employees.fbk.
// Sauvegarde uniquement les métadonnées. Ne crée pas une sauvegarde transportable.
ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);

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

Voir aussi

ibase_restore() - Lance une tâche de restauration 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.