Поиск
Ошибки

Composer: The process "…" exceeded the timeout of 300 seconds — команда не уложилась в 5 минут

Composer ждёт каждую программу, которую запускает, — git, unzip, скрипт из composer.json — не дольше 300 секунд, то есть 5 минут. Если она работает дольше, Composer её останавливает и пишет эту ошибку. Запустите ту же команду с лимитом побольше: COMPOSER_PROCESS_TIMEOUT=900 composer install.

≈ 5 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Посмотрите, какая команда стоит в кавычках после The process: git, unzip или скрипт проекта.
  2. Запустите ту же команду Composer с лимитом 15 минут: COMPOSER_PROCESS_TIMEOUT=900 composer install — вместо install ваша команда.
  3. Если ошибка повторяется на каждом запуске, задайте лимит в настройках проекта — как это сделать.

Как выглядит ошибка

The following exception is caused by a process timeout
Check https://getcomposer.org/doc/06-config.md#process-timeout for details

  The process "…" exceeded the timeout of 300 seconds.

Первые две строки — подсказка Composer: «ошибка ниже вызвана тайм-аутом процесса, подробности по ссылке». Третья — сама ошибка: «процесс "…" превысил лимит времени 300 секунд». В кавычках — команда, которую запускал Composer, 300 — лимит в секундах.

Composer остановил эту команду и остановился сам. Когда поднимете лимит, запустите ту же команду Composer снова.

Что Composer ждёт 5 минут

Лимит касается программ, которые Composer запускает отдельно. Какая из них не уложилась, видно по команде в кавычках:

Что в кавычкахЧто этоПочему долго
команда со словом gitComposer качает библиотеку через gitбольшой репозиторий или медленная сеть — разбор ниже
команда со словом unzipраспаковка архива библиотекибольшой архив или медленный диск
команда из раздела scripts в composer.json — например, php artisan … или npm run buildскрипт проектаскрипт делает долгую работу: собирает файлы сайта, меняет базу — разбор ниже

Как поднять лимит на один запуск

Переменная перед командой действует только на этот запуск:

COMPOSER_PROCESS_TIMEOUT=900 composer install

900 — 15 минут. 0 — без лимита.

Если запускаете скрипт командой composer run-script, лимит задаётся ключом --timeout:

composer run-script --timeout=900 build

Здесь build — пример имени скрипта из раздела scripts. Если после --timeout= стоит не число, Composer ответит Timeout value must be numeric and positive if defined, or 0 for forever — «лимит должен быть положительным числом или 0».

Без лимита зависшую команду Composer будет ждать, пока её не остановят. Остановить можно клавишами Ctrl+C.

Как задать лимит для проекта

Если ошибка повторяется на каждом запуске, запишите лимит в настройки проекта. В папке проекта выполните:

composer config process-timeout 900

Команда запишет лимит в composer.json, в раздел config:

"config": {
    "process-timeout": 900
}

Теперь лимит действует при каждом запуске Composer в этой папке. Чтобы задать его для всех проектов вашего пользователя, добавьте ключ --global:

composer config --global process-timeout 900

Если задана и переменная COMPOSER_PROCESS_TIMEOUT, и настройка, Composer берёт переменную.

Если скрипт работает долго

Если скрипту проекта нужно больше 5 минут — например, он собирает файлы сайта, — выключите лимит в самом скрипте. В composer.json, в разделе scripts, поставьте первой строкой Composer\\Config::disableProcessTimeout:

"scripts": {
    "build": [
        "Composer\\Config::disableProcessTimeout",
        "npm run build"
    ]
}

Здесь build и npm run build — пример. Две обратные черты — так обратная черта пишется в JSON. Когда Composer дойдёт до этой строки, он выключит лимит до конца этого запуска.

Если скрипт завершился сам, но с ошибкой, — это другая ошибка: Script … returned with error code.

Если Composer качает библиотеки через git

Если в выводе Composer есть строки Cloning … или Syncing … into cache, он берёт библиотеки через git, а не архивами zip. Git качает репозиторий вместе с историей, и это дольше.

Так бывает:

  • нечем распаковать архивы — нет программы unzip и модуля PHP zip. Тогда Composer пишет Now trying to download from source и идёт в git: что поставить;
  • Composer запустили с ключом --prefer-source — уберите его: без ключа Composer берёт архивы.

Ошибки и как их исправить

Что видитеПричинаЧто делать
The following exception is caused by a process timeoutпрограмма, которую запустил Composer, работала дольше лимитаподнимите лимит
exceeded the timeout of 300 secondsлимит по умолчанию — 5 минутCOMPOSER_PROCESS_TIMEOUT=900
в кавычках команда со словом gitбиблиотека качается через gitпроверьте unzip и модуль zip
в кавычках команда из scriptsдолгий скрипт проектавыключите лимит в скрипте
ошибка повторяется на каждом запускелимита мало для этого проектазадайте лимит для проекта
Timeout value must be numeric and positive if defined, or 0 for foreverпосле --timeout= не числоукажите число секунд, например --timeout=900
Script … returned with error codeскрипт завершился с ошибкойРазбор

Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше