Composer: Script … handling the … event returned with error code — скрипт проекта завершился с ошибкой
После установки библиотек Composer запускает команды из раздела scripts в composer.json — например, php artisan package:discover в Laravel. Одна из них завершилась с ошибкой, и Composer пишет её код выхода. Сама причина — в строках над этим сообщением: это ошибка команды, а не Composer. Запустите команду отдельно, прочитайте её сообщение и исправьте.
Содержание 12
- Что сделать прямо сейчас
- Как выглядит ошибка
- Что такое скрипты Composer
- Где настоящая причина
- Как запустить команду отдельно
- Если скрипту не хватило памяти
- Если пишет terminated with an exception
- Если Composer пишет про класс или скрипт
- Если нужно поставить библиотеки без скриптов
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Прокрутите вывод вверх: над строкой
Script … returned with error code— сообщение самой команды. - Запустите ту же команду отдельно, в папке проекта, — как это сделать.
- Исправьте ошибку по её тексту — что бывает выше — и запустите Composer снова.
Как выглядит ошибка
> @php artisan package:discover --ansi
…
Script @php artisan package:discover --ansi handling the post-autoload-dump event returned with error code 1Первая строка — Composer показывает, какую команду запускает: строки со знаком > — это команды из composer.json. Ниже, на месте многоточия, — что вывела сама команда. Последняя строка — «скрипт @php artisan package:discover --ansi, запущенный на событие post-autoload-dump, завершился с кодом ошибки 1».
Код ошибки — число, которое вернула команда. 1 — общий код «что-то пошло не так», подробности — в строках выше. Composer останавливается и сам завершается с тем же кодом.
Что такое скрипты Composer
В composer.json есть раздел scripts — команды, которые Composer запускает сам, когда наступает событие:
| Событие | Когда наступает |
|---|---|
post-autoload-dump | после того, как Composer собрал автозагрузку классов: при composer install, composer update и composer dump-autoload |
pre-install-cmd, post-install-cmd | до и после composer install, когда есть composer.lock |
pre-update-cmd, post-update-cmd | до и после composer update или composer install без composer.lock |
post-root-package-install, post-create-project-cmd | при создании проекта командой composer create-project |
Пример раздела:
"scripts": {
"post-autoload-dump": [
"@php artisan package:discover --ansi"
]
}Как Composer понимает строки в списке:
| Строка | Что Composer делает |
|---|---|
@php … | запускает PHP с файлом проекта и передаёт ему свой лимит памяти |
@composer … | запускает Composer с другой командой |
@имя | запускает другой скрипт из раздела scripts |
Класс::метод | вызывает метод PHP прямо внутри Composer |
| любая другая команда | запускает её так, как если бы вы набрали её сами |
Где настоящая причина
Строка Script … returned with error code — следствие. Причину пишет сама команда, выше. Что там бывает:
| Что написано выше | Что случилось | Что делать |
|---|---|---|
Class "…" not found | PHP не нашёл класс | Разбор |
Call to undefined function | не хватает модуля PHP или функции | Разбор |
Allowed memory size of … bytes exhausted | команде не хватило памяти | лимит памяти скрипта |
The process "…" exceeded the timeout of 300 seconds | команда работала дольше 5 минут | Разбор |
Plugins have been disabled automatically as you are running as root | Composer запущен от root, плагины выключены | Разбор |
| другая ошибка PHP | ошибка в коде или настройках проекта | Ошибки PHP |
Если выше пусто или текст обрезан, запустите команду отдельно — так её сообщение будет видно целиком.
Как запустить команду отдельно
Возьмите команду из сообщения и уберите знак @ в начале:
| В сообщении | Запустите |
|---|---|
@php artisan package:discover --ansi | php artisan package:discover --ansi |
@composer … | composer … |
Запускайте в папке проекта, от того же пользователя, от которого запускаете Composer:
cd /var/www/example.com
php artisan package:discover --ansiКоманда выведет свою ошибку. Когда исправите её и команда отработает без ошибки, запустите Composer снова.
Чтобы Composer повторил скрипты события, не ставя библиотеки заново, запустите их по имени события:
composer run-script post-autoload-dumpС ключом -v Composer пишет перед каждой командой имя события — например, > post-autoload-dump: @php artisan package:discover --ansi.
Если скрипту не хватило памяти
Командам @php … Composer передаёт свой лимит памяти — тот, с которым работает сам: какой он. Если выше Allowed memory size of … bytes exhausted, запустите Composer без лимита — скрипт получит тот же:
COMPOSER_MEMORY_LIMIT=-1 composer installОстальные команды из раздела scripts работают с лимитом из php.ini. Подробнее о лимите — Allowed memory size в Composer.
Если пишет terminated with an exception
Script Example\Library\Installer::postInstall handling the post-install-cmd event terminated with an exceptionЗдесь Example\Library\Installer::postInstall — пример. Это скрипт вида Класс::метод: он работает внутри Composer, и вместо кода выхода Composer показывает исключение — сообщение об ошибке ниже этой строки. Причина — в нём.
Если Composer пишет про класс или скрипт
Эти строки — предупреждения: Composer пропускает скрипт и идёт дальше.
Class Example\Library\Installer is not autoloadable, can not call post-install-cmd script«Класс не найден, скрипт не вызвать». Класс из библиотеки, которая не поставлена: например, библиотека из require-dev, а Composer запустили с ключом --no-dev.
You made a reference to a non-existent script @build«Ссылка на скрипт, которого нет». В разделе scripts есть строка @build, а скрипта с именем build нет — проверьте имя.
Если нужно поставить библиотеки без скриптов
Ключ --no-scripts ставит библиотеки и не запускает скрипты:
composer install --no-scriptsТак можно поставить библиотеки, пока ищете причину. Но шаги, которые делают скрипты, не выполнятся, и сайт может не заработать. Когда исправите ошибку, запустите скрипты: composer run-script post-autoload-dump — или ту команду отдельно.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Script … handling the … event returned with error code 1 | команда из composer.json завершилась с ошибкой | смотрите строки выше |
Script … handling the … event terminated with an exception | скрипт-метод выбросил исключение | читайте сообщение ниже |
Class … is not autoloadable, can not call … script | класс скрипта не поставлен | проверьте --no-dev |
You made a reference to a non-existent script | в scripts ссылка на несуществующий скрипт | проверьте имя |
выше Allowed memory size of … bytes exhausted | скрипту не хватило памяти | COMPOSER_MEMORY_LIMIT=-1 |
выше exceeded the timeout of 300 seconds | скрипт работал дольше 5 минут | Разбор |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: запуск скриптов и сообщения в EventDispatcher/EventDispatcher.php, код выхода в Console/Application.php.
- Скрипты Composer — на английском: события и виды скриптов.
- Команды Composer — на английском: run-script и ключ --no-scripts.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Class not found в PHPесли команда не находит класс.
- The process "…" exceeded the timeoutесли скрипт работает дольше 5 минут.
- Ошибки Composerвсе ошибки Composer на одной странице.