PHP8 ibase_restore
(PHP 5、PHP 7 < 7.4.0)
ibase_restore — 在服务管理器中启动还原任务并立即返回
说明
ibase_restore(
resource $service_handle,
string $source_file,
string $dest_db,
int $options = 0,
bool $verbose = false
): mixed
此函数将参数传递给(远程)数据库服务器。在那里,它开始一个新的还原过程。因此,您 不会得到任何回应。
参数
service_handle
以前打开的与数据库服务器的连接。
source_file
备份文件所在的服务器上的绝对路径。
dest_db
在服务器上创建新数据库的路径。还可以使用数据库别名。
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
。 有关详细信息,请阅读有关预定义常量的部分。options
verbose
由于还原过程是在数据库服务器上完成的,因此您没有任何机会 以获取其输出。这个论点是没有用的。
返回值
成功时返回 true, 或者在失败时返回 false。
由于还原过程是在(远程)服务器上完成的,因此此函数只是将参数传递给它。 虽然这些论点是合法的,但你不会得到错误。
示例
示例 #1 ibase_restore() example
<?php
// Attach to database server by ip address and port
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');
// Start the restore process on database server
// Restore employee backup to the new emps.fdb database
// Don't use any special arguments
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');
// Free the attached connection
ibase_service_detach ($service);
?>
示例 #2 ibase_restore() 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 restore process on database server
// Restore to employee database using alias.
// Restore without indixes. Replace existing database.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);
// Free the attached connection
ibase_service_detach ($service);
?>
参见
- ibase_backup() - 在服务管理器中启动备份任务并立即返回