array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ibase-backup.php', 1 => 'ibase_backup', 2 => 'Initiiert eine Sicherungsaufgabe im Service Manager und springt sofort zurück', ), 'up' => array ( 0 => 'ref.ibase.php', 1 => 'Firebird/InterBase Funktionen', ), 'prev' => array ( 0 => 'function.ibase-affected-rows.php', 1 => 'ibase_affected_rows', ), 'next' => array ( 0 => 'function.ibase-blob-add.php', 1 => 'ibase_blob_add', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/ibase/functions/ibase-backup.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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