Composer: requires ext-… it is missing from your system — не хватает модуля PHP
Проекту или библиотеке нужен модуль PHP, которого нет в PHP командной строки. Имя модуля — после ext-: ext-zip — модуль zip. В Ubuntu модуль ставится пакетом php- с тем же именем, например sudo apt install php-zip. После установки запустите Composer снова и перезапустите PHP-FPM, чтобы модуль увидел и сайт.
Содержание 12
- Что сделать прямо сейчас
- Как выглядит ошибка
- Какой пакет поставить
- Чтобы модуль увидел и сайт
- Если на сервере несколько версий PHP
- Если модуль поставлен, но выключен
- Если модуль не той версии
- Если модуль выключен настройкой platform
- Почему не стоит пропускать проверку
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Найдите в сообщении имя модуля после
ext-:ext-zip— модуль zip. - Поставьте пакет:
sudo apt install php-zip— вместо zip ваш модуль. Какой пакет для какого модуля — таблица. - Запустите команду Composer снова и перезапустите PHP-FPM:
sudo systemctl restart php8.3-fpm.
Как выглядит ошибка
Your requirements could not be resolved to an installable set of packages.
Problem 1
- Root composer.json requires PHP extension ext-zip * but it is missing from your system. Install or enable PHP's zip extension.«Главный composer.json требует модуль PHP zip, а в системе его нет. Установите или включите модуль zip». * — подойдёт любая версия модуля.
Если модуль нужен библиотеке, строка начинается с её имени, а причина — после стрелки:
- example/library 1.0.0 requires ext-zip * -> it is missing from your system. Install or enable PHP's zip extension.Здесь example/library — пример имени библиотеки.
Под задачами Composer пишет подсказки:
To enable extensions, verify that they are enabled in your .ini files:
- /etc/php/8.3/cli/php.ini
- /etc/php/8.3/cli/conf.d/10-opcache.ini
- …
You can also run `php --ini` in a terminal to see which files are used by PHP in CLI mode.
Alternatively, you can run Composer with `--ignore-platform-req=ext-zip` to temporarily ignore these required extensions.Первая — «проверьте, что модули включены в ваших файлах .ini», и список этих файлов. Вторая — «команда php --ini покажет, какие файлы читает PHP командной строки». Третья — о ключе, который пропускает проверку, — почему лучше без него.
Какой пакет поставить
Composer проверяет PHP командной строки. Какие модули в нём включены, показывает команда:
php -mМодуля из сообщения в списке нет — поставьте его пакет:
| Что просит Composer | Какой пакет поставить |
|---|---|
ext-zip | sudo apt install php-zip |
ext-gd | sudo apt install php-gd |
ext-curl | sudo apt install php-curl |
ext-mbstring | sudo apt install php-mbstring |
ext-intl | sudo apt install php-intl |
ext-bcmath | sudo apt install php-bcmath |
ext-dom, ext-xml, ext-simplexml | sudo apt install php-xml |
ext-mysqli, ext-pdo_mysql | sudo apt install php-mysql |
Пакет php-имя ставит модуль для версии PHP вашей Ubuntu: в Ubuntu 24.04 — для PHP 8.3. Если не знаете, какой пакет нужен, посмотрите список:
apt-cache search php8.3-После установки проверьте php -m ещё раз — модуль должен появиться в списке. Если apt пишет, что пакет не найден, — разбор ошибки apt.
Чтобы модуль увидел и сайт
Модуль ставится и для командной строки, и для PHP-FPM, но работающий PHP-FPM узнает о нём только после перезапуска:
sudo systemctl restart php8.3-fpmВ Ubuntu 26.04 — php8.5-fpm. Подробнее о версиях — Как установить PHP на Ubuntu.
Если на сервере несколько версий PHP
Пакет php-zip ставит модуль для версии PHP вашей Ubuntu. Если Composer работает с другой версией — её покажет php -v, — поставьте пакет с номером версии:
sudo apt install php8.3-zipВместо 8.3 — версия из php -v. Какие версии стоят, покажет ls /etc/php/.
Если модуль поставлен, но выключен
Если пакет уже стоит, а модуля нет в php -m, его выключили. Включите:
sudo phpenmod zipКоманда включает модуль для всех версий PHP на сервере — и для командной строки, и для PHP-FPM. Затем перезапустите PHP-FPM.
Если модуль включали строкой extension=… в php.ini, проверьте, что перед ней нет ; — так в php.ini выключают строку. Какой файл php.ini читает PHP командной строки, покажет php --ini. Файлов php.ini в Ubuntu два: для командной строки и для сайта — Настройки PHP.
Если модуль не той версии
- Root composer.json requires PHP extension ext-redis ^6.0 but it has the wrong version installed (5.3.7).«Модуль стоит, но не той версии» — в скобках версия, которая стоит. Посмотреть версию модуля можно так:
php -r 'echo phpversion("redis"), PHP_EOL;'Вместо redis — имя модуля. В Ubuntu 24.04 пакет php-redis ставит модуль redis 5.3.7, а обновления пакета исправляют ошибки, но не переводят модуль на новую основную версию. Если нужна новее, условие на версию модуля в composer.json меняет разработчик сайта, или сайт переезжает на более новую Ubuntu.
Если модуль выключен настройкой platform
- Root composer.json requires PHP extension ext-zip * but the ext-zip package is disabled by your platform config. Enable it again with "composer config platform.ext-zip --unset".Модуль в PHP есть, но в composer.json в разделе config → platform записано, что его нет. Composer сам подсказывает команду, которая убирает эту запись:
composer config platform.ext-zip --unsetПочему не стоит пропускать проверку
Ключ --ignore-platform-req=ext-zip велит Composer не проверять модуль: библиотеки поставятся. Но когда сайт дойдёт до кода, которому нужен модуль, PHP остановится с ошибкой — Call to undefined function или Class not found. Проверка модулей при открытии сайта по умолчанию выключена: Composer проверяет только версию PHP, — поэтому ошибка появится не сразу, а на нужной странице.
Ключ подходит, только если модуль нужен в другом месте — например, библиотеку запускают на другом сервере.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
requires PHP extension ext-… but it is missing from your system | модуля нет | поставьте пакет |
-> it is missing from your system. Install or enable PHP's … extension. | модуль нужен библиотеке | поставьте пакет |
пакет стоит, а модуля нет в php -m | модуль выключен | sudo phpenmod имя |
it has the wrong version installed (…) | модуль не той версии | проверьте версию |
disabled by your platform config | запись в настройке platform | composer config platform.ext-… --unset |
Composer прошёл, а сайт пишет Call to undefined function | модуль не включён для PHP-FPM | перезапустите PHP-FPM |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: сообщения в DependencyResolver/Problem.php и подсказки в SolverProblemsException.php.
- Настройки Composer — на английском: настройки platform и platform-check.
- Пакет php-zip в Ubuntu 24.04 — модуль zip для PHP.
- Пакет php-xml в Ubuntu 24.04 — модули DOM, SimpleXML и XML.
- Пакет php-redis в Ubuntu 24.04 — модуль redis 5.3.7.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Как установить Composer на Ubuntuкакие модули PHP ставятся вместе с ним.
- Unable to load dynamic libraryесли PHP не может загрузить модуль.
- Ошибки Composerвсе ошибки Composer на одной странице.