(PHP 5, PHP 7 < 7.4.0)
ibase_backup — Inicia uma tarefa de backup no gerenciador de serviços e retorna imediatamente
$service_handle
,$source_db
,$dest_file
,$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 backup. Portanto, nenhuma resposta será obtida.
service_handle
Uma conexão aberta anteriormente com o servidor de banco de dados.
source_db
O caminho absoluto do arquivo para o banco de dados no servidor de banco de dados. Pode-se também usar um apelido de banco de dados.
dest_file
O caminho para o arquivo de backup no servidor de banco de dados.
options
Opções adicionais para passar ao servidor de banco de dados para backup.
O parâmetro options
pode ser uma combinação
das seguintes constantes:
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
ou
IBASE_BKP_CONVERT
.
Leia a seção sobre Constantes predefinidas para mais informações.
verbose
Como o processo de backup é feito no servidor de banco de dados, a saída não poderá ser obtida. Este argumento é inútil.
Retorna true
em caso de sucesso ou false
em caso de falha.
Como o processo de backup é 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_backup()
<?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 backup no servidor de banco de dados
// Faz backup do banco de dados de funcionários usando o caminho completo para /srv/backup/employees.fbk
// Não usa nenhum argumento especial
ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');
// Libera a conexão
ibase_service_detach ($service);
?>
Exemplo #2 Exemplo de ibase_backup() 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 backup no servidor de banco de dados
// Faz backup do banco de dados de funcionários usando o apelido /srv/backup/employees.fbk.
// Faz backup somente dos metadados. Não cria um backup transportável.
ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);
// Libera a conexão
ibase_service_detach ($service);
?>