为什么在部分Linux发行版上运行Composer install报错-composer-PHP中文网

报错“class 'ziparchive' not found”是php zip扩展未正确启用，需安装对应系统包并确认cli与web环境的php.ini中extension=zip.so已启用。

为什么在部分linux发行版上运行composer install报错

报错“Class 'ZipArchive' not found”是扩展缺失，不是Composer装错了

很多 Linux 发行版（如 Ubuntu、CentOS）默认不启用 zip 扩展，哪怕 php -m | grep zip 看似有输出，也可能是模块已加载但类不可用。真实可用必须验证：php -r "new ZipArchive();" —— 报错就说明没真正装好。

Debian/Ubuntu 系统：运行 sudo apt install php-zip，然后确认 CLI 使用的 php.ini 是否启用了该扩展（检查 extension=zip.so 行是否未被注释）
RHEL/CentOS 8+：用 sudo dnf install php-zip；老版本用 yum install php-pecl-zip
如果 PHP 是编译安装的，需重新编译时加 --enable-zip，或手动加载 zip.so
特别注意：CLI 和 Web（如 FPM）可能用不同 php.ini，php -i | grep "Loaded Configuration File" 查清路径，别只改了 /etc/php/8.2/apache2/php.ini 却忘了 /etc/php/8.2/cli/php.ini

“Permission denied”写 vendor/ 或 composer.lock，大概率是目录属主被 sudo 污染

执行过 sudo composer install 后，vendor/、composer.lock 或 ~/.composer 目录会变成 root 所有。之后你以普通用户再跑命令，就会卡在写文件这一步——不是权限不够，而是“主人不对”。

立刻检查：ls -ld vendor/ composer.lock ~/.composer，看 Owner 列是不是 root
修复命令：sudo chown -R $USER:$USER vendor/ composer.lock（项目内）；sudo chown -R $USER:$USER ~/.composer（全局）
别用 chmod 777 硬怼，治标不治本，还埋安全风险
CI 或 Docker 中尤其常见：构建脚本用 root 用户跑完 composer，后续步骤切到非 root 用户就直接失败

“Could not resolve host: packagist.org” 不是 Composer 问题，是 DNS 或镜像配置失效

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

这个报错 90% 和网络策略有关，比如企业防火墙拦截、DNS 污染，或者镜像根本没生效。Composer 自己没能力绕过系统 DNS，它只是个 HTTP 客户端。

先验证 DNS：nslookup packagist.org 或 dig packagist.org +short，返回空或错误 IP 就是 DNS 层挂了
镜像必须配对才有效：composer config -g repo.packagist 输出得是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；输出 null 或还是 packagist.org，说明配置失败
项目根目录下只要存在 "repositories" 字段（哪怕内容是 {}），全局镜像就自动失效——这是 Composer 的硬规则，不是 bug
阿里云镜像 URL 必须以 / 结尾，少一个斜杠就会拼出 /composerpackages.json 导致 404

“SSL certificate problem: certificate has expired” 其实是系统时间快了或慢了

OpenSSL 校验证书时严格比对系统时钟和证书的 notBefore/notAfter 时间戳。偏差超过 2 分钟，就会触发这个错误——不是证书真过期，也不是 CA 证书缺失。

Linux/macOS：运行 timedatectl status，重点看 System clock synchronized: 是否为 yes；不是就执行 sudo timedatectl set-ntp true && sudo systemctl restart systemd-timesyncd
Windows：管理员运行 w32tm /resync，若失败先 net start w32time，再换可靠源 w32tm /config /syncfromflags:manual /manualpeerlist:"time.nist.gov pool.ntp.org"
容器环境（Docker/K8s）最容易忽略：基础镜像可能没开 NTP，或宿主机时间不准导致容器内时间漂移
临时禁用 SSL 校验（composer config -g secure-http false）仅限调试，生产环境绝对不要留