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

# 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open