PHPTime

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 не отвечает, задачи всё равно нужно двигать. Правило одно: всё, что сделано, должно быть закоммичено, чтобы изменения не висели в рабочей копии и не потерялись при переключении веток.

Базовый цикл без сети

Shell
# состояние рабочей копии и локальных веток
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 подойдёт формат писем:

Shell
# выгрузить коммиты в файл-патч и передать коллеге любым каналом
git format-patch main..feature/refund-policy -o /tmp/patches

# на стороне коллеги применить патч и сохранить авторство
git am /tmp/patches/*.patch

Резервный remote: готовим второй путь заранее

Самое дешёвое решение — иметь второй удалённый репозиторий, который не зависит от GitHub. Это может быть зеркало на другом хостинге, собственный сервер с git или bare-репозиторий на сетевом диске. Главное — добавить его как remote заранее и хотя бы изредка пушить.

Shell
# один раз: добавить резервный 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:

Shell
# временно работать через резервный 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 или новому разработчику, когда основной хостинг недоступен.

Shell
# создать зеркало существующего репозитория на локальном сервере
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 — он хранит скачанные архивы и метаданные. Проверить и направить кеш можно так:

Shell
# где 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 это настраивается так:

JSON
{
  "repositories": [
    { "type": "composer", "url": "https://composer.internal.example" },
    { "packagist.org": false }
  ]
}

Отключение публичного Packagist заставляет Composer не ходить наружу вообще. Минус — новые пакеты не появятся, пока прокси их не подтянет, но зато сборка предсказуема и не зависит от чужого аптайма.

Строгая типизация и проверки без сети

Пока внешние сервисы недоступны, самое время навести порядок в коде и пройтись по типам. Начиная с PHP 8.3 доступны типизированные константы классов, а в 8.4–8.5 язык продолжает ужесточать работу с типами: property hooks, асимметричная видимость, улучшения в перечислениях. Практический минимум для нового кода:

PHP
<?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 всё равно недоступны.

Локально можно запустить статический анализатор и тесты — они работают офлайн, если правила и зависимости уже установлены:

Shell
# статический анализ и тесты из локального vendor
test -x vendor/bin/phpstan && vendor/bin/phpstan analyse --no-progress
vendor/bin/phpunit --colors=never

Сравнение каналов на случай сбоя

Держите таблицу под рукой: она помогает быстро вспомнить, что делать в первые минуты.

КаналЧто даётОграниченияКогда включать
Локальный gitПолная история, коммиты, ветки, rebaseНет обмена между разработчикамиСразу
Патчи через git format-patchПередача коммитов любым каналомРучной процесс, легко забыть патчКогда нужно слить чужую работу
Резервный remotePush/pull и общий репозиторийНужен настроенный серверПока GitHub недоступен
ЗеркалоКопия истории для CI и новых клоновТребует регулярного обновленияДля сборки и деплоя
Кеш ComposerУстановка уже скачанных пакетовНет новых версий, кеш локальныйcomposer install офлайн

Итог: чек-лист на случай недоступности GitHub

  1. Подтвердить, что проблема на стороне GitHub, а не в локальной сети; не тратить время на «переустановку git».
  2. Закоммитить всё незакоммиченное, проверить git status и git branch -vv.
  3. Продолжать работу в локальных ветках; для обмена с коллегами использовать патчи или внутренний чат.
  4. Переключить push на резервный remote, если он настроен; иначе договориться о едином временном канале.
  5. Собирать зависимости только по composer.lock через composer install, не запускать composer update.
  6. Использовать локальный кеш Composer или внутренний прокси-репозиторий; при пустом кеше — ждать восстановления, а не менять версии вслепую.
  7. CI запускать на уже склонированном репозитории или из зеркала, а не с чистого раннера, которому нужен GitHub.
  8. Прогнать офлайн-проверки: PHPUnit, PHPStan, линтеры; заодно вычистить устаревшие вызовы вроде mysql_* и create_function.
  9. После восстановления 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 и периодически отправлять туда ветки и теги.

Справка по теме

Ещё в разделе «Инструменты и библиотеки»

Push-уведомления в Chrome и Safari: настройка Web Push на PHP

Как настроить Web Push в Chrome и Safari на PHP 8.3–8.5: запросить разрешение, сохранить подписку, отправить уведомление и обработать ошибки доставки.

8 мин

Не работает GitHub: как настроить прокси для Git и Composer

Что делать, если GitHub не открывается, git clone зависает, а Composer не скачивает пакеты. Настройка HTTP-прокси, SSH ProxyCommand и зеркала Packagist.

7 мин

PHPOffice в PHP: Excel, Word и PowerPoint на практике

Как читать Excel и генерировать XLSX, DOCX и PPTX в PHP 8.3–8.5. Примеры PHPOffice, работа с шаблонами, формулами, типами ячеек и памятью.

7 мин

Какой PHP-фреймворк выбрать для среднего проекта в 2026 году

Сравниваем Laravel, Symfony, Yii 2, Yii 3 и Slim для среднего PHP-проекта: база данных, очереди, тесты, обновления и выбор под задачи команды.

6 мин