Бэкап-скрипт на PHP для резервного копирования файлов
Резервное копирование через PHP удобно там, где проект уже работает на веб-сервере, а отдельный агент устанавливать нежелательно. Скрипт запускается из командной строки, собирает заданные каталоги в ZIP-архив, ведёт журнал и удаляет старые копии по настраиваемому правилу. Подход подходит VPS, контейнеру и локальному серверу разработчика.
PHP-решение не заменяет систему резервирования на уровне инфраструктуры, но закрывает потребность небольшого проекта в регулярных копиях пользовательских файлов, конфигурации и загруженных документов. Его сильная сторона — близкий к приложению язык, знакомый разработчику, и отсутствие обязательных внешних зависимостей. Один сценарий можно запускать вручную, по таймеру и после развёртывания.
Надёжный сценарий учитывает несколько условий: исходные пути задаются явно, архив сначала записывается во временный файл, целостность проверяется до переименования, а результат каждого запуска фиксируется в журнале. Ошибки приводят к ненулевому коду завершения, чтобы планировщик или система мониторинга заметили сбой.
Равиль Зарипов — разработчик из Алматы, работающий с PHP и базами данных; его профессиональный профиль опубликован на сайте Равиля Зарипова. Такой контекст особенно полезен при выборе между простым CLI-решением и полноценной системой хранения резервных копий.
Подготовка окружения и конфигурации
Для запуска нужен PHP 8.1 или новее в режиме CLI, расширение ZipArchive и права чтения исходных каталогов. Проверку установленного модуля выполняют командой php -m, а версию интерпретатора — командой php -v. На сервере должен существовать каталог назначения, доступный пользователю, от имени которого работает расписание.
Параметры выносят из основного кода в отдельный файл, расположенный вне публичной директории сайта. Такой файл возвращает массив, а главный сценарий подключает его через require и проверяет типы значений. Это упрощает перенос между окружениями и исключает публикацию путей в веб-доступном каталоге.
<?php
declare(strict_types=1);
return [
'sources' => [
'public' => '/srv/app/public',
'uploads' => '/srv/app/storage/uploads',
],
'destination' => '/srv/backups/app',
'excluded' => ['/srv/app/storage/cache'],
'keep' => 14,
'log' => '/var/log/app-backup-events.log',
];
Перед каждым запуском проверяют существование источников через realpath(), запрещают совпадение каталога назначения с исходным деревом и нормализуют разделители пути. Конфигурацию закрывают от других пользователей правами 0600, а каталог с копиями — правами 0700. Симлинки лучше исключать: их цель может находиться за пределами проекта, а развёртывание архива на другой машине изменит структуру каталогов.
Рекурсивный сбор файлов
Для обхода дерева подходит RecursiveIteratorIterator, обёрнутый вокруг RecursiveDirectoryIterator. Он позволяет получить обычные файлы из вложенных каталогов, сохранить относительный путь внутри архива и пропускать служебные элементы. Перед добавлением файла проверяют, не попадает ли он в список исключений, заданный полными путями. К исключениям обычно относят кеш, временные файлы и служебные каталоги.
Ниже показана функция, которая возвращает соответствие «имя внутри архива — путь на диске». Префикс public или uploads предотвращает совпадение одинаковых имён из разных исходных каталогов.
function collectFiles(array $sources, array $excluded): array
{
$files = [];
foreach ($sources as $prefix => $source) {
$root = realpath($source);
if ($root === false) {
throw new RuntimeException('Каталог не найден: ' . $source);
}
$root = rtrim(str_replace('\\', '/', $root), '/');
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($root, FilesystemIterator::SKIP_DOTS),
RecursiveIteratorIterator::SELF_FIRST
);
foreach ($iterator as $item) {
if ($item->isLink() || !$item->isFile()) {
continue;
}
$path = str_replace('\\', '/', $item->getPathname());
$skip = false;
foreach ($excluded as $excludedPath) {
$excludedPath = rtrim(str_replace('\\', '/', $excludedPath), '/');
if ($path === $excludedPath || str_starts_with($path, $excludedPath . '/')) {
$skip = true;
break;
}
}
if (!$skip) {
$relative = ltrim(substr($path, strlen($root)), '/');
$files[$prefix . '/' . $relative] = $path;
}
}
}
return $files;
}
Собранный массив передают в ZipArchive. Имя файла содержит дату и время, а запись идёт в расширение .part; только успешно закрытый архив получает окончательное имя. Если файл изменился во время чтения, его версия в копии соответствует фактически прочитанным данным, поэтому согласованные изменения лучше завершать до запуска.
$files = collectFiles($config['sources'], $config['excluded']);
$name = 'backup-' . date('Y-m-d_H-i-s') . '.zip';
$target = rtrim($config['destination'], '/') . '/' . $name;
$temp = $target . '.part';
$zip = new ZipArchive();
if ($zip->open($temp, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
throw new RuntimeException('Не удалось создать архив: ' . $zip->getStatusString());
}
foreach ($files as $archiveName => $source) {
if (!$zip->addFile($source, $archiveName)) {
throw new RuntimeException('Не удалось добавить файл: ' . $source);
}
}
if (!$zip->close()) {
throw new RuntimeException('Не удалось закрыть архив');
}
Архивирование и проверка целостности
После закрытия ZIP-файл открывают повторно с флагом ZipArchive::CHECKCONS и сравнивают число элементов с числом исходных файлов. Дополнительно вычисляют SHA-256 готового файла: эта сумма не заменяет проверку структуры ZIP, но позволяет подтвердить, что копия не изменилась при передаче или хранении. Полученную сумму сохраняют отдельно от архива.
$check = new ZipArchive();
if ($check->open($temp, ZipArchive::CHECKCONS) !== true) {
throw new RuntimeException('Проверка архива не пройдена');
}
if ($check->numFiles !== count($files)) {
$check->close();
throw new RuntimeException('Число файлов в архиве не совпадает');
}
$check->close();
if (!rename($temp, $target)) {
throw new RuntimeException('Не удалось опубликовать архив');
}
$hash = hash_file('sha256', $target);
Журнал должен отвечать на вопросы о времени запуска, имени копии, размере, хеше и причине ошибки. Запись выполняется через FILE_APPEND | LOCK_EX, чтобы параллельные процессы не перемешали строки. Чувствительные значения вроде паролей или содержимого конфигурации в журнал не записывают. Незавершённый файл .part после сбоя удаляют или переносят в отдельный каталог для разбора.
$record = [
'time' => date(DATE_ATOM),
'event' => 'backup_completed',
'archive' => basename($target),
'bytes' => filesize($target),
'sha256' => $hash,
];
file_put_contents(
$config['log'],
json_encode($record, JSON_UNESCAPED_UNICODE) . PHP_EOL,
FILE_APPEND | LOCK_EX
);
Ротация копий и автоматический запуск
Ротация ограничивает расход диска. Поскольку имена имеют сортируемый формат, архивы можно отсортировать по убыванию и удалить элементы после заданного количества. Шаблон поиска жёстко привязан к каталогу назначения, поэтому скрипт не должен удалять произвольные ZIP-файлы в общей папке. Результат удаления каждого архива записывают в журнал.
$archives = glob(rtrim($config['destination'], '/') . '/backup-*.zip') ?: [];
usort(
$archives,
static fn(string $a, string $b): int => strcmp(basename($b), basename($a))
);
foreach (array_slice($archives, $config['keep']) as $oldArchive) {
if (is_file($oldArchive) && !is_link($oldArchive)) {
unlink($oldArchive);
}
}
Одновременный запуск блокируют файловым замком flock(). Если другой процесс уже выполняет копирование, новый запуск должен спокойно завершиться без удаления файлов. Замок удерживают до конца операции и освобождают в блоке finally, даже если возникло исключение.
$lock = fopen('/var/lock/app-backup.lock', 'c');
if ($lock === false) {
throw new RuntimeException('Не удалось открыть файл блокировки');
}
if (!flock($lock, LOCK_EX | LOCK_NB)) {
exit(0);
}
На Linux задание добавляют в crontab, указывая абсолютный путь к PHP и отдельный журнал запуска. На Windows эквивалентом служит планировщик задач с запуском php.exe и сценария через CMD. Перед настройкой расписания проверяют права на файл блокировки, журналы и каталог архивов.
15 2 * * * /usr/bin/php /opt/app-backup/backup.php >> /var/log/app-backup-run.log 2>&1
Тестирование восстановления и безопасность
Резервную копию считают рабочей только после пробного восстановления. Архив распаковывают в отдельный пустой каталог, не находящийся в публичной директории, затем сравнивают контрольные суммы выбранных файлов с исходниками. Перед извлечением имена элементов проверяют на абсолютные пути и компоненты .., чтобы исключить запись за пределами целевого каталога.
Испытание повторяют по графику, а не только после развёртывания новой версии скрипта. Одновременно контролируют количество файлов, распакованный размер и время восстановления. Эти показатели показывают, поместится ли копия в доступное пространство и уложится ли восстановление в допустимый срок. Для проверки используют отдельную тестовую машину или окружение, не изменяя рабочее приложение.
Каталог с копиями закрывают от веб-сервера и других пользователей операционной системы. Для переноса на другой сервер применяют шифрование, а копии хранят в другом центре обработки данных. Пароли баз данных и ключи шифрования следует хранить отдельно от архивов и журналов. Срок жизни резервных копий учитывают с учётом требований к восстановлению данных.
Файлы приложения и данные СУБД требуют согласованного сохранения. Для MySQL или PostgreSQL запускают отдельный дамп через mysqldump либо pg_dump, передавая параметры через безопасное окружение и экранируя аргументы. Транзакционная согласованность, положение точки восстановления и доступность архивов проверяются совместно, превращая восстановление проекта в измеримую и контролируемую операцию.