PHP 8.4.6 Released!

ibase_restore

(PHP 5, PHP 7 < 7.4.0)

ibase_restoreInicia uma tarefa de restauração no gerenciador de serviços e retorna imediatamente

Descrição

ibase_restore(
    resource $service_handle,
    string $source_file,
    string $dest_db,
    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 restauração. Portanto, você não obterá nenhuma resposta.

Parâmetros

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.

Valor Retornado

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.

Exemplos

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

Veja Também

  • ibase_backup() - Inicia uma tarefa de backup no gerenciador de serviços e retorna imediatamente

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top