Composer安装失败提示“缺少扩展”本质是PHP环境缺失openssl、mbstring、json、phar、curl等模块；需用php -m | grep -E验证启用状态，再通过php --ini定位并修改CLI对应的php.ini中extension=xxx行，确保路径与扩展文件匹配。
Composer 安装失败提示“缺少扩展”，本质不是 Composer 本身的问题，而是 PHP 运行环境缺失必要模块——openssl、mbstring、json、phar、curl 这几个最常被卡住。只要确认并启用对应扩展，composer install 或 composer create-project 就能继续。
怎么看哪些扩展没开？
别猜，直接让 PHP 自己说：
php -m | grep -E 'openssl|mbstring|json|phar|curl'
如果某行没输出（比如 mbstring 完全不显示），说明它没启用。注意：Windows 用户用 php -m 后手动扫一眼，grep 不可用；macOS/Linux 可加 grep -v "disabled" 排除注释行干扰。
更稳妥的方式是运行：
php -i | grep "Loaded Configuration File"
拿到 php.ini 路径后，用编辑器打开，检查类似下面这几行是否取消了分号注释：
-
;extension=openssl→ 改成extension=openssl -
;extension=mbstring→ 改成extension=mbstring -
;extension=curl→ 改成extension=curl
Windows 下扩展名可能是 .dll（如 extension=php_openssl.dll），Linux/macOS 通常是 .so（如 extension=openssl.so），路径错误或扩展文件不存在也会静默失败。
为什么改了 php.ini 还不生效？
PHP CLI（命令行）和 Web 服务器（如 Apache/Nginx）可能加载不同的 php.ini。Composer 在终端里跑，只认 CLI 配置。
执行以下命令确认你改的是对的配置：
php --ini
输出类似：
Configuration File (php.ini) Path: /usr/local/etc/php/8.2 Loaded Configuration File: /usr/local/etc/php/8.2/php.ini
必须编辑 Loaded Configuration File 指向的那个文件，而不是随便一个 php.ini。改完后不用重启 Web 服务，但要重新开终端或运行 php --ini 验证是否加载成功。
常见坑：
- Homebrew 安装的 PHP，
php.ini通常在/usr/local/etc/php/X.Y/php.ini - Docker 中改错容器内路径，宿主机文件无效
- Ubuntu/Debian 系统用
apt install php-curl php-mbstring php-xml php-zip安装扩展后，仍需手工启用（部分版本不自动写入php.ini）
Composer 报错含 “curl_init” 或 “file_get_contents” 失败？
这基本锁定 curl 或 openssl 没就位。尤其在企业网络、代理环境或自签名证书场景下：
-
curl_init(): Unable to initialize curl→curl扩展未启用，或 libcurl 库损坏 -
file_get_contents(): SSL operation failed→openssl已启用，但 CA 证书路径不对；可在php.ini加：openssl.cafile=/path/to/cacert.pem（推荐用 Mozilla 官方 PEM） - 用代理时 Composer 会继承系统
HTTP_PROXY，但若代理不支持 HTTPS，就会卡在包下载阶段；临时绕过：export HTTP_PROXY=; export HTTPS_PROXY=
验证 curl 是否真可用：
php -r "var_dump(function_exists('curl_init'));"
输出 bool(true) 才算过关。
Mac M系列芯片 + Homebrew PHP 组合的典型问题
Homebrew 安装 PHP（如 php@8.2）后，openssl 扩展默认不启用，且依赖的 OpenSSL 版本可能和系统不一致。
解决步骤：
- 确保已安装
openssl@3：brew install openssl@3 - 重装 PHP 并绑定 OpenSSL：
brew reinstall php@8.2 --with-openssl（新版 brew 可能需先brew unlink php@8.2 && brew install php@8.2） - 检查
php.ini中extension=openssl是否存在且未注释 - 运行
php -m | grep openssl，若仍无输出，手动加完整路径：extension="/opt/homebrew/lib/php/8.2/extensions/no-debug-non-zts-20220829/openssl.so"（路径以find /opt/homebrew -name "openssl.so"实际结果为准）
这类环境问题往往不是缺功能，而是扩展找得到、载不进、连不上——多看 php --ini 和 php -m，少凭感觉重启。
