Резервные копии и наблюдение
Локальная 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 читается, а сбой подключения меняет код завершения проверки. Эти сигналы пригодятся для будущего мониторинга.
- Остановите
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. - В том же терминале запишите число строк командой
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. - Для ошибки задайте
$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.
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗