Composer SSL错误通常因OpenSSL过旧导致，解决步骤包括：一、升级系统OpenSSL并重编PHP；二、配置Composer使用更新的CA证书包；三、仅调试时临时禁用TLS验证；四、切换国内镜像并启用兼容模式；五、用Docker封装新版OpenSSL环境。
如果您在使用 Composer 安装或更新依赖时遇到 SSL 连接失败、证书验证错误或 “cURL error 60” 等提示，则很可能是系统中 OpenSSL 版本过旧，无法支持现代 TLS 协议（如 TLS 1.2/1.3）或无法验证 Packagist.org 等源使用的证书链。以下是解决此问题的步骤：
一、升级系统 OpenSSL 并重新编译 PHP
OpenSSL 是 PHP cURL 和 stream 扩展底层依赖的加密库，旧版 OpenSSL（如 1.0.1 或更早）已停止维护，不支持 SNI 或现代证书签名算法，导致无法与 Packagist HTTPS 接口建立安全连接。升级 OpenSSL 后需确保 PHP 重新链接到新版库。
1、检查当前 OpenSSL 版本：openssl version -a
2、检查 PHP 使用的 OpenSSL 版本：php -r "print_r(openssl_get_cipher_methods());" 并确认 php --ri openssl 中显示的版本号
3、在 Ubuntu/Debian 上执行：sudo apt update && sudo apt install -y openssl libssl-dev
4、在 CentOS/RHEL 7+ 上执行：sudo yum install -y openssl-devel 或使用 dnf install -y openssl-devel
5、若 PHP 为源码编译安装，进入 PHP 源码目录后运行：make clean && ./configure --with-openssl=/usr --with-curl --with-zlib && make && sudo make install
二、配置 Composer 使用替代 CA 证书包
Composer 默认依赖系统 CA 证书路径，但旧系统可能缺少 Let’s Encrypt ISRG Root X1 等新根证书。可显式指定一个更新的证书包路径，绕过系统自带证书限制。
1、下载最新 Mozilla CA 包：curl -sS https://curl.se/ca/cacert.pem -o /usr/local/share/ca-certificates/composer-cacert.pem
2、更新系统证书存储（Ubuntu/Debian）：sudo cp /usr/local/share/ca-certificates/composer-cacert.pem /usr/share/ca-certificates/ && sudo update-ca-certificates
3、为 Composer 单独设置证书路径：composer config -g cafile /usr/local/share/ca-certificates/composer-cacert.pem
4、验证配置是否生效：composer config -g cafile 应输出对应路径
三、临时禁用 TLS 验证（仅限调试环境）
该方法绕过证书校验，**绝不适用于生产环境或含敏感凭证的项目**，仅用于快速定位是否为证书验证环节引发的连接失败。
1、全局禁用 SSL 验证：composer config -g secure-http false
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
2、强制使用 HTTP 协议源（风险极高）：composer config -g repo.packagist.org.url http://packagist.org
3、清除配置缓存：composer clear-cache
4、执行测试命令：composer diagnose 应不再报 SSL 相关错误
四、切换至国内镜像并启用 TLS 兼容模式
部分国内镜像（如阿里云、腾讯云）提供针对旧 OpenSSL 的兼容接口，其 Nginx 配置保留 TLS 1.0/1.1 支持，并采用较宽松的证书链策略，可作为过渡方案。
1、设置阿里云镜像源：composer config -g repo.packagist.org.url https://mirrors.aliyun.com/composer/
2、禁用证书域名验证（非禁用全部验证）：export COMPOSER_CAFILE=/dev/null
3、执行更新命令前重载环境变量：source ~/.bashrc 或直接在当前 shell 运行 export 命令
4、运行诊断：composer diagnose -v 观察是否仍出现 “unable to verify the first certificate”
五、使用 Docker 封装兼容运行环境
当宿主机 OpenSSL 无法升级（如受限于老旧企业 OS），可通过官方 PHP Docker 镜像启动带新版 OpenSSL 的 Composer 环境，完全隔离系统依赖。
1、拉取带 OpenSSL 3.0+ 的 PHP 镜像：docker pull php:8.2-cli
2、创建本地 composer.json 映射目录：mkdir -p ~/my-project && cd ~/my-project
3、在项目目录内运行容器化 Composer：docker run --rm -it -v $(pwd):/app -w /app php:8.2-cli sh -c "curl -sS https://getcomposer.org/installer | php && php composer.phar install"
4、确认依赖正确解析：docker run --rm -v $(pwd):/app -w /app php:8.2-cli php composer.phar show --platform
