# ibase_backup

(PHP 5, PHP 7 < 7.4.0)

ibase_backup — Initiiert eine Sicherungsaufgabe im Service Manager und springt sofort zurück

### Beschreibung

ibase_backup(
resource `$service_handle`,
string `$source_db`,
string `$dest_file`,
int `$options` = 0,
bool `$verbose` = `false`
): mixed

Diese Funktion übergibt die Argumente an den (entfernten) Datenbankserver. Dort startet sie einen neuen Sicherungsvorgang. Deshalb erhalten Sie keine Antwort.

### Parameter-Liste

`service_handle`
  Eine zuvor geöffnete Verbindung zum Datenbankserver.
`source_db`
  Der absolute Dateipfad zur Datenbank auf dem Datenbankserver. Sie können auch einen Datenbankalias verwenden.
`dest_file`
  Der Pfad zur Sicherungsdatei auf dem Datenbankserver.
`options`

  Zusätzliche Optionen, die zur Sicherung an den Datenbankserver übergeben werden. Der Parameter `options` darf eine Kombination folgender Konstanten sein: `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`. Vgl. auch den Abschnitt Vordefinierte Konstanten.

`verbose`
  Da der Sicherungsvorgang auf dem Datenbankserver ausgeführt wird, haben Sie keine Chance, die Ausgabe abzurufen. Dieses Argument ist sinnlos.

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

Da der Sicherungsvorgang auf dem (Remote-) Server durchgeführt wird, übergibt diese Funktion nur die Argumente an diesen. Solange die Argumente gültig sind, werden Sie niemals `false` zurückbekommen.

### Beispiele

Beispiel #1 ibase_backup()-Beispiel

`<?php
// Mit Datenbankserver mittels IP-Adresse und Port verbinden
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');
// Sicherungsvorgang auf DB-Server starten
// Sichern der Mitarbeiterdatenbank unter Verwendung des vollständigen Pfads nach /srv/backup/employees.fbk
// Keine speziellen Paramter verwenden
ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');
// Verbindung wieder freigeben
ibase_service_detach ($service);
?>`

Beispiel #2 ibase_backup()-Beispiel mit Argumenten

`<?php
// Stelle eine Verbindung zum Datenbankserver mit Namen und Standardport her
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');
// Sicherungsvorgang auf Datenbankserver starten
// Sichern der Mitarbeiterdatenbank mittels Alias nach /srv/backup/employees.fbk.
// Nur die Metadaten sichern. Kein transportables Backup erstellen.
ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);
// Verbindung wieder freigeben
ibase_service_detach ($service);
?>`

### Siehe auch

- ibase_restore() - Leitet eine Wiederherstellungsaufgabe im Service Manager ein und kehrt sofort zurück

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