Інструменти веб-розробника. Git
Що ви дізнаєтесь
- Чому «у мене на комп'ютері все працює» — не аргумент, і як це лікують інструменти
- Як Git зберігає історію змін і як отримати проєкт із репозиторію
- Що записують у
.gitignoreі як увійти в GitHub, щоб працювавgit push
Модуль 2 складається з трьох лекцій: ця — про Git, «Docker і Docker Compose» — про контейнери, «Шлях запиту, шляхи до файлів і IDE» — про те, як усе це працює разом. Після них — практика, на якій ви розгорнете середовище.
Навіщо бекендеру інструменти
У модулі 1 ми бачили, що сторінку формує сервер: запит проходить через вебсервер, потім виконується PHP-код, і лише результат повертається в браузер (див. «На сервері й у браузері: nginx, PHP і рендер»). Отже, щоб писати бекенд, на вашому комп'ютері має працювати маленький сервер.
Встановлювати nginx і PHP вручну на Windows, macOS і Linux — довго, і в кожного вийде трохи по-різному: різні версії PHP, різні розширення, різні налаштування. Тому розробники використовують три інструменти:
| Інструмент | Яку проблему розв'язує |
|---|---|
| Git | Зберігає історію змін коду, дозволяє отримати проєкт одною командою і здати роботу |
| Docker Compose | Запускає однакове серверне оточення (nginx + PHP 8.4) на будь-якому комп'ютері |
| IDE | Зручно редагувати код, підказує помилки, має вбудований термінал |
Примітка
Усі три інструменти — стандарт індустрії. Саме так влаштовані робочі місця розробників у компаніях: код у Git, сервіси в контейнерах, редагування в IDE.
Git: історія змін проєкту
Git — система контролю версій. Вона запам'ятовує стан файлів проєкту в певні моменти часу. Такий збережений стан називається комітом (commit). Папка проєкту разом з усією історією комітів — це репозиторій.
Репозиторій може жити на вашому комп'ютері (локальний) і на сервері, наприклад GitHub чи GitLab (віддалений, remote). Команди Git переносять зміни між ними.
flowchart LR W["Робоча папка"] -->|git add| S["Індекс (staging)"] S -->|git commit| L["Локальний репозиторій"] L -->|git push| R["Віддалений репозиторій (GitHub)"] R -->|git clone / git pull| W
Важливо розрізняти Git і GitHub. Git — це програма на вашому комп'ютері, яка веде історію. GitHub (як і GitLab чи Bitbucket) — вебсервіс, де зберігаються віддалені репозиторії, щоб ними можна було ділитися. Git чудово працює і без GitHub, але саме віддалений репозиторій дозволяє викладачу роздати стартовий проєкт, а вам — здати роботу.
На нашому курсі стартові файли середовища (docker-compose.yml, конфігурацію nginx і Dockerfile) ви скачаєте архівом, розпакуєте й зробите з папки власний репозиторій командою git init. Потім створите для нього порожній репозиторій на GitHub — туди git push і відправлятиме вашу роботу. git clone знадобиться, коли треба забрати вже наявний репозиторій, наприклад свій проєкт на іншому комп'ютері.
Перше налаштування
Git має знати, хто автор комітів. Це робиться один раз на комп'ютері:
git config --global user.name "Олена Петренко"
git config --global user.email "olena@example.com"
Основні команди
git clone https://github.com/<організація>/<репозиторій>.git # отримати копію проєкту
git status # що змінилося з останнього коміту
git add src/public/index.php # додати файл до наступного коміту
git add . # додати всі змінені файли
git commit -m "Додав сторінку about" # зберегти знімок
git log --oneline # подивитися історію
git push # відправити коміти на сервер
git pull # забрати нові коміти з сервера
Типовий вивід git status після редагування файлу:
On branch main
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
modified: src/public/index.php
no changes added to commit (use "git add" and/or "git commit -a")
Порада
Пишіть повідомлення комітів так, щоб через тиждень було зрозуміло, що змінилося: «Додав форму входу» замість «fix» чи «123».
Файл .gitignore у корені проєкту перелічує те, що не треба зберігати в Git: локальні налаштування (.env), папки IDE (.idea/, .vscode/), логи, залежності (vendor/).
Вхід у GitHub
Щоб git push міг записати коміти у ваш репозиторій, GitHub має знати, що це саме ви. Пароль від акаунта GitHub тут не підходить: з 13 серпня 2021 року GitHub не приймає його для команд Git. Пароль потрібен лише для входу на сайт. Для Git працюють три види «ключів»: вхід через браузер (OAuth), токен доступу або SSH-ключ. Налаштувати це треба один раз на комп'ютері. Виберіть один спосіб:
- Windows: Git Credential Manager. Він встановлюється разом із Git for Windows. Під час першого
git pushвідкриється вікно входу в GitHub: натисніть Sign in with your browser, увійдіть на сайті й підтвердьте доступ. Git запам'ятає вхід, і наступніpushпройдуть без запитань. - GitHub CLI (будь-яка ОС). Встановіть програму
ghз cli.github.com і виконайтеgh auth login. На запитання дайте відповіді GitHub.com → HTTPS → Yes (увійти в Git з обліковими даними GitHub) → Login with a web browser. Потім введіть у браузері одноразовий код із термінала. Перевірити вхід можна командоюgh auth status: вона має вивестиLogged in to github.com account <ваш-логін>. - Через IDE. У VS Code: іконка Accounts унизу бічної панелі → Sign in with GitHub (VS Code і сам запропонує вхід під час першого Push із панелі Git). У PhpStorm: Settings → Version Control → GitHub →
+→ Log In via GitHub…. Після входу надсилайте коміти кнопкою Push в IDE.
Альтернатива: токен доступу (personal access token). Це довгий рядок, який вводять замість пароля, коли Git запитує Password. На GitHub: Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. У Repository access виберіть Only select repositories і лише свій репозиторій (intita-php), у Permissions дайте Contents: Read and write, задайте термін дії. GitHub покаже токен один раз: скопіюйте його одразу і нікому не передавайте, бо це такий самий ключ до репозиторію, як пароль.
Досвідчені розробники часто використовують SSH-ключі: тоді адреса репозиторію має вигляд git@github.com:<логін>/<репозиторій>.git, і пароль не потрібен узагалі. Для курсу вистачить одного зі способів вище. Про SSH можна прочитати в документації GitHub.
Увага
Якщо на git push ви ввели пароль від GitHub, побачите:
remote: Support for password authentication was removed on August 13, 2021.
fatal: Authentication failed for 'https://github.com/<ваш-логін>/intita-php.git/'
Це не помилка в команді: GitHub відхилив пароль. Увійдіть одним зі способів вище (або вставте токен замість пароля) і повторіть git push.
Інтерфейси GitHub і IDE час від часу змінюються. Якщо кнопки називаються інакше, дивіться актуальні інструкції: кешування облікових даних для Git, токени доступу, gh auth login.
Документація: git-scm.com/book/uk.
Підсумок
- Git зберігає історію проєкту:
clone→ редагування →add→commit→push. Дляpushна GitHub потрібен вхід через браузер (Git Credential Manager,gh auth login, IDE) або токен, а не пароль. - Файл
.gitignoreперелічує те, що не потрапляє в репозиторій:.env, папки IDE,vendor/. - Docker Compose дає однакове середовище, IDE — зручне редагування і термінал. Їх розберемо в наступних лекціях модуля.
Що далі
Наступна лекція — «Docker і Docker Compose».