Поиск
Ошибки

Composer: Script … handling the … event returned with error code — скрипт проекта завершился с ошибкой

После установки библиотек Composer запускает команды из раздела scripts в composer.json — например, php artisan package:discover в Laravel. Одна из них завершилась с ошибкой, и Composer пишет её код выхода. Сама причина — в строках над этим сообщением: это ошибка команды, а не Composer. Запустите команду отдельно, прочитайте её сообщение и исправьте.

≈ 6 мин чтения
Содержание 12

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

  1. Прокрутите вывод вверх: над строкой Script … returned with error code — сообщение самой команды.
  2. Запустите ту же команду отдельно, в папке проекта, — как это сделать.
  3. Исправьте ошибку по её тексту — что бывает выше — и запустите 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 foundPHP не нашёл классРазбор
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 rootComposer запущен от root, плагины выключеныРазбор
другая ошибка PHPошибка в коде или настройках проектаОшибки PHP

Если выше пусто или текст обрезан, запустите команду отдельно — так её сообщение будет видно целиком.

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

Возьмите команду из сообщения и уберите знак @ в начале:

В сообщенииЗапустите
@php artisan package:discover --ansiphp 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.

Источники

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

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

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