Composer: The zip extension and unzip/7z commands are both missing — что поставить
Composer скачивает библиотеки архивами zip, а распаковать их нечем: нет ни программы unzip, ни модуля PHP zip. Тогда он пробует скачать код через git, а без git останавливается. Поставьте оба пакета: sudo apt install unzip php-zip — и запустите команду снова.
Содержание 9
Что сделать прямо сейчас
- Поставьте программу unzip и модуль PHP zip:
sudo apt install unzip php-zip. - Проверьте:
unzip -vотвечает версией, а в спискеphp -mесть строкаzip. - Запустите команду 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-Zip | 7zip |
| модуль zip | модуль PHP | php-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 source | Composer пробует 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 | нет программы unzip | sudo apt install unzip |
requires ext-zip * -> it is missing from your system | библиотеке нужен модуль zip | Разбор |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: сообщения в Downloader/ZipDownloader.php, Downloader/DownloadManager.php и Downloader/GitDownloader.php.
- Пакет composer в Ubuntu 24.04 — какие пакеты apt ставит вместе с Composer.
- Пакет unzip в Ubuntu 24.04 — программа unzip.
- Пакет php-zip в Ubuntu 24.04 — модуль zip для PHP.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Как установить Composer на Ubuntuустановка вместе с нужными пакетами.
- requires ext-… it is missing from your systemесли не хватает модуля PHP.
- Ошибки Composerвсе ошибки Composer на одной странице.