rzaripov.kz

Настройка автобэкапа базы данных в PHP скриптом

Я Равиль Зарипов, разработчик из Алматы, Казахстан. Помимо приложений для Android, iOS, Windows, macOS и Linux, я работаю с серверной логикой на PHP и базами данных. В проектах, где потеря данных недопустима, автоматическое резервное копирование становится частью эксплуатации, а не разовой задачей.

Надёжный процесс включает создание дампа, сжатие, проверку результата, ротацию старых копий и тест восстановления. PHP-скрипт связывает эти операции и запускается планировщиком без участия пользователя. Такой контур подходит интернет-магазину, панели управления и внутреннему сервису.

Подготовка среды и выбор способа копирования

Дамп лучше получать штатными средствами СУБД: mysqldump для MySQL и MariaDB, pg_dump для PostgreSQL. Ручная сборка SQL средствами PHP усложняет экранирование, нагружает процесс и часто пропускает представления, триггеры или хранимые процедуры. Для небольшого набора данных с заранее известным форматом исключение возможно.

Для запуска нужен PHP в режиме командной строки, а не веб-версия. Скрипт размещают вне публичного каталога сайта, конфигурацию с доступом — рядом, но под отдельными правами. Архивы лучше держать на другом разделе или сетевом томе: отказ основного диска не должен уничтожить одновременно базу и последнюю копию.

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

Скрипт резервного копирования MySQL

Конфигурацию отделяют от кода: путь к mysqldump, имя базы, каталог архивов, файл журнала и путь к файлу учётных данных. Пароль не размещают в PHP-файле, доступном через HTTP, и не передают аргументом командной строки. Для mysqldump удобен отдельный mysql-client.cnf с секцией client, доступный только пользователю запуска.

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

<?php
declare(strict_types=1);

$config = require __DIR__ . '/config.php';
$name = $config['database'] . '-' . gmdate('Y-m-d_H-i-s') . '.sql.gz';
$tempPath = $config['target_dir'] . '/' . $name . '.part';
$finalPath = $config['target_dir'] . '/' . $name;

$lock = fopen($config['target_dir'] . '/backup.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
    exit(0);
}

$command = [
    $config['mysqldump'],
    '--defaults-extra-file=' . $config['defaults_file'],
    '--single-transaction',
    '--quick',
    '--routines',
    '--triggers',
    '--events',
    '--hex-blob',
    '--default-character-set=utf8mb4',
    $config['database'],
];

try {
    $process = proc_open(
        $command,
        [1 => ['pipe', 'w'], 2 => ['file', $config['log_file'], 'a']],
        $pipes
    );
    if (!is_resource($process)) {
        throw new RuntimeException('Не удалось запустить mysqldump');
    }

    $archive = gzopen($tempPath, 'wb9');
    if ($archive === false) {
        proc_terminate($process);
        proc_close($process);
        throw new RuntimeException('Не удалось создать архив');
    }

    while (!feof($pipes[1])) {
        $chunk = fread($pipes[1], 8192);
        if ($chunk !== false && $chunk !== ''
            && gzwrite($archive, $chunk) === false) {
            throw new RuntimeException('Ошибка записи архива');
        }
    }
    fclose($pipes[1]);
    gzclose($archive);

    $exitCode = proc_close($process);
    if ($exitCode !== 0) {
        throw new RuntimeException('Ошибка mysqldump: ' . $exitCode);
    }
    if (!rename($tempPath, $finalPath)) {
        throw new RuntimeException('Не удалось сохранить архив');
    }

    $hash = hash_file('sha256', $finalPath);
    if ($hash === false) {
        throw new RuntimeException('Не удалось вычислить контрольную сумму');
    }
    file_put_contents(
        $finalPath . '.sha256',
        $hash . '  ' . basename($finalPath) . PHP_EOL,
        LOCK_EX
    );
} catch (Throwable $exception) {
    file_put_contents(
        $config['log_file'],
        gmdate('c') . ' ' . $exception->getMessage() . PHP_EOL,
        FILE_APPEND | LOCK_EX
    );
    if (is_file($tempPath)) {
        unlink($tempPath);
    }
    exit(1);
}

Для согласованного снимка InnoDB добавляют --single-transaction, а --quick не даёт команде загрузить таблицу в память. Флаги --routines, --triggers и --events включают дополнительные объекты при наличии соответствующих прав. MyISAM требует иного подхода: транзакционная согласованность для него не обеспечивается, поэтому учитывают блокировки и окно обслуживания. Массив аргументов в proc_open доступен начиная с PHP 7.4 и позволяет обойтись без запуска командной оболочки.

Работа с PostgreSQL и другими СУБД

PostgreSQL обрабатывается отдельным набором инструментов. Основную базу сохраняют через pg_dump в собственном формате: он сжимает данные и сохраняет структуру для выборочного восстановления. Обычный SQL удобнее для чтения человеком, но требует отдельного сценария развёртывания. Роли, таблицы пространства и глобальные настройки обычно сохраняют через pg_dumpall.

PHP вызывает внешнюю программу через proc_open, передавая параметры без сборки командной строки. Для PostgreSQL набор аргументов выглядит так:

$file = $config['target_dir'] . '/' . $config['database'] . '.dump';
$command = [
    '/usr/bin/pg_dump',
    '--format=custom',
    '--compress=9',
    '--no-owner',
    '--no-privileges',
    '--file=' . $file,
    $config['database'],
];

Собственный формат восстанавливают через pg_restore, предварительно просмотрев его содержимое командой --list. Снимок PostgreSQL опирается на MVCC и не блокирует обычное чтение, но учётной записи нужны права на чтение всех требуемых объектов. Расширения и бинарные данные проверяют на тестовой базе. Для SQLite применяют механизм .backup, поскольку простое копирование работающего файла не гарантирует согласованность, а MongoDB требует собственных mongodump и mongorestore.

Проверка ошибок и журналирование

Успешный код завершения PHP-процесса ещё не гарантирует пригодность копии. Проверяют, что команда дампа не вернула ошибку, архив не пуст, его размер сопоставим с предыдущими, а контрольная сумма вычислена. Резкое уменьшение объёма может означать потерю данных или сбой запроса.

В журнал записывают дату, имя базы, длительность операции, размер файла, результат и текст ошибки без паролей и полного содержимого дампа. Ошибки mysqldump направляются в stderr, а PHP дописывает собственные исключения. После успешного завершения также добавляют отдельную запись о результате. Журнал ограничивают по размеру и настраивают его ротацию, чтобы он не занимал диск.

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

Планировщик задач и расписание запусков

В Linux расписание задают через cron. Запись содержит абсолютные пути к интерпретатору и сценарию, а вывод перенаправляют в журнал:

CRON_TZ=Asia/Almaty
15 2 * * * /usr/bin/php /opt/app-backup/backup.php >> /var/log/app-backup.log 2>&1

Важно учитывать пользователя запуска, переменные окружения и часовой пояс сервера. Пути к PHP и утилитам не должны зависеть от интерактивного профиля shell. Файл crontab защищают от случайного изменения, а каталоги для архива и журнала открывают только нужной учётной записи.

На Windows аналогом служит Планировщик заданий, где указывают исполняемый файл php.exe и аргумент со сценарием. В macOS применяют launchd, а на серверах с systemd — timer. Запуск по расписанию удобен для полного ежедневного копирования, тогда как более частое сохранение увеличивает нагрузку и расход места. В моей практике задачи для разных операционных систем настраиваются по одному принципу: запуск должен быть повторяемым, а результат — доступным в журнале.

Защита копий и управление их хранением

Учётной записи для копирования нужны минимальные права на чтение данных и структуры выбранной базы. Для процедур и событий могут потребоваться дополнительные разрешения, но права на удаление или изменение данных выдавать не следует. Подключение ограничивают localhost или конкретным адресом, если сервер базы расположен отдельно.

Файл учётных данных закрывают правами 600, скрипт — правами 640, а каталог хранения — 750. В этих файлах не должно быть паролей, доступных посетителям сайта. Если копии содержат персональные данные, их шифруют средствами age или GPG, а ключ хранят отдельно от архивов.

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

Для устойчивости к отказам применяют принцип трёх копий: одну хранят локально, вторую — на сетевом ресурсе, третью — в другом центре обработки данных. Внешнее объектное хранилище подключают с отдельными учётными данными и проверяют, что загрузка действительно завершилась.

Проверка восстановления и контроль качества

Копия считается резервной только после успешного восстановления. Сначала проверяют SHA-256, затем создают отдельную тестовую базу и разворачивают архив, не затрагивая рабочую. Для проверки применяют отдельную учётную запись с ограниченным доступом к тестовой базе:

cd /var/backups/shop
sha256sum -c shop-2026-03-01_02-00-00.sql.gz.sha256
gunzip -c shop-2026-03-01_02-00-00.sql.gz | mysql --defaults-extra-file=/opt/app-backup/restore-client.cnf shop_restore

Восстановление PostgreSQL выполняют из пользовательского формата: сначала просматривают список объектов, затем выбирают нужную базу. Журнал сохраняет длительность операции и возникшие ошибки. Ежемесячная автоматическая проверка на изолированной базе выявляет отсутствующие расширения, недостаточные права и изменения в структуре до аварии.

Отдельно фиксируют требуемые RPO и RTO: максимально допустимую потерю данных и время восстановления. Обычный дамп не заменяет журналирование транзакций, если требуется восстановление на конкретный момент времени. Рабочим считается контур, в котором последняя копия регулярно восстанавливается, а журнал подтверждает успешный результат без пропусков.