答案是PHP CLI环境缺失指定扩展,需用php -r和php --ini验证真实状态,再按系统安装对应包(如Ubuntu用php-zip、CentOS 7用php-pecl-zip),检查libzip≥1.6.0及系统unzip命令,并重启终端验证。

报错里出现 ext-xxx,不是 Composer 本身缺东西,而是它启动前就卡在 PHP CLI 环境校验上——扩展根本没加载,后续所有操作都无效。
怎么看清楚到底缺哪个扩展
别只信报错文字,直接查 CLI 模式下真实状态:
- 运行
php -r "var_dump(extension_loaded('zip'));"(把zip换成报错里的名字),输出bool(false)才是真的没加载 - 用
php --ini确认 CLI 实际读的是哪个php.ini,XAMPP/WAMP/多版本 PHP 常有多个配置文件,改错路径等于白干 - 一次性扫关键扩展:
php -m | grep -E "zip|gd|intl|mbstring|dom|fileinfo|openssl",漏一个都可能让composer install中断
不同系统装扩展的包名差异极大
装错包名=白装,且各发行版命名规则不兼容:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Ubuntu/Debian:
sudo apt install php-zip(自动启用)、sudo apt install php-intl;若提示找不到,加版本号如php8.2-zip - CentOS/RHEL 7:
sudo yum install php-pecl-zip(不是php-zip)、sudo yum install php-intl - CentOS/RHEL 8+:
sudo dnf install php-zip、sudo dnf install php-intl - Alpine(Docker):
apk add php8-zip(版本号必须和php -v输出一致) - macOS + Homebrew:
brew install php@8.2-zip,再确认php.ini里有extension="zip.so" - Windows:打开
php.ini,取消;extension=zip前的分号,并确保php_zip.dll真实存在于extension_dir指向的目录中
装完还是报错?这些静默失效点最常被忽略
扩展显示已安装,但 composer 仍报错,大概率是以下某处断链:
- CLI 和 Web(Apache/Nginx/FPM)用了不同
php.ini,php --ini显示的路径才是你要改的那个 - Linux 下装了
php-zip,但没重启终端——旧 shell 缓存旧模块列表,新终端才能看到php -m更新 - libzip 库太旧(如 CentOS 7 自带 0.10),PHP 8.0+ 要求 ≥ 1.6.0;查版本:
pkg-config --modversion libzip - Docker 中只装了
php8-zip,但没装系统级unzip命令(apk add unzip),Composer 默认优先调它,报unzip not found
临时跳过但不掩盖问题的正确方式
--ignore-platform-reqs 是全局跳过,风险高;更安全的是只跳过特定项:
-
composer install --ignore-platform-req=ext-redis—— 保留对 PHP 版本、其他扩展(如ext-mbstring)的校验 -
composer install --ignore-platform-req=ext-zip --ignore-platform-req=ext-gd—— 多个可并列指定
libzip 版本、系统 unzip 命令、CLI 与 Web 配置分离——这三处最容易被跳过验证,结果是扩展看似加载成功,但解压或图像处理时 runtime 崩溃。

















