Поиск
Ошибки

Composer: The zip extension and unzip/7z commands are both missing — что поставить

Composer скачивает библиотеки архивами zip, а распаковать их нечем: нет ни программы unzip, ни модуля PHP zip. Тогда он пробует скачать код через git, а без git останавливается. Поставьте оба пакета: sudo apt install unzip php-zip — и запустите команду снова.

≈ 5 мин чтения
Содержание 9

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

  1. Поставьте программу unzip и модуль PHP zip: sudo apt install unzip php-zip.
  2. Проверьте: unzip -v отвечает версией, а в списке php -m есть строка zip.
  3. Запустите команду Composer снова.

Как выглядит ошибка

    Failed to download example/library from dist: The zip extension and unzip/7z commands are both missing, skipping.
The php.ini used by your command-line PHP is: /etc/php/8.3/cli/php.ini
    Now trying to download from source

Здесь example/library — пример имени библиотеки. Первая строка — «не удалось скачать архив: нет ни модуля zip, ни команд unzip и 7z, пропускаю». Вторая — какой файл php.ini читает PHP командной строки: в нём включают модули. Третья — «пробую скачать исходный код» — через git.

Если git на сервере нет, следом будет:

git was not found in your PATH, skipping source download

«git не найден, пропускаю загрузку исходного кода». Тогда Composer остановится: библиотеку не получилось ни распаковать, ни скачать через git.

Если git есть, Composer скачает библиотеки через git. Работать будет, но медленнее, и в папке vendor окажутся копии репозиториев целиком.

Чем Composer распаковывает архивы

Composer ищет, чем распаковать zip, по очереди:

ЧемЧто этоПакет в Ubuntu
unzipпрограмма для распаковкиunzip
7zархиватор 7-Zip7zip
модуль zipмодуль PHPphp-zip

Хватит одного, но лучше поставить и unzip, и модуль zip: unzip сохраняет права на файлы из архива, а модуль zip нужен библиотекам, которые требуют ext-zip, — если не хватает модуля.

Пакет composer в Ubuntu сам предлагает поставить unzip, php-zip и git: apt ставит их вместе с ним, если не запускать его с ключом --no-install-recommends. Ошибка бывает, если Composer ставили не из пакета Ubuntu или с этим ключом.

Что поставить

sudo apt install unzip php-zip

Если на сервере несколько версий PHP, поставьте модуль для той, которой запускаете Composer, — версию покажет php -v:

sudo apt install php8.3-zip

Проверьте:

unzip -v
php -m | grep zip

Первая команда отвечает версией unzip, вторая — строкой zip. Если apt пишет, что пакет не найден, — Unable to locate package.

Модуль zip ставится и для PHP-FPM. Чтобы его увидел сайт, перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm.

Если пишет про proc_open

The zip extension is missing and unzip/7z commands cannot be called as proc_open is disabled, skipping.

«Модуля zip нет, а команды unzip и 7z вызвать нельзя: функция proc_open выключена». proc_open — функция PHP, через которую Composer запускает другие программы. Её выключают настройкой disable_functions в php.ini — так бывает на виртуальном хостинге.

Что сделать: поставьте модуль zip — он работает без proc_open. Если сервер ваш, найдите строку disable_functions в php.ini командной строки — путь покажет php --ini — и уберите из неё proc_open. Без proc_open Composer не сможет запускать git и скрипты.

Если пишет предупреждение

As there is no 'unzip' nor '7z' command installed zip files are being unpacked using the PHP zip extension.
This may cause invalid reports of corrupted archives. Besides, any UNIX permissions (e.g. executable) defined in the archives will be lost.
Installing 'unzip' or '7z' (21.01+) may remediate them.

«Команд unzip и 7z нет, архивы распаковываются модулем PHP zip. Composer может по ошибке счесть архив повреждённым, а права на файлы из архива — например, право на запуск — пропадут. Поставьте unzip или 7z версии 21.01 и новее».

Это предупреждение, а не ошибка: библиотеки поставятся. Но у файлов из архива, которые нужно запускать, может не оказаться права на запуск. Поставьте unzip, чтобы такого не было:

sudo apt install unzip

Ошибки и как их исправить

Что видитеПричинаЧто делать
The zip extension and unzip/7z commands are both missing, skipping.нечем распаковать архивsudo apt install unzip php-zip
Now trying to download from sourceComposer пробует git вместо архивапоставьте unzip и php-zip
git was not found in your PATH, skipping source downloadнет ни распаковки, ни gitпоставьте unzip и php-zip
unzip/7z commands cannot be called as proc_open is disabledфункция proc_open выключенапоставьте модуль zip
As there is no 'unzip' nor '7z' command installedнет программы unzipsudo apt install unzip
requires ext-zip * -> it is missing from your systemбиблиотеке нужен модуль zipРазбор

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

Источники

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

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

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