Composer: The process "…" exceeded the timeout of 300 seconds — команда не уложилась в 5 минут
Composer ждёт каждую программу, которую запускает, — git, unzip, скрипт из composer.json — не дольше 300 секунд, то есть 5 минут. Если она работает дольше, Composer её останавливает и пишет эту ошибку. Запустите ту же команду с лимитом побольше: COMPOSER_PROCESS_TIMEOUT=900 composer install.
Содержание 10
Что сделать прямо сейчас
- Посмотрите, какая команда стоит в кавычках после
The process: git, unzip или скрипт проекта. - Запустите ту же команду Composer с лимитом 15 минут:
COMPOSER_PROCESS_TIMEOUT=900 composer install— вместоinstallваша команда. - Если ошибка повторяется на каждом запуске, задайте лимит в настройках проекта — как это сделать.
Как выглядит ошибка
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 запускает отдельно. Какая из них не уложилась, видно по команде в кавычках:
| Что в кавычках | Что это | Почему долго |
|---|---|---|
команда со словом git | Composer качает библиотеку через git | большой репозиторий или медленная сеть — разбор ниже |
команда со словом unzip | распаковка архива библиотеки | большой архив или медленный диск |
команда из раздела scripts в composer.json — например, php artisan … или npm run build | скрипт проекта | скрипт делает долгую работу: собирает файлы сайта, меняет базу — разбор ниже |
Как поднять лимит на один запуск
Переменная перед командой действует только на этот запуск:
COMPOSER_PROCESS_TIMEOUT=900 composer install900 — 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.
Источники
- Исходный код Composer 2.7.1 — на английском: лимит 300 секунд в Util/ProcessExecutor.php и Config.php, подсказка в Console/Application.php, ключ --timeout в Command/RunScriptCommand.php.
- Исходный код Symfony Process 6.4 — на английском: текст ошибки в Exception/ProcessTimedOutException.php.
- Настройки Composer — на английском: настройка process-timeout.
- Скрипты Composer — на английском: раздел Managing the process timeout.
- Команды Composer — на английском: run-script --timeout и переменная COMPOSER_PROCESS_TIMEOUT.
Сверено 13 ноября 2026 года.
Что почитать дальше
- The zip extension and unzip/7z commands are both missingесли Composer качает библиотеки через git.
- Script … returned with error codeесли скрипт из composer.json завершился с ошибкой.
- Ошибки Composerвсе ошибки Composer на одной странице.