УРОК · Рабочий процесс разработчика

Конфигурация и окружения

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

Поиск работает в локальной 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 не изменил исходную базу. Зафиксируйте проверяемый план выпуска без притворной публикации.

  1. В 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 и миграция; переменная сама базу не создаёт.
  2. Из корня 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; повторная команда подсчёта в первом терминале должна показать число на один больше.
  3. В первом терминале выполните 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 и при сбое вернуть код и данные из проверенной копии. Это план, не подтверждение выкладки.
  4. В 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, перезапустите сервер и снова сравните число строк.