Поиск
Ошибки

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, чтобы модуль увидел и сайт.

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

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

  1. Найдите в сообщении имя модуля после ext-: ext-zip — модуль zip.
  2. Поставьте пакет: sudo apt install php-zip — вместо zip ваш модуль. Какой пакет для какого модуля — таблица.
  3. Запустите команду 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-zipsudo apt install php-zip
ext-gdsudo apt install php-gd
ext-curlsudo apt install php-curl
ext-mbstringsudo apt install php-mbstring
ext-intlsudo apt install php-intl
ext-bcmathsudo apt install php-bcmath
ext-dom, ext-xml, ext-simplexmlsudo apt install php-xml
ext-mysqli, ext-pdo_mysqlsudo 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запись в настройке platformcomposer config platform.ext-… --unset
Composer прошёл, а сайт пишет Call to undefined functionмодуль не включён для PHP-FPMперезапустите PHP-FPM

Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.

Источники

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

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

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