Inicia uma tarefa de backup no gerenciador de serviços e retorna imediatamente

# ibase_backup

(PHP 5, PHP 7 < 7.4.0)

ibase_backup — Inicia uma tarefa de backup no gerenciador de serviços e retorna imediatamente

### Descrição

function ibase_backup(
resource `$service_handle`,
string `$source_db`,
string `$dest_file`,
int `$options` = 0,
bool `$verbose` = `false`
): mixed

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.

### Parâmetros

`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.

### Valor Retornado

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`.

### Exemplos

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);
    ?>

### Veja Também

- ibase_restore() - Inicia uma tarefa de restauração no gerenciador de serviços e retorna imediatamente

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open