# 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

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