2024 年 PHP Conference Japan

ibase_restore

(PHP 5, PHP 7 < 7.4.0)

ibase_restore在服務管理員中啟動還原任務並立即返回

說明

ibase_restore(
    資源 $service_handle,
    字串 $source_file,
    字串 $dest_db,
    整數 $options = 0,
    布林值 $verbose = false
): 混合

這個函式會將參數傳遞給(遠端)資料庫伺服器。它會在伺服器上啟動一個新的還原程序。因此您不會收到任何回應。

參數

service_handle

先前開啟的資料庫伺服器連線。

source_file

伺服器上備份檔案所在的絕對路徑。

dest_db

要在伺服器上建立新資料庫的路徑。您也可以使用資料庫別名。

options

傳遞給資料庫伺服器用於還原的額外選項。 options 參數可以是以下常數的組合:IBASE_RES_DEACTIVATE_IDXIBASE_RES_NO_SHADOWIBASE_RES_NO_VALIDITYIBASE_RES_ONE_AT_A_TIMEIBASE_RES_REPLACEIBASE_RES_CREATEIBASE_RES_USE_ALL_SPACEIBASE_PRP_PAGE_BUFFERSIBASE_PRP_SWEEP_INTERVALIBASE_RES_CREATE。請閱讀關於預定義常數的章節以了解更多資訊。

verbose

由於還原程序是在資料庫伺服器上完成的,因此您沒有機會取得其輸出。這個參數沒有作用。

傳回值

成功時傳回 true,失敗時傳回 false

由於還原程序是在(遠端)伺服器上完成的,這個函式只是將參數傳遞給它。只要參數合法,您就不會收到 false

範例

範例 #1 ibase_restore() 範例

<?php

// 透過 IP 位址和埠連接到資料庫伺服器
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');

// 在資料庫伺服器上啟動還原程序
// 將員工備份還原到新的 emps.fdb 資料庫
// 不使用任何特殊參數
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');

// 釋放已連接的連線
ibase_service_detach ($service);
?>

範例 #2 ibase_restore() 使用參數的範例

<?php

// 以名稱和預設埠連接到資料庫伺服器
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');

// 在資料庫伺服器上啟動還原程序
// 使用別名還原到 employee 資料庫。
// 還原時不包含索引。取代現有的資料庫。
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);

// 釋放已連接的連線
ibase_service_detach ($service);
?>

另請參閱

  • ibase_backup() - 在服務管理員中啟動備份任務並立即返回

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top