fbird_restore()
从备份文件中还原 Firebird 数据库
函数名：fbird_restore()
适用版本：Firebird 2.1.0 及以上版本
用法：fbird_restore() 函数用于从备份文件中还原 Firebird 数据库。
语法：
bool fbird_restore ( resource $service_handle , string $source_file , string $dest_db [, int $options = 0 [, bool $verbose = false ]] )
参数：
service_handle: Firebird 服务句柄，通过 fbird_service_attach() 函数获取。
source_file: 备份文件的路径和文件名。
dest_db: 还原后的数据库路径和文件名。
options（可选）: 还原选项，可以是以下常量的组合：
FBK_DEFAULT：默认选项，没有附加选项。
FBK_MERGE：将备份文件合并到现有数据库中。
FBK_NO_SHADOW：还原时不使用阴影文件。
FBK_NO_VALIDITY：还原时不验证备份文件的完整性。
FBK_CONVERT：在还原时将备份文件中的字符集转换为当前数据库的字符集。
verbose（可选）: 是否输出详细还原过程的信息，默认为 false。
返回值：若还原成功，则返回 true，否则返回 false。
示例：
<?php
// 连接到 Firebird 服务
$service_handle = fbird_service_attach('localhost', 'sysdba', 'masterkey');
// 指定备份文件和还原后的数据库路径
$source_file = '/path/to/backup.fbk';
$dest_db = '/path/to/restore.fdb';
// 还原数据库
if (fbird_restore($service_handle, $source_file, $dest_db, FBK_DEFAULT, true)) {
echo "数据库还原成功！";
} else {
echo "数据库还原失败！";
}
// 断开与 Firebird 服务的连接
fbird_service_detach($service_handle);
?>
注意事项：
在执行还原操作之前，需要先通过 fbird_service_attach() 函数连接到 Firebird 服务。
请确保备份文件和还原后的数据库路径的可读写权限。
如果还原过程中出现错误，可以使用 fbird_errmsg() 函数获取错误信息。