array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.ibase-restore.php', 1 => 'ibase_restore', 2 => 'Leitet eine Wiederherstellungsaufgabe im Service Manager ein und kehrt sofort zurück', ), 'up' => array ( 0 => 'ref.ibase.php', 1 => 'Firebird/InterBase Funktionen', ), 'prev' => array ( 0 => 'function.ibase-query.php', 1 => 'ibase_query', ), 'next' => array ( 0 => 'function.ibase-rollback.php', 1 => 'ibase_rollback', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/ibase/functions/ibase-restore.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ibase_restore

(PHP 5, PHP 7 < 7.4.0)

ibase_restore — Leitet eine Wiederherstellungsaufgabe im Service Manager ein und kehrt sofort zurück

Beschreibung

ibase_restore(
    resource $service_handle,
    string $source_file,
    string $dest_db,
    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_file
Der absolute Pfad auf dem Server, auf dem sich die Sicherungsdatei befindet.
dest_db
Der Pfad zum Erstellen der neuen Datenbank auf dem Server. Sie können auch einen Datenbankalias verwenden.
options

Zusätzliche Optionen, die zur Wiederherstellung an den Datenbankserver übergeben werden. Der Parameter options darf aus Kombinationen folgender Konstanten bestehen: IBASE_RES_DEACTIVATE_IDX, IBASE_RES_NO_SHADOW, IBASE_RES_NO_VALIDITY, IBASE_RES_ONE_AT_A_TIME, IBASE_RES_REPLACE, IBASE_RES_CREATE, IBASE_RES_USE_ALL_SPACE, IBASE_PRP_PAGE_BUFFERS, IBASE_PRP_SWEEP_INTERVAL, IBASE_RES_CREATE. Vgl. den Abschnitt Vordefinierte Konstanten für weitere informationen.

verbose
Da der Wiederherstellungsvorgang 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_restore()-Beispiel

<?php

// Mit Datenbankserver mittels IP-Adresse und Port verbinden
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');

// Starte den Wiederherstellungsvorgang
// Wiederherstellung der Mitarbeiter-DB in neue emps.fdb-Datenbank.
// Keine Angabe weiterer Argumente.
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');

// Verbindung wieder freigeben
ibase_service_detach ($service);
?>

Beispiel #2 ibase_restore()-Beispiel mit Argumenten

<?php

// Mit Datenbankserver mittels Namen und Standardport verbinden
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');

// Starte den Wiederherstellungsprozess
// Employee-Datenbank mittels Alias wiederherstellen
// Wiederherstellung ohne Indizes. Existierende DB ersetzen.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);

// Verbindung wieder freigeben.
ibase_service_detach ($service);
?>

Siehe auch