(PHP 5, PHP 7 < 7.4.0)
ibase_backup — Inicia una tarea de respaldo en el gestor de servicios y devuelve inmediatamente
$service_handle
,$source_db
,$dest_file
,$options
= 0,$verbose
= false
Esta función transmite los argumentos al servidor de base de datos (remoto). Allí, comienza un nuevo proceso de respaldo. Por consiguiente, no se obtendrá ninguna respuesta.
service_handle
Una conexión al servidor de base de datos creada previamente.
source_db
La ruta absoluta hacia la base de datos en el servidor de base de datos. También se puede utilizar un alias de base de datos.
dest_file
La ruta absoluta hacia el fichero de respaldo en el servidor de base de datos.
options
Opciones adicionales a transmitir al servidor de base de datos
para el respaldo.
El parámetro options
puede ser una combinación
de las siguientes 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
o
IBASE_BKP_CONVERT
.
Leer la sección sobre Constantes predefinidas para
más información.
verbose
Dado que el proceso de respaldo se realiza en el servidor de base de datos, no se tiene ninguna 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 respaldo 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_backup()
<?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 respaldo en el servidor de base de datos
// Respaldar la base de datos employee utilizando la ruta completa hacia /srv/backup/employees.fbk
// No utiliza argumentos especiales
ibase_backup($service, '/srv/firebird/employees.fdb', '/srv/backup/employees.fbk');
// Liberar la conexión adjunta
ibase_service_detach ($service);
?>
Ejemplo #2 Ejemplo de ibase_backup() 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 respaldo en el servidor de base de datos
// Respaldar la base de datos employee utilizando un alias hacia /srv/backup/employees.fbk.
// Respaldar solo los metadatos. No crear un respaldo transportable.
ibase_backup($service, 'employees.fdb', '/srv/backup/employees.fbk', IBASE_BKP_METADATA_ONLY | IBASE_BKP_NON_TRANSPORTABLE);
// Liberar la conexión adjunta
ibase_service_detach ($service);
?>