PHP Conference Kansai 2025

ibase_restore

(PHP 5, PHP 7 < 7.4.0)

ibase_restoreInicia una tarea de restauración en el gestor de servicios y devuelve inmediatamente

Descripción

ibase_restore(
    resource $service_handle,
    string $source_file,
    string $dest_db,
    int $options = 0,
    bool $verbose = false
): mixed

Esta función transmite los argumentos al servidor de base de datos (remoto). Allí, comienza un nuevo proceso de restauración. Por lo tanto, no se obtendrá ninguna respuesta.

Parámetros

service_handle

Una conexión al servidor de base de datos creada previamente.

source_file

La ruta absoluta en el servidor donde se encuentra el fichero de respaldo.

dest_db

La ruta para crear la nueva base de datos en el servidor. También se puede utilizar un alias de base de datos.

options

Opciones adicionales a transmitir al servidor de base de datos para la restauración. El parámetro options puede ser una combinación de las siguientes 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, IBASE_RES_CREATE. Leer la sección sobre Constantes predefinidas para más información.

verbose

Dado que el proceso de restauración se realiza en el servidor de base de datos, no hay posibilidad de obtener su salida. Este argumento es inútil.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Dado que el proceso de restauración se realiza en el servidor (remoto), esta función solo transmite los argumentos. Mientras los argumentos sean legales, no se obtendrá false.

Ejemplos

Ejemplo #1 Ejemplo con ibase_restore()

<?php
// Adjuntar al servidor por dirección IP y puerto.
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');

// Iniciar el proceso de restauración en el servidor de base de datos
// Restaurar el respaldo de employee a la nueva base de datos emps.fdb
// No utiliza argumentos especiales
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');

// Libera la conexión adjunta
ibase_service_detach ($service);
?>

Ejemplo #2 Ejemplo de ibase_restore() con argumentos

<?php

// Adjuntar al servidor por nombre y puerto por defecto
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');

// Iniciar el proceso de restauración en el servidor de base de datos
// Restaurar la base de datos employee utilizando un alias.
// Restaurar sin índice, Reemplazar la base de datos existente.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);

// Libera la conexión adjunta
ibase_service_detach ($service);
?>

Ver también

  • ibase_backup() - Inicia una tarea de respaldo en el gestor de servicios y devuelve inmediatamente

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top