(PHP 5, PHP 7 < 7.4.0)
ibase_restore — Inicia una tarea de restauración en el gestor de servicios y devuelve inmediatamente
$service_handle
,$source_file
,$dest_db
,$options
= 0,$verbose
= false
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.
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.
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
.
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);
?>