Инструменты PHP для восстановления файлов из архивов и директорий

Проверка целостности восстановленных файлов по контрольным суммам

После восстановления полезно сверить хеши файлов с эталонными, чтобы убедиться в отсутствии ошибок.

$hashesFile = '/backup/hashes.json';
if (!file_exists($hashesFile)) {
    echo 'Файл с хешами не найден.';
    exit;
}
$hashes = json_decode(file_get_contents($hashesFile), true);
$errors = [];
foreach ($hashes as $relativePath => $expectedHash) {
    $fullPath = '/var/www/html/' . ltrim($relativePath, '/');
    if (file_exists($fullPath)) {
        $actualHash = md5_file($fullPath);
        if ($actualHash !== $expectedHash) {
            $errors[] = "Не совпадает хеш для $relativePath (ожидалось $expectedHash, получено $actualHash)";
        }
    } else {
        $errors[] = "Файл $relativePath отсутствует";
    }
}
if (empty($errors)) {
    echo 'Все файлы прошли проверку целостности.';
} else {
    echo 'Обнаружены ошибки:
' . implode('
', $errors);
}

Все файлы прошли проверку целостности.

Восстановление с логом операций и прерыванием при ошибке

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

$logFile = '/var/log/restore.log';
$logHandle = fopen($logFile, 'a');
$fail = false;

$zip = new ZipArchive();
if ($zip->open('/backup/site.zip') === TRUE) {
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $filename = $zip->getNameIndex($i);
        if ($zip->extractTo('/var/www/html/', $filename) === false) {
            fwrite($logHandle, "[ERROR] Не удалось извлечь $filename\n");
            $fail = true;
            break; // прерываем
        }
        fwrite($logHandle, "[OK] $filename\n");
    }
    $zip->close();
} else {
    fwrite($logHandle, "[FATAL] Не удалось открыть архив\n");
    $fail = true;
}
fclose($logHandle);
if ($fail) {
    echo 'Восстановление прервано из-за ошибок. Подробности в логе.';
} else {
    echo 'Восстановление успешно, лог сохранен.';
}

Восстановление прервано из-за ошибок. Подробности в логе.

Восстановление с переименованием конфликтующих файлов (добавление временной метки)

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

$zip = new ZipArchive();
$targetDir = '/var/www/html/';
if ($zip->open('/backup/site.zip') === TRUE) {
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $filename = $zip->getNameIndex($i);
        $targetPath = $targetDir . $filename;
        if (file_exists($targetPath)) {
            $info = pathinfo($targetPath);
            $newName = $info['filename'] . '_' . date('YmdHis') . '.' . ($info['extension'] ?? '');
            $targetPath = $info['dirname'] . '/' . $newName;
        }
        $zip->extractTo($targetDir, $filename);
        if ($targetPath !== $targetDir . $filename) {
            rename($targetDir . $filename, $targetPath);
        }
    }
    $zip->close();
    echo 'Файлы восстановлены, конфликты переименованы.';
} else {
    echo 'Ошибка открытия архива.';
}

Файлы восстановлены, конфликты переименованы.

Потоковая загрузка больших файлов из FTP с возобновлением

Для файлов размером более 2 ГБ или при нестабильном соединении используется ftp_nb_get (non-blocking).

$ftp = ftp_connect('backup.example.com');
ftp_login($ftp, 'user', 'pass');
ftp_pasv($ftp, true);

$remoteFile = '/backups/large.sql.gz';
$localFile = '/var/www/html/large.sql.gz';
$ret = ftp_nb_get($ftp, $localFile, $remoteFile, FTP_BINARY);
while ($ret == FTP_MOREDATA) {
    echo '.';  // индикация прогресса
    $ret = ftp_nb_continue($ftp);
}
if ($ret == FTP_FINISHED) {
    echo "\nСкачивание завершено.";
} else {
    echo "\nОшибка скачивания.";
}
ftp_close($ftp);

..........
Скачивание завершено.

Восстановление с использованием SCP через proc_open

SCP - безопасный способ передачи файлов по SSH. В PHP можно запустить scp через proc_open.

$descriptorspec = [
    0 => ['pipe', 'r'],  // stdin
    1 => ['pipe', 'w'],  // stdout
    2 => ['pipe', 'w']   // stderr
];
$process = proc_open(
    'scp -r user@backup.server:/backup/site/* /var/www/html/',
    $descriptorspec,
    $pipes
);
if (is_resource($process)) {
    fclose($pipes[0]);
    $output = stream_get_contents($pipes[1]);
    $error = stream_get_contents($pipes[2]);
    fclose($pipes[1]);
    fclose($pipes[2]);
    $return_value = proc_close($process);
    if ($return_value === 0) {
        echo 'Восстановление через SCP выполнено.';
    } else {
        echo 'Ошибка SCP: ' . $error;
    }
}

Восстановление через SCP выполнено.