PHP Conference Nagoya 2025

ibase_restore

(PHP 5, PHP 7 < 7.4.0)

ibase_restoreЗапускает задачу восстановления в диспетчере служб и немедленно возвращается

Описание

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

Эта функция передаёт аргументы (удалённому) серверу базы данных. Там она начинает новый процесс восстановления. Поэтому вы не получите никакого ответа.

Список параметров

service_handle

Ранее открытое соединение с сервером базы данных.

source_file

Абсолютный путь на сервере, где находится файл резервной копии.

dest_db

Путь для создания новой базы данных на сервере. Вы также можете использовать псевдоним базы данных.

options

Дополнительные параметры для передачи на сервер базы данных для восстановления. Параметр options может быть комбинацией следующих констант: 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. Читайте раздел о Предопределённые константы для получения дополнительной информации.

verbose

Поскольку процесс восстановления выполняется на сервере базы данных, у вас нет возможности получить вывод. Этот аргумент бесполезен.

Возвращаемые значения

Функция возвращает true в случае успешного выполнения или false, если возникла ошибка.

Поскольку процесс восстановления выполняется на (удалённом) сервере, эта функция просто передаёт ему аргументы. Если аргументы недействительны, то вернётся false.

Примеры

Пример #1 Пример использования ibase_restore()

<?php

// Подключение к серверу базы данных по ip-адресу и порту
$service = ibase_service_attach ('10.1.11.200/3050', 'sysdba', 'masterkey');

// Запуск процесса восстановления на сервере базы данных
// Восстановление резервной копии employee в новую базу данных emps.fdb
// Не используйте никаких специальных аргументов
ibase_restore($service, '/srv/backup/employees.fbk', '/srv/firebird/emps.fdb');

// Освобождение соединения
ibase_service_detach ($service);
?>

Пример #2 Пример использования ibase_restore() с аргументами

<?php

// Присоединение к серверу базы данных по имени и порту по умолчанию
$service = ibase_service_attach ('fb-server.contoso.local', 'sysdba', 'masterkey');

// Запуск процесса восстановления на сервере базы данных
// Восстановление базы данных employee с использованием псевдонима.
// Восстановление без индексов. Замена существующей базы данных.
ibase_restore($service, '/srv/backup/employees.fbk', 'employees.fdb', IBASE_RES_DEACTIVATE_IDX | IBASE_RES_REPLACE);

// Освобождение прикрепленного соединения
ibase_service_detach ($service);
?>

Смотрите также

  • ibase_backup() - Инициирует задание резервного копирования в диспетчере служб и немедленно возвращает

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top