Конфигурация и окружения
Поиск работает в локальной SQLite. Проверим тот же код на отдельной копии базы, не подменяя рабочие данные.
Разберём по шагам
Окружение — код вместе с настройками и данными, на которых он запущен. Сейчас src/db.php всегда открывает data/notes.sqlite, поэтому тестовый запуск легко спутать с рабочим. Добавим необязательную переменную окружения NOTES_DB_PATH: когда она не задана, путь останется прежним. SQLite не использует DB_HOST и пароль, поэтому такие поля для этого проекта были бы ложной конфигурацией. Тестовая копия докажет разделение данных; публичный сервер этим опытом не проверяется.
Слова, которые пригодятся
- Окружение
- Условия запуска: код, настройки, расширения PHP и данные. Один и тот же
public/index.phpможет открыть разные SQLite-файлы при разных значенияхNOTES_DB_PATH. - Переменная окружения
- Именованное значение, которое терминал передаёт запущенной программе.
NOTES_DB_PATHуказывает, какой локальный SQLite-файл открыть, и не записывается в код. - Резервная копия
- Отдельная сохранённая версия данных для восстановления после сбоя. Копию надо проверить открытием до того, как рассчитывать на неё при возврате.
Переменная окружения передаётся процессу терминалом, а не читается из Git. getenv возвращает строку или false; пустое значение тоже ведёт к обычному data/notes.sqlite. is_file защищает от неявного создания новой пустой SQLite по ошибочному пути. config.example.ps1 хранит только учебный путь. Если позже появится другая база с паролем, секрет нужно будет хранить вне репозитория и отдельно продумать доступ, но сейчас в проекте его нет.
Копия data/notes-test.sqlite нужна только для локального опыта. Резервная копия и возврат при настоящей выкладке зависят от целевого сервера и требуют отдельной проверки восстановления. Успешный loopback-запрос не доказывает, что на публичном хосте доступны нужные расширения PHP, права на файл или верный путь.
Рабочий пример
<?php
// Полное содержимое notes-php/src/db.php
declare(strict_types=1);
$defaultDatabase = dirname(__DIR__) . '/data/notes.sqlite';
$chosenDatabase = getenv('NOTES_DB_PATH');
$database = $chosenDatabase !== false && $chosenDatabase !== ''
? $chosenDatabase
: $defaultDatabase;
if (!is_file($database)) {
throw new RuntimeException('База не найдена: проверьте NOTES_DB_PATH или выполните php setup.php');
}
return new PDO('sqlite:' . $database, null, null, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
Практика
Разведите рабочую и тестовую SQLite одним параметром, затем докажите числом строк, что проверочный POST не изменил исходную базу. Зафиксируйте проверяемый план выпуска без притворной публикации.
- В Visual Studio Code в
notes-phpоткройтеsrc/db.phpи полностью замените его примером. СохранитеCtrl+S, выполнитеphp -l src/db.php. Создайте в корнеconfig.example.ps1со строкой$env:NOTES_DB_PATH = Join-Path $PSScriptRoot 'data/notes.sqlite'; сохраните. Это пример пути без секрета. ВREADME.mdдобавьте: из корня PowerShell команда. .\config.example.ps1задаёт путь для текущего терминала,Remove-Item Env:NOTES_DB_PATHвозвращает путь по умолчанию. Для чистой копии сначала выполняются прежниеmkdir data,php setup.phpи миграция; переменная сама базу не создаёт. - Из корня
notes-phpвыполнитеCopy-Item -LiteralPath data/notes.sqlite -Destination data/notes-test.sqlite; второй файл остаётся вне Git по правилуdata/*.sqlite. В PowerShell задайте$env:NOTES_DB_PATH = (Resolve-Path -LiteralPath data/notes-test.sqlite).Path. Выполнитеphp -r '$pdo = require "src/db.php"; echo $pdo->query("SELECT COUNT(*) FROM notes")->fetchColumn(), PHP_EOL;'и запишите число. Запуститеphp -S localhost:8000 -t publicиз этого же терминала: дочерний сервер получит переменную. Во втором терминале отправьтеcurl.exe -i --data "title=TestEnv&body=Check" http://localhost:8000/и ожидайте303. Остановите серверCtrl+C; повторная команда подсчёта в первом терминале должна показать число на один больше. - В первом терминале выполните
Remove-Item Env:NOTES_DB_PATH, затем ту же команду подсчёта: рабочая база должна сохранить прежнее число. Для ошибки задайте$env:NOTES_DB_PATH = Join-Path (Get-Location) 'data/missing.sqlite'и выполнитеphp -r 'require "src/db.php";': ожидайте сообщение «База не найдена», новый SQLite-файл не должен возникнуть. Снова выполнитеRemove-Item Env:NOTES_DB_PATH. В Visual Studio Code создайтеrelease-plan.md: перед реальной выкладкой записать путь и резервную копию целевой базы вне публичной папки, подготовить предыдущую версию кода, применить нужные миграции, проверить GET/POST и при сбое вернуть код и данные из проверенной копии. Это план, не подтверждение выкладки. - В
README.mdзапишите результат с исходным и тестовым числами и ограничение «публичное окружение не проверено». Выполнитеgit status --short,git check-ignore -v data/notes-test.sqlite,git add -- src/db.php config.example.ps1 README.md release-plan.md,git diff --cached --checkи полныйgit diff --cached; в индексе не должно быть SQLite. Если состав ожидаем, выполнитеgit commit -m "Настроить путь к учебной базе"иgit status --short: ожидайте пустой вывод.
Как проверить себя
С переменной запись попала только в тестовую копию базы; после удаления переменной исходная база не изменилась. Отсутствующий путь дал явную ошибку без создания пустой базы. Пример настройки и план проверки/возврата не содержат пароля или утверждения о публичной выкладке.
Если не получилось
- Число в исходной базе выросло? Проверьте, что сервер запущен после установки
NOTES_DB_PATHи в том же терминале; остановите старый сервер перед опытом. База не найденапри тестовом запуске? Сначала создайте копиюdata/notes-test.sqlite, затем проверьте путь черезResolve-Path;setup.phpготовит обычную базу, а не путь из переменной.- После проверки всё ещё используется тестовая база? Выполните
Remove-Item Env:NOTES_DB_PATH, перезапустите сервер и снова сравните число строк.
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗