Mac OS High Sierra安装Composer出现SSL证书验证失败如何解决

错误原因 #

该报错是系统自带PHP版本内置的CA根证书过期，无法验证getcomposer.org的SSL证书合法性导致的，以下是可行解决方案：

方案1：更新PHP的CA根证书配置（推荐，无安全风险） #

• 先找到当前生效的php.ini文件路径，执行命令：
  php --ini | grep "Loaded Configuration File"
• 获取最新的CA根证书集合文件cacert.pem，保存到本地固定路径，例如/usr/local/etc/php/cacert.pem
• 编辑找到的php.ini文件，修改或新增以下两项配置：

  curl.cainfo = "/usr/local/etc/php/cacert.pem"
  openssl.cafile = "/usr/local/etc/php/cacert.pem"
  

• 保存退出后重新执行Composer官方安装命令即可。

方案2：通过Homebrew安装兼容的PHP版本 #

如果是系统自带PHP版本过旧导致的兼容问题，可通过Homebrew安装适配High Sierra的PHP版本：

• 执行安装命令：brew install php@7.4
• 安装完成后将brew的PHP路径加入当前用户环境变量：
  echo 'export PATH="/usr/local/opt/php@7.4/bin:$PATH"' >> ~/.bash_profile && source ~/.bash_profile
• 验证PHP版本切换成功：php -v
• 重新执行Composer官方安装命令即可。

方案3：临时跳过SSL验证（仅应急使用） #

如果仅临时需要完成安装，可以在执行安装脚本时添加跳过TLS验证的参数：

• 把原安装流程中的php composer-setup.php命令替换为：
  php composer-setup.php --disable-tls
• 安装完成后建议配置国内Composer镜像，避免后续依赖下载出现同类问题。

内容的提问来源于stack exchange，提问作者ismail taibi