(PHP 5, PHP 7 < 7.4.0)
ibase_restore — 在服務管理員中啟動還原任務並立即返回
$service_handle
,$source_file
,$dest_db
,$options
= 0,$verbose
= false
這個函式會將參數傳遞給(遠端)資料庫伺服器。它會在伺服器上啟動一個新的還原程序。因此您不會收到任何回應。
service_handle
先前開啟的資料庫伺服器連線。
source_file
伺服器上備份檔案所在的絕對路徑。
dest_db
要在伺服器上建立新資料庫的路徑。您也可以使用資料庫別名。
options
傳遞給資料庫伺服器用於還原的額外選項。 options
參數可以是以下常數的組合: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
。請閱讀關於預定義常數的章節以了解更多資訊。
verbose
由於還原程序是在資料庫伺服器上完成的,因此您沒有機會取得其輸出。這個參數沒有作用。
範例 #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);
?>