Composer安装失败求助：Git主机解析与SSL报错

一、Composer安装中的Git相关问题 #

git.drupalcode.org 解析失败 #

• 手动配置Hosts：通过nslookup git.drupalcode.org或dig git.drupalcode.org获取服务器IP，将IP和域名的映射添加到本地Hosts文件：
  • Linux/Mac：编辑/etc/hosts，添加[获取到的IP] git.drupalcode.org
  • Windows：编辑C:\Windows\System32\drivers\etc\hosts，同样添加上述映射
• 切换网络环境：尝试使用手机热点等其他网络，排除本地DNS污染或网络限制的影响

GitHub凭证验证失败 #

• 重新配置GitHub OAuth令牌：在GitHub生成具有repo权限的个人访问令牌，执行以下命令全局配置：

  composer config -g github-oauth.github.com YOUR_GITHUB_TOKEN
  

• 清除Composer缓存后重试：

  composer clear-cache
  fin composer install
  

二、Xdebug无法连接调试客户端 #

• 检查Xdebug核心配置（适用于DDEV环境）：
  1. 确认xdebug.client_host设置为host.docker.internal（Docker容器访问主机的默认域名），或你的主机本地IP
  2. 确保xdebug.client_port为9003（Xdebug 3+默认端口），且调试客户端（VSCode/PhpStorm等）监听端口一致
  3. 开启调试模式：临时通过环境变量触发，执行XDEBUG_MODE=debug fin composer install，或在配置文件中设置xdebug.mode=debug
• 排查防火墙限制：检查主机系统防火墙和Docker容器的防火墙规则，确保9003端口的入站连接未被阻止

三、直接安装Composer的SSL错误与程序损坏问题 #

SSL不安全协商错误（error:0A000152） #

• 修改OpenSSL配置允许旧版协商：
  1. 找到系统的openssl.cnf文件（Linux/Mac通常在/etc/ssl/openssl.cnf，Windows在OpenSSL安装目录）
  2. 在文件开头添加以下配置：

     [openssl_init]
     ssl_conf = ssl_sect
     
     [ssl_sect]
     system_default = system_default_sect
     
     [system_default_sect]
     Options = UnsafeLegacyRenegotiation
     

  3. 使用修改后的配置执行安装命令：

     OPENSSL_CONF=/path/to/modified/openssl.cnf php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
     

composer-setup.php 找不到/安装程序损坏 #

• 手动下载安装脚本：通过浏览器访问官方安装页面，下载composer-setup.php到本地目录后，执行验证和安装命令
• 临时跳过验证（仅在确认文件安全时使用）：

  php composer-setup.php --no-verify
  

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