К содержимому

Ошибка composer install: как найти причину и исправить

Ошибка при composer install чаще всего связана с нехваткой памяти, неверными правами на файлы или несовпадением версии PHP с требованиями пакетов. Сначала посмотрите полный текст ошибки в выводе команды: он укажет, на каком пакете или скрипте установка прервалась. Затем проверьте свободную память, владельца каталога проекта и версию PHP.

Ошибка Деплой 3 мин чтения

01Нехватка памяти (Allowed memory size exhausted)

Composer при установке зависимостей загружает в память все пакеты и их метаданные. Если в выводе есть Allowed memory size of ... exhausted или Killed, процессу не хватило RAM. Проверьте свободную память командой free -h и посмотрите, не запущен ли composer без лимита. Для установки без dev-зависимостей на сервере используйте флаг --no-dev и при необходимости временно поднимите лимит через переменную окружения COMPOSER_MEMORY_LIMIT.

bash
free -h
COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev --optimize-autoloader

02Ошибка прав доступа (Permission denied)

Сообщение Permission denied или failed to open stream: Permission denied появляется, когда composer запущен от пользователя, у которого нет прав на запись в каталог проекта или в vendor. Проверьте владельца файлов командой ls -la в каталоге проекта. Если проект принадлежит www-data, а composer запускается от другого пользователя, установка не сможет создать файлы. Запускайте composer от того же пользователя, который владеет проектом, или исправьте владельца.

bash
ls -la /var/www/example.com
sudo chown -R www-data:www-data /var/www/example.com
sudo -u www-data composer install --no-dev --optimize-autoloader

03Несовпадение версии PHP (Your requirements could not be resolved)

Composer сверяет версию PHP и расширения с требованиями в composer.json. Если в выводе есть Your requirements could not be resolved to an installable set of packages или requires php ^8.2, проверьте фактическую версию интерпретатора. На Ubuntu 24.04 по умолчанию может быть установлена другая версия, а CLI и FPM могут отличаться. Убедитесь, что php -v показывает нужную версию, и что установлены требуемые расширения.

bash
php -v
php -m | grep -E 'mbstring|xml|curl|zip|mysql'
composer check-platform-reqs

04Ошибка в скриптах после установки (Script... returned with error code)

После загрузки пакетов composer выполняет скрипты из секции scripts в composer.json, например post-autoload-dump с php artisan package:discover. Если в выводе есть Script ... returned with error code 1, смотрите сообщение artisan выше. Часто причина в отсутствующем файле .env, неверных правах на storage или недоступной базе данных. Проверьте .env и права на каталоги, затем повторите установку.

bash
ls -la /var/www/example.com/.env
sudo chown -R www-data:www-data /var/www/example.com/storage /var/www/example.com/bootstrap/cache
composer install --no-dev --optimize-autoloader

05Как убедиться, что ошибка устранена

После исправления повторите composer install и убедитесь, что команда завершилась с кодом 0 и в конце вывела Generating optimized autoload files. Проверьте, что каталог vendor создан и содержит autoload.php. Затем выполните php artisan optimize для сборки кеша конфигурации и маршрутов. Если сайт работает через nginx и PHP-FPM, перезапустите пул и проверьте страницу.

bash
composer install --no-dev --optimize-autoloader
php artisan optimize
sudo systemctl restart php8.3-fpm

Что не помогает

  • Запуск composer install от root, чтобы обойти ошибку прав.

    Файлы в vendor и кешах получат владельца root, и PHP-FPM не сможет их прочитать. Запускайте composer от пользователя проекта или исправьте владельца через chown.

  • Постоянная установка COMPOSER_MEMORY_LIMIT=-1 без анализа причины.

    Это скрывает нехватку памяти и может привести к убийству процесса OOM-killer. Сначала проверьте free -h, закройте лишние процессы, а лимит поднимайте только на время установки.

  • Игнорирование вывода composer check-platform-reqs и установка с --ignore-platform-reqs.

    Пакеты установятся, но упадут при выполнении из-за отсутствующих расширений. Установите нужные расширения PHP через apt и повторите проверку.

Deploykin

Как это делается в Deploykin

В Deploykin у каждого сайта свой системный пользователь и пул PHP-FPM, а команды в каталоге сайта выполняются от этого пользователя, поэтому права на storage и bootstrap/cache не расходятся. .env правится в панели, laravel.log читается там же, а об ошибке деплоя приходит оповещение.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему composer install падает с ошибкой памяти, хотя на сервере достаточно RAM?

Лимит памяти может быть задан в php.ini для CLI и быть ниже доступной RAM. Проверьте php -i | grep memory_limit и при необходимости поднимите лимит для CLI или используйте COMPOSER_MEMORY_LIMIT.

Как исправить Permission denied при composer install?

Проверьте владельца каталога проекта через ls -la. Запускайте composer от пользователя, который владеет файлами, или смените владельца командой sudo chown -R www-data:www-data /var/www/example.com.

Composer пишет, что версия PHP не подходит, что делать?

Сравните php -v с требованием require.php в composer.json. Установите нужную версию PHP и переключите альтернативу update-alternatives --set php /usr/bin/php8.3, затем проверьте composer check-platform-reqs.

Можно ли запускать composer install с флагом --no-dev на продакшене?

Да, для продакшена используйте composer install --no-dev --optimize-autoloader. Это не устанавливает dev-зависимости и собирает оптимизированный автозагрузчик.

Ещё по теме

Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.