ibase_restore()
(PHP 5, PHP 7)
Initiates a restore task in the service manager and returns immediately
说明
ibase_restore(resource $service_handle,string $source_file,string $dest_db[,int $options= 0[,bool $verbose= FALSE
]]): mixed
This function passes the arguments to the(remote)database server. There it starts a new restore process. Therefore you won't get any responses.
参数
- $service_handle
A previously opened connection to the database server.
- $source_file
The absolute path on the server where the backup file is located.
- $dest_db
The path to create the new database on the server. You can also use database alias.
- $options
Additional options to pass to the database server for restore. The$optionsparameter can be a combination of the following constants:
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
. Read the section about 预定义常量 for further information.- $verbose
Since the restore process is done on the database server, you don't have any chance to get its output. This argument is useless.
返回值
成功时返回TRUE
,或者在失败时返回FALSE
。
Since the restore process is done on the(remote)server, this function just passes the arguments to it. While the arguments are legal, you won't get FALSE
.
范例
Example #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); ?>
Example #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()
Initiates a backup task in the service manager and returns immediately