(PHP 5, PHP 7 < 7.4.0)
ibase_restore — Inicia uma tarefa de restauração no gerenciador de serviços e retorna imediatamente
$service_handle
,$source_file
,$dest_db
,$options
= 0,$verbose
= false
Esta função passa os argumentos para o servidor de banco de dados (remoto). Lá, ele inicia um novo processo de restauração. Portanto, você não obterá nenhuma resposta.
service_handle
Uma conexão aberta anteriormente com o servidor de banco de dados.
source_file
O caminho absoluto no servidor onde o arquivo de backup está localizado.
dest_db
O caminho para criar o novo banco de dados no servidor. Pode-se também usar o apelido do banco de dados.
options
Opções adicionais para passar ao servidor de banco de dados para restauração.
O parâmetro options
pode ser uma combinação
das seguintes constantes:
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
e
IBASE_RES_CREATE
.
Leia a seção sobre Constantes predefinidas para mais informações.
verbose
Como o processo de restauração é feito no servidor de banco de dados, não há como obter sua saída. Este argumento é inútil.
Retorna true
em caso de sucesso ou false
em caso de falha.
Como o processo de restauração é feito no servidor (remoto), esta função apenas passa os argumentos para ele.
Embora os argumentos sejam legais, não será obtido false
.
Exemplo #1 Exemplo de ibase_restore()
<?php
// Conecta-se ao servidor de banco de dados por endereço IP e porta
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');
// Inicia o processo de restauração no servidor de banco de dados
// Restaura o backup 'employees' para o novo banco de dados 'emps.fdb'
// Não usa nenhum argumento especial
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');
// Libera a conexão
ibase_service_detach ($service);
?>
Exemplo #2 Exemplo de ibase_restore() com argumentos
<?php
// Conecta-se ao servidor de banco de dados por nome e porta padrão
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');
// Inicia o processo de restauração no servidor de banco de dados
// Restaurar o banco de dados 'employees' usando o apelido.
// Restaura sem índices. Substitui banco de dados existente.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);
// Libera a conexão
ibase_service_detach ($service);
?>