GitHub недоступен: как продолжать работу команде на PHP
Когда GitHub перестаёт отвечать, страдает не только веб-интерфейс: рвутся push и pull, падают джобы CI, а сборка зависимостей упирается в недоступный API. Ниже — рабочая схема, которая позволяет команде продолжать разработку на PHP 8.3–8.5 в такие часы без паники и потери коммитов.
Что реально ломается, а что продолжает работать
Первое, что стоит зафиксировать у себя в голове: git — распределённая система. У каждого разработчика уже есть полная копия истории с ветками и тегами. Пока GitHub лежит, нельзя обменяться изменениями через него, нельзя открыть PR и нельзя получить свежий код из origin, но локально всё работает: коммиты, ветки, слияния, git log, git bisect, переключение между задачами. Это принципиально отличает сбой хостинга от потери данных.
Ломаются вещи, завязанные на сеть:
git fetchиgit pushв сторону недоступного remote;- CI/CD, который клонирует репозиторий заново на чистом раннере;
composer install/update, если зависимости тянутся по сети, а не из локального кеша;- веб-хуки, авто-деплой, генерация релизов, проверки PR;
- внешние линтеры и статические анализаторы, которые скачивают правила из Сети.
Порядок действий простой: не паниковать, проверить, что проблема именно на стороне GitHub, зафиксировать локальные изменения коммитами, переключиться на резервный канал обмена и только потом заниматься CI и зависимостями.
Локальный git: как работать, когда remote недоступен
Пока сеть до GitHub не отвечает, задачи всё равно нужно двигать. Правило одно: всё, что сделано, должно быть закоммичено, чтобы изменения не висели в рабочей копии и не потерялись при переключении веток.
Базовый цикл без сети
# состояние рабочей копии и локальных веток
git status
git branch -vv
# фиксируем текущую работу, даже если она промежуточная
git add -A
git commit -m "wip: черновик сервиса платежей"
# создать ветку под новую задачу от текущего состояния
git switch -c feature/refund-policy
# при необходимости перебазировать на актуальную локальную main
git fetch --all --prune || echo "remote недоступен, работаем от локальной копии"
git rebase mainПолезные в офлайне команды: git diff --staged перед коммитом, git stash push -m для быстрой заморозки, git reflog для поиска потерянных коммитов после неудачных операций. Обратите внимание: git fetch в скрипте выше обёрнут в проверку — если remote лежит, команда завершится ошибкой, а работа продолжится от локальной копии.
Что делать с чужими изменениями
Если коллега успел запушить что-то до сбоя, но у вас этого нет — вы об этом не узнаете, пока GitHub не вернётся. Поэтому в такие часы договоритесь в командном чате, кто какие ветки трогает. Для обмена патчами между разработчиками без общего remote подойдёт формат писем:
# выгрузить коммиты в файл-патч и передать коллеге любым каналом
git format-patch main..feature/refund-policy -o /tmp/patches
# на стороне коллеги применить патч и сохранить авторство
git am /tmp/patches/*.patchРезервный remote: готовим второй путь заранее
Самое дешёвое решение — иметь второй удалённый репозиторий, который не зависит от GitHub. Это может быть зеркало на другом хостинге, собственный сервер с git или bare-репозиторий на сетевом диске. Главное — добавить его как remote заранее и хотя бы изредка пушить.
# один раз: добавить резервный remote
git remote add backup ssh://git@git.internal.example/project.git
# проверить список
git remote -v
# отправить все ветки и теги в резервный remote
git push backup --all
git push backup --tagsЕсли origin — это GitHub, а backup — внутренний сервер, то в момент сбоя достаточно переключить upstream:
# временно работать через резервный remote
git push backup feature/refund-policy
git branch --set-upstream-to=backup/main main
# когда GitHub вернётся — синхронизировать и вернуть upstream
git fetch backup --prune
git push origin main
git branch --set-upstream-to=origin/main mainДержите в голове маленький нюанс: если вы переключили upstream, а потом просто набрали git push, изменения уйдут в резервный remote, а не в GitHub. Явно указывайте remote в командах в этот период — меньше сюрпризов.
Зеркала репозиториев: что это и зачем
Зеркало (mirror) — это точная копия репозитория, включая все ветки, теги и ссылки, обычно в виде bare-репозитория без рабочей копии. Зеркала пригождаются по двум причинам: как горячий резерв для команды и как способ отдать код CI или новому разработчику, когда основной хостинг недоступен.
# создать зеркало существующего репозитория на локальном сервере
git clone --mirror git@github.com:acme/project.git /srv/git/project.git
# обновлять зеркало по расписанию (cron), источник — основной remote
git --git-dir=/srv/git/project.git remote update --prune
# отдать зеркало коллеге как обычный репозиторий
git clone ssh://git@git.internal.example/srv/git/project.git ./projectТонкость: git clone --mirror копирует и настройки remote, поэтому после переноса зеркала на другой сервер проверьте git remote -v внутри него. Для периодического обновления удобно использовать отдельный remote с именем upstream, указывающий на GitHub: так проще менять источник, не переписывая конфигурацию.
Зеркало — это не бэкап в полном смысле. Если кто-то force-push-нул историю в GitHub до сбоя, remote update может подтянуть и это. Настоящий бэкап — отдельные снапшоты с ретеншеном, а не живое зеркало.
Composer: как ставить зависимости без доступа к GitHub
Самая болезненная часть для PHP-команд: composer install в чистом окружении лезет за пакетами. Если пакеты уже стоят в vendor/, а composer.lock закоммичен, то установка часто проходит из локального кеша Composer — он хранит скачанные архивы и метаданные. Проверить и направить кеш можно так:
# где Composer хранит кеш
git --version >/dev/null; composer config cache-dir
# установка строго по lock-файлу, без обновления зависимостей
composer install --no-interaction --prefer-dist --no-progress
# если сеть недоступна и кеш пуст — явно работаем только из кеша
composer install --no-interaction --prefer-dist --no-progress --offline 2>/dev/null || \
echo "нет кеша: нужен внутренний прокси-репозиторий"Ключевое правило: в CI и на серверах никогда не запускайте composer update. Только composer install по зафиксированному composer.lock. Тогда набор версий детерминирован, а доступ к сети нужен лишь для скачивания архивов.
Внутренний прокси-репозиторий
Надёжнее кеша на каждой машине — свой Composer-репозиторий (например, сатис или аналог), который кеширует пакеты с Packagist и GitHub. Тогда даже при недоступности GitHub установка идёт с внутреннего хоста. В composer.json это настраивается так:
{
"repositories": [
{ "type": "composer", "url": "https://composer.internal.example" },
{ "packagist.org": false }
]
}Отключение публичного Packagist заставляет Composer не ходить наружу вообще. Минус — новые пакеты не появятся, пока прокси их не подтянет, но зато сборка предсказуема и не зависит от чужого аптайма.
Строгая типизация и проверки без сети
Пока внешние сервисы недоступны, самое время навести порядок в коде и пройтись по типам. Начиная с PHP 8.3 доступны типизированные константы классов, а в 8.4–8.5 язык продолжает ужесточать работу с типами: property hooks, асимметричная видимость, улучшения в перечислениях. Практический минимум для нового кода:
<?php
declare(strict_types=1);
enum RefundStatus: string
{
case Pending = 'pending';
case Approved = 'approved';
case Rejected = 'rejected';
}
final readonly class Refund
{
public function __construct(
public int $orderId,
public int $amountMinor,
public RefundStatus $status = RefundStatus::Pending,
) {}
}
// Проверка без внешних сервисов: имена и типы аргументов видны статически.
function approve(Refund $refund): Refund
{
return new Refund($refund->orderId, $refund->amountMinor, RefundStatus::Approved);
}Раньше в таких местах писали create_function, использовали mysql_* и ereg — сегодня это не просто устаревшее, а несовместимое с современными версиями. Замена очевидна: замыкания вместо create_function, PDO или mysqli с подготовленными выражениями вместо mysql_*, preg_match вместо ereg. Если в проекте остались такие вызовы, сбой внешней инфраструктуры — хороший повод вычистить их, пока CI и PR всё равно недоступны.
Локально можно запустить статический анализатор и тесты — они работают офлайн, если правила и зависимости уже установлены:
# статический анализ и тесты из локального vendor
test -x vendor/bin/phpstan && vendor/bin/phpstan analyse --no-progress
vendor/bin/phpunit --colors=neverСравнение каналов на случай сбоя
Держите таблицу под рукой: она помогает быстро вспомнить, что делать в первые минуты.
| Канал | Что даёт | Ограничения | Когда включать |
|---|---|---|---|
| Локальный git | Полная история, коммиты, ветки, rebase | Нет обмена между разработчиками | Сразу |
Патчи через git format-patch | Передача коммитов любым каналом | Ручной процесс, легко забыть патч | Когда нужно слить чужую работу |
| Резервный remote | Push/pull и общий репозиторий | Нужен настроенный сервер | Пока GitHub недоступен |
| Зеркало | Копия истории для CI и новых клонов | Требует регулярного обновления | Для сборки и деплоя |
| Кеш Composer | Установка уже скачанных пакетов | Нет новых версий, кеш локальный | composer install офлайн |
Итог: чек-лист на случай недоступности GitHub
- Подтвердить, что проблема на стороне GitHub, а не в локальной сети; не тратить время на «переустановку git».
- Закоммитить всё незакоммиченное, проверить
git statusиgit branch -vv. - Продолжать работу в локальных ветках; для обмена с коллегами использовать патчи или внутренний чат.
- Переключить push на резервный remote, если он настроен; иначе договориться о едином временном канале.
- Собирать зависимости только по
composer.lockчерезcomposer install, не запускатьcomposer update. - Использовать локальный кеш Composer или внутренний прокси-репозиторий; при пустом кеше — ждать восстановления, а не менять версии вслепую.
- CI запускать на уже склонированном репозитории или из зеркала, а не с чистого раннера, которому нужен GitHub.
- Прогнать офлайн-проверки: PHPUnit, PHPStan, линтеры; заодно вычистить устаревшие вызовы вроде
mysql_*иcreate_function. - После восстановления GitHub вернуть upstream на
origin, синхронизировать ветки с резервным remote и проверить, что push ушёл туда, куда нужно.
Главное — не превращать сбой хостинга в простой команды. Распределённый git, второй remote и дисциплина с composer.lock закрывают почти весь риск.
Частые вопросы
Можно ли продолжать коммитить, если GitHub недоступен?
Да. Git распределённый: у вас локально есть вся история и ветки. Коммиты, переключения и слияния работают без сети, недоступен только обмен через GitHub.
Что делать, если composer install не проходит без GitHub?
Устанавливайте строго по composer.lock командой composer install: Composer возьмёт уже скачанные архивы из локального кеша. Если кеша нет, нужен внутренний прокси-репозиторий или ожидание восстановления — не меняйте версии через composer update.
Зачем нужен второй remote, если уже есть GitHub?
Он даёт канал push и pull, когда основной хостинг недоступен. Достаточно добавить внутренний сервер или другой хостинг как резервный remote и периодически отправлять туда ветки и теги.