УРОК · Git перед первым проектом

Репозиторий и файлы вне истории

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

После SQLite4 в notes-php уже есть код и три файла базы. Сохраним историю кода, оставив локальные данные вне первого коммита.

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

Git сохраняет версии выбранных файлов проекта. Сейчас в notes-php есть public, src, четыре CLI-скрипта и папка data с рабочей, резервной и восстановленной базами. Создадим репозиторий в корне notes-php, чтобы в историю мог попасть код из всех этих папок. Файлы базы останутся на диске, но будут скрыты от добавления правилом .gitignore.

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

Репозиторий
Папка проекта вместе с историей его файлов в служебной папке .git. Для этого упражнения репозиторием станет весь notes-php, а не только public.
Неотслеживаемый файл
Новый файл внутри репозитория, который ещё не выбран для истории. Например, до первого git add команда git status покажет setup.php как новый.
Игнорируемый файл
Файл, для которого действует правило исключения. data/notes.sqlite остаётся на диске, но обычный git add . не подготовит его к коммиту.
.gitignore
Файл с правилами исключения новых локальных файлов. Строка data/*.sqlite покрывает файлы SQLite непосредственно в папке data.

Если Git ещё не установлен на Windows, откройте официальную страницу «Git for Windows» из ресурсов, скачайте установщик для вашей архитектуры и завершите его установку. Откройте Visual Studio Code заново: новая команда должна появиться в новом терминале. git init создаёт служебную папку .git; команда git rev-parse --show-toplevel подтверждает, где начинается репозиторий. Внутри public его создавать нельзя: тогда setup.php, src и другие файлы проекта окажутся за пределами истории.

Новый файл, который ещё не добавляли, виден в git status как неотслеживаемый. Игнорируемый файл тоже остаётся на диске, но правило .gitignore не предлагает его к обычному git add. В примере data/*.sqlite покрывает все три результата SQLite4, а .env и .env.local — только эти два имени локальных настроек; другие файлы с секретами проверяйте отдельно перед добавлением. vendor/ и node_modules/ пригодятся позже для устанавливаемых зависимостей. Правила не удаляют файлы и не исключают уже отслеживаемые записи.

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

.env
.env.local
data/*.sqlite
vendor/
node_modules/

Что здесь происходит

  • Каждая строка примера — отдельное правило файла .gitignore, а не команда терминала.
  • data/*.sqlite исключает рабочую, резервную и восстановленную базы из SQLite4.
  • .env и .env.local исключают два распространённых имени локальных настроек. vendor/ и node_modules/ оставляют устанавливаемые зависимости вне истории; команды их установки появятся позже.

Практика

Вы увидите, что Git готов сохранить исходники проекта, но не три файла SQLite из прошлого урока. Это подготовит безопасный состав первого коммита.

  1. В Visual Studio Code откройте папку notes-php после SQLite4 через Файл → Открыть папку, затем откройте Терминал → Создать терминал. Выполните git --version. Если команда не найдена, установите Git for Windows по ссылке ниже, закройте и снова откройте редактор и терминал, повторите git --version. Из корня notes-php выполните git init и git rev-parse --show-toplevel: последний путь должен оканчиваться на notes-php.
  2. В панели файлов Visual Studio Code создайте в корне notes-php файл .gitignore рядом с setup.php. Вставьте пять строк из примера, сохраните Ctrl+S. Не переносите и не удаляйте data/notes.sqlite, data/notes-before-created-at.sqlite или data/notes-restored.sqlite.
  3. В терминале выполните git status, затем git check-ignore -v data/notes.sqlite data/notes-before-created-at.sqlite data/notes-restored.sqlite. Ожидайте три строки с правилом data/*.sqlite. В git status исходники и .gitignore видны как новые файлы, а база не предложена к добавлению.

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

Корень репозитория — notes-php; git check-ignore -v объясняет исключение всех трёх файлов SQLite. git status показывает новые исходники, но не предлагает эти базы к коммиту.

Если не получилось
  • git rev-parse --show-toplevel заканчивается на public? Остановитесь: репозиторий создан внутри публичной папки, до добавления файлов вернитесь к корню notes-php и исправьте место инициализации.
  • git check-ignore ничего не вывел? Проверьте, что файл называется именно .gitignore, правило data/*.sqlite записано отдельной строкой и три файла лежат в notes-php/data.

Куда заглянуть дальше