Composer在WSL2环境下使用php-curl扩展的网络超时问题解决方案

问题背景

在使用WSL2(Ubuntu 24.04)运行Composer时，当安装了php-curl扩展后，会出现网络连接超时的问题。具体表现为执行composer diagnose命令时，检查github.com oauth访问时会遇到连接超时错误。而当移除php-curl扩展后，Composer又能正常工作，但会提示"使用php streams fallback，这会降低性能"。

问题分析

这个问题的根源在于WSL2的网络配置与php-curl扩展的交互方式。WSL2使用虚拟化技术，其网络栈与Windows主机共享，但又有自己的网络接口。php-curl扩展在尝试通过WSL2的网络接口建立连接时，可能会遇到DNS解析或路由问题，导致连接超时。

解决方案

方法一：修改WSL2的DNS配置

1. 在WSL2中编辑resolv.conf文件：

sudo nano /etc/resolv.conf

2. 添加以下内容：

nameserver 8.8.8.8
nameserver 8.8.4.4

3. 为了防止WSL2自动覆盖此文件，可以设置文件为不可变：

sudo chattr +i /etc/resolv.conf

方法二：调整Composer的网络超时设置

在项目目录或全局Composer配置中增加超时时间设置：

{
    "config": {
        "process-timeout": 300,
        "github-oauth": {
            "github.com": "your_token_here"
        }
    }
}

方法三：使用Windows主机的网络代理

如果Windows主机使用了代理，可以在WSL2中配置相同的代理设置：

export HTTP_PROXY=http://<windows_host_ip>:<port>
export HTTPS_PROXY=http://<windows_host_ip>:<port>

方法四：禁用ipv6

编辑sysctl.conf文件：

sudo nano /etc/sysctl.conf

添加以下内容：

net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1
net.ipv6.conf.lo.disable_ipv6 = 1

然后应用设置：

sudo sysctl -p

验证解决方案

执行以下命令验证问题是否解决：

composer diagnose
curl -v https://api.github.com

最佳实践建议

1. 建议优先使用方法一修改DNS配置，这是最根本的解决方案
2. 对于企业内网环境，可能需要使用方法三配置代理
3. 定期检查WSL2的网络配置，特别是在Windows主机网络设置变更后
4. 考虑在.bashrc或.zshrc中添加网络检查脚本，自动诊断网络问题

总结

WSL2环境下php-curl扩展的网络问题主要是由于虚拟化网络栈的特殊性导致的。通过调整DNS配置、网络超时设置或使用代理等方法，可以有效解决这一问题，使Composer能够充分利用php-curl扩展的性能优势，同时保持稳定的网络连接。