PHP8 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
传递到数据库服务器进行备份的其他选项。 参数可以是组合 以下常量:
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
或IBASE_BKP_CONVERT
。 有关详细信息,请阅读有关预定义常量的部分。options
verbose
由于备份过程是在数据库服务器上完成的,因此您没有任何机会 获取其输出。这个论点是没有用的。
返回值
成功时返回 true, 或者在失败时返回 false。
由于备份过程是在(远程)服务器上完成的,因此此函数只是将参数传递给它。 虽然这些论点是合法的,但你不会得到错误。
示例
示例 #1 ibase_backup() example
<?php
// Attach to database server by ip address and port
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');
// Start the backup process on database server
// Backup employee database using full path to /srv/backup/employees.fbk
// Don't use any special arguments
ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');
// Free the attached connection
ibase_service_detach ($service);
?>
示例 #2 ibase_backup() example with arguments
<?php
// Attach to database server by name and default port
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');
// Start the backup process on database server
// Backup employee database using alias to /srv/backup/employees.fbk.
// Backup only the metadata. Don't create a transportable backup.
ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);
// Free the attached connection
ibase_service_detach ($service);
?>
参见
- ibase_restore() - 在服务管理器中启动还原任务并立即返回