Ошибка composer install: как найти причину и исправить
Ошибка при composer install чаще всего связана с нехваткой памяти, неверными правами на файлы или несовпадением версии PHP с требованиями пакетов. Сначала посмотрите полный текст ошибки в выводе команды: он укажет, на каком пакете или скрипте установка прервалась. Затем проверьте свободную память, владельца каталога проекта и версию PHP.
01Нехватка памяти (Allowed memory size exhausted)
Composer при установке зависимостей загружает в память все пакеты и их метаданные. Если в выводе есть Allowed memory size of ... exhausted или Killed, процессу не хватило RAM. Проверьте свободную память командой free -h и посмотрите, не запущен ли composer без лимита. Для установки без dev-зависимостей на сервере используйте флаг --no-dev и при необходимости временно поднимите лимит через переменную окружения COMPOSER_MEMORY_LIMIT.
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 от того же пользователя, который владеет проектом, или исправьте владельца.
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 показывает нужную версию, и что установлены требуемые расширения.
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 и права на каталоги, затем повторите установку.
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, перезапустите пул и проверьте страницу.
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-зависимости и собирает оптимизированный автозагрузчик.
Ещё по теме
- Ошибка · Деплой Ошибка 500 в Laravel: где искать причину и как исправить Разбираем ошибку 500 в Laravel: где смотреть логи, как проверить права на storage и bootstrap/cache, APP_KEY, синтаксис nginx и PHP-FPM. Команды для диагностики и…
- Ошибка · Деплой php artisan migrate ошибка: причины и исправление Разбираем ошибки php artisan migrate: отказ доступа к MySQL, неверный.env, права на storage. Команды проверки, конфиг nginx и PHP 8.3, как убедиться, что миграции…
- Ошибка · Деплой Ошибка git pull permission denied на VPS: как исправить Разбираем ошибку git pull permission denied на VPS: проверка прав, SSH-ключей, владельца файлов и конфигурации nginx. Команды для диагностики и исправления.
- Ошибка · Деплой Ошибка 419 Page Expired в Laravel: причины и исправление Почему Laravel выдаёт 419 Page Expired: CSRF-токен, cookie сессии, SESSION_DOMAIN, кэш конфига. Как проверить и исправить каждую причину.
- Ошибка · Деплой Ошибка 413 Request Entity Too Large в nginx: как исправить Ошибка 413 в nginx: как найти лимит client_max_body_size, изменить его в конфиге, проверить PHP и перезапустить nginx. Команды и примеры.
- Руководство · Деплой Как развернуть сайт на VPS: Laravel и PHP на Ubuntu 24.04 Пошаговый деплой сайта на VPS: nginx, PHP 8.3, MySQL 8, git clone, composer install, миграции, права на storage и проверка через curl.
Деплой Laravel на сервер: команды, конфиг и ошибки: все материалы темы