PHP 8.3.4 Released!

ibase_backup

(PHP 5, PHP 7 < 7.4.0)

ibase_backupLance une tâche de sauvegarde dans le gestionnaire de services et retourne immédiatement

Description

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ée (distant). Là, il commence un nouveau processus de sauvegarde. 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_db

Le chemin absolue vers la base de donnée sur le serveur de base de donnée. Vous pouvez également utiliser un alias de base de données.

dest_file

Le chemin absolue vers le fichier de sauvegarde sur le serveur de base de donnée.

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 or 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, 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 sauvegarde é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_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ée
// Sauvegarde la base de donnée 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é
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ée
// Sauvegarde la base de donnée 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é
ibase_service_detach ($service);
?>

Voir aussi

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

add a note

User Contributed Notes 1 note

up
-9
Gara
18 years ago
I tried to get the backup function working, but could never figur out where to get the resource service_handle. The trick was to use ibase_service_attach.

$resource_service_handle = ibase_service_attach ('localhost', 'username', 'password');

ibase_backup($resource_service_handle, 'source_database', 'destination_file');

ibase_service_detach ($resource_service_handle);
To Top