需启用php cli模式的openssl扩展:先运行php --ini确认cli加载的php.ini路径,再检查其中extension=openssl是否启用,ubuntu需安装php-openssl包并创建软链,centos需启用对应php模块。

composer install 报 “The requested PHP extension openssl is missing” 怎么办
这不是 Composer 本身的问题,而是 PHP CLI 模式下 openssl 扩展根本没启用。它不会报错退出,而是卡在 Loading composer repositories with package information 或直接提示 file_get_contents(): php_network_getaddresses: getaddrinfo failed —— 因为连 HTTPS 都建不起来。
- 运行
php -m | grep openssl,若无输出,说明扩展未加载 - 查 CLI 使用的配置:
php --ini,重点关注 Loaded Configuration File 行指向的php.ini - 打开该
php.ini,确认没有注释掉extension=openssl(Ubuntu/Debian 系统通常需额外安装php-openssl包) - CentOS/RHEL 8+:用
dnf module enable php:remi-8.2切换模块后,再装php-cli php-openssl - 改完重启终端或执行
hash -r,再跑php -m | grep openssl验证
为什么 php.ini 里写了 extension=openssl 还是不生效
常见原因是 CLI 和 Web 模式用了两套 php.ini。你改了 Apache 或 Nginx 对应的配置,但 composer install 走的是 CLI 模式,压根不读那个文件。
- 务必用
php --ini确认 CLI 实际加载的是哪个php.ini - 某些宝塔、AMPPS、自编译环境会把 CLI 的
php.ini放在/usr/local/php/etc/php.ini,而 Web 版本在/usr/local/php/lib/php.ini,别搞混 - 如果
php --ini显示 “Loaded Configuration File: (none)”,说明 CLI 没加载任何配置,得手动指定或重装php-cli包 - Ubuntu 上装完
php-openssl后,有时要手动在/etc/php/*/cli/conf.d/下加软链,比如sudo ln -s /etc/php/*/mods-available/openssl.ini /etc/php/*/cli/conf.d/20-openssl.ini
composer config --global repo.packagist 不起作用?
这个命令只写进 ~/.composer/config.json,但它不会影响扩展缺失导致的连接失败。换句话说:镜像源配得再快,没有 openssl,连 DNS 解析都过不去。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 先解决
php -m | grep openssl有输出,再配镜像源 - 配完立刻验证:
composer config -g repo.packagist应返回类似https://mirrors.cloud.tencent.com/composer/ - 如果返回空或旧地址,说明配置没写进去,可能是权限问题(
~/.composer归 root 所有),运行ls -ld ~/.composer看归属 - 国内必须配镜像,否则即使 openssl 正常,也会卡在
Downloading https://repo.packagist.org/packages.json超时
“Class 'ZipArchive' not found” 是不是也算安全套件问题
不是。zip 和 openssl 是两个独立扩展,但经常被一起提及,因为它们共同构成 Composer 基础能力:openssl 负责 HTTPS 通信,zip 负责解压下载下来的包。缺 zip 会导致 failed to extract,现象是 vendor 目录为空或只有部分文件。
- 检查:
php -m | grep zip,无输出就装php-zip(Ubuntu)或php-zip(CentOS) - 注意:PHP ≥ 8.0 后
zip扩展默认启用,但 CLI 模式仍可能被禁用;php --ri zip可看详细状态 - 别混淆
unzip系统命令和ZipArchivePHP 类——Composer 用的是后者,跟系统有没有unzip命令无关
最常被忽略的一点:你以为自己在修 Composer,其实是在修 PHP CLI 环境。所有“缺少扩展”的提示,本质都是 php -m 没列出来,而不是 Composer 配置能绕过去的。










