PHP Conference Japan 2024

ibase_backup

(PHP 5, PHP 7 < 7.4.0)

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

描述

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

此函數將引數傳遞給(遠端)資料庫伺服器。它會在該處啟動新的備份程序。因此,您不會收到任何回應。

參數

service_handle

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

source_db

資料庫伺服器上資料庫的絕對檔案路徑。您也可以使用資料庫別名。

dest_file

資料庫伺服器上備份檔案的路徑。

options

傳遞給資料庫伺服器以進行備份的其他選項。 options 參數可以是以下常數的組合: IBASE_BKP_IGNORE_CHECKSUMSIBASE_BKP_IGNORE_LIMBOIBASE_BKP_METADATA_ONLYIBASE_BKP_NO_GARBAGE_COLLECTIBASE_BKP_OLD_DESCRIPTIONSIBASE_BKP_NON_TRANSPORTABLEIBASE_BKP_CONVERT。請閱讀 預定義常數 章節以獲取更多資訊。

verbose

由於備份程序在資料庫伺服器上完成,因此您沒有機會獲得其輸出。這個引數沒有用處。

回傳值

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

由於備份程序在(遠端)伺服器上完成,因此此函數僅將引數傳遞給它。只要引數合法,您就不會收到 false

範例

範例 1 ibase_backup() 範例

<?php

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

// 在資料庫伺服器上啟動備份程序
// 使用完整路徑備份 /srv/backup/employees.fbk 的 employee 資料庫
// 不要使用任何特殊引數
ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');

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

範例 2 ibase_backup() 帶有引數的範例

<?php

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

// 在資料庫伺服器上啟動備份程序
// 使用別名將 employee 資料庫備份到 /srv/backup/employees.fbk。
// 僅備份中繼資料。不要建立可傳輸的備份。
ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);

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

參見

新增註解

使用者貢獻的註解

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