Как безопасно обновлять Laravel и Composer-зависимости
Обновление Laravel — не кнопка «поставить последнюю версию». Между рабочим приложением и новым релизом находятся PHP, пакеты, конфигурация, собственный код и реальные данные. Безопасный процесс уменьшает риск, а не добавляет формальности.
Зафиксируйте точку, с которой начинаете
Перед обновлением сохраните текущее состояние: composer.lock, версию PHP, настройки окружения и список критичных сценариев. Если уже есть ошибки или нестабильные фоновые задачи, их лучше отделить от обновления — иначе будет невозможно понять причину проблемы.
Полезно проверить, воспроизводится ли сборка проекта на чистом окружении. Это сразу показывает скрытые системные зависимости.
Читайте изменения по маршруту, а не только финальную версию
При переходе через несколько поколений фреймворка важны несовместимые изменения каждого шага. Они могут касаться middleware, конфигурации, типов, очередей, валидации, пакетов и поведения базы данных.
Список изменений превращают в задачи: заменить устаревший API, обновить конфиг, проверить пакет или переписать отдельный участок. Так обновление становится контролируемой работой, а не серией случайных исправлений.
Обновляйте в изолированном контуре
Сначала изменения проходят локально или на staging: обновляются зависимости, запускаются тесты, проверяются ключевые сценарии и фоновые процессы. В production не должны впервые выясняться совместимость пакета, миграции или настройка очереди.
Если проект большой, переход разумно разделить: сначала подготовить код и окружение, затем обновить фреймворк, после — зависимые пакеты и инфраструктуру.
Проверяйте не только страницы
После обновления нужно пройти вход, платежи, создание данных, API, отправку писем, очередь и scheduler — именно эти части чаще всего не видны на первом экране приложения. После деплоя помогают логи и мониторинг, чтобы заметить проблему в первые минуты, а не после обращения клиента.
Когда нужна помощь
Если нет понятной карты зависимостей или обновление затрагивает действующий продукт, начните с диагностики в рамках поддержки Laravel-проекта. Сначала определяется безопасный маршрут, затем — объём и порядок работ.