УРОК · Тестирование и безопасность

Резервные копии и наблюдение

Опубликовано Автор: Соловьёва Мария Андреевна

Локальная SQLite может пропасть или стать недоступной. Проверим копию восстановлением и получим явный сигнал сбоя без раскрытия пути к базе.

Разберём по шагам

Резервная копия полезна после проверки восстановления. Здесь остановим сервер перед копированием SQLite, сохраним файл вне проекта и откроем восстановленную копию отдельно через NOTES_DB_PATH. Для наблюдения добавим CLI-проверку, которая возвращает код 0 при доступной таблице notes и 1 при ошибке. Это ещё не сетевой мониторинг или публичный health endpoint; его нужно подключать и проверять отдельно.

Слова, которые пригодятся

Резервная копия
Отдельно сохранённые данные для восстановления. Её полезность проверяют открытием восстановленной копии и сверкой результата.
Восстановление
Возврат данных из копии в отдельное рабочее состояние. Здесь результат открывается через NOTES_DB_PATH без перезаписи исходной базы.
Код выхода
Число, с которым завершается команда: 0 означает успех, 1 в нашем CLI-скрипте — недоступность базы.

Копирование работающей SQLite может дать непоследовательный результат; в этом упражнении перед Copy-Item сервер остановлен. Копия в %TEMP% нужна лишь для этого опыта и не подходит для длительного хранения. Резервная копия хранится вне notes-php, а восстановление проверяется на новом файле data/notes-restored-check.sqlite, не поверх рабочей базы. PRAGMA integrity_check подтверждает внутреннюю целостность SQLite в этой копии, а сравнение числа строк — только этот конкретный набор данных.

Код выхода нужен автоматической проверке: 0 означает успех, ненулевой код — отказ. Наш check-health.php не печатает текст исключения, путь к файлу или секрет в ответе; но это только локальный CLI-сигнал. Настоящий мониторинг должен регулярно запускать проверку и сообщать человеку о сбое, что здесь не настроено.

Рабочий пример

<?php
// Полный файл notes-php/check-health.php
declare(strict_types=1);
try {
    $pdo = require __DIR__ . '/src/db.php';
    $pdo->query('SELECT 1 FROM notes LIMIT 1');
    echo 'OK: notes доступна', PHP_EOL;
    exit(0);
} catch (Throwable $e) {
    fwrite(STDERR, 'ERROR: notes недоступна' . PHP_EOL);
    exit(1);
}

Практика

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

  1. Остановите php -S, если сервер ещё работает. В Visual Studio Code в корне notes-php создайте check-health.php рядом с setup.php, вставьте полный пример и сохраните Ctrl+S. В PowerShell из корня выполните php -l check-health.php, php check-health.php, затем $LASTEXITCODE: ожидайте OK: notes доступна и 0.
  2. В том же терминале запишите число строк командой php -r '$p = require "src/db.php"; echo $p->query("SELECT COUNT(*) FROM notes")->fetchColumn(), PHP_EOL;'. Создайте отдельную папку командой $backup = Join-Path $env:TEMP ('notes-backup-' + [guid]::NewGuid().ToString('N').Substring(0,8)), New-Item -ItemType Directory -Path $backup; скопируйте закрытую базу Copy-Item -LiteralPath data/notes.sqlite -Destination (Join-Path $backup 'notes.sqlite'). Для пробного восстановления выполните Copy-Item -LiteralPath (Join-Path $backup 'notes.sqlite') -Destination data/notes-restored-check.sqlite, задайте $env:NOTES_DB_PATH = (Resolve-Path -LiteralPath data/notes-restored-check.sqlite).Path, затем php check-health.php и php -r '$p = require "src/db.php"; echo $p->query("PRAGMA integrity_check")->fetchColumn(), " ", $p->query("SELECT COUNT(*) FROM notes")->fetchColumn(), PHP_EOL;'. Ожидайте ok и исходное число строк. Удалите переменную Remove-Item Env:NOTES_DB_PATH.
  3. Для ошибки задайте $env:NOTES_DB_PATH = Join-Path (Get-Location) 'data/missing-health.sqlite', выполните php check-health.php, затем $LASTEXITCODE: ожидайте ERROR: notes недоступна и 1, без нового файла базы. Выполните Remove-Item Env:NOTES_DB_PATH. В панели файлов Visual Studio Code в корне создайте recovery-check.md и запишите только имя папки резервной копии без личного абсолютного пути, число строк до/после, integrity_check=ok, оба кода выхода и дату опыта; не записывайте пароли или токены. Сохраните Ctrl+S.

Как проверить себя

Восстановленная копия проходит integrity_check=ok и содержит столько же строк, сколько исходная; CLI-проверка возвращает 0 для доступной базы и 1 для отсутствующей, без раскрытия её пути в сообщении.

Если не получилось
  • Copy-Item сообщает, что файла нет? Проверьте data/notes.sqlite и выполните команды README по подготовке базы.
  • integrity_check не вернул ok? Не объявляйте копию пригодной; проверьте, что сервер был остановлен до копирования, и повторите опыт с новой копией.
  • После проверки все команды продолжают использовать восстановленную базу? Выполните Remove-Item Env:NOTES_DB_PATH и проверьте обычный php check-health.php.