如何为所有Curl请求（含Symfony HttpBrowser、Guzzle）配置全局代理？

一、为什么Shell别名无效？ #

你之前设置的Shell别名仅对控制台直接执行的curl命令生效，PHP的Curl扩展是直接调用底层的libcurl库，不会经过Shell解析，所以别名对它完全不起作用。

二、方案1：PHP全局注入（覆盖所有PHP脚本的Curl请求） #

这种方式会让所有PHP代码里的Curl请求（包括Guzzle、Symfony HttpBrowser底层调用的Curl）自动使用代理，适合需要全局生效的场景：

1. 创建一个全局前置脚本，比如/usr/local/php/proxy_init.php，内容如下：

<?php
// 初始化Curl默认代理配置
$defaultCurlOpts = [
    CURLOPT_PROXY => 'https://xxx.xxx.xxx.xxx:xxxx',
    // 如果代理需要用户名密码认证，取消下面两行注释
    // CURLOPT_PROXYUSERPWD => '你的代理用户名:密码',
    // CURLOPT_PROXYAUTH => CURLAUTH_BASIC
];

// 将默认选项应用到所有新创建的Curl句柄
curl_setopt_array(curl_init(), $defaultCurlOpts);

2. 修改php.ini文件，添加或修改auto_prepend_file配置：

auto_prepend_file = /usr/local/php/proxy_init.php

3. 重启PHP-FPM或Web服务器（比如Apache/Nginx），让配置生效。

三、方案2：框架/库层面全局配置（针对Guzzle和Symfony HttpBrowser） #

如果只需要在特定框架内生效，可以单独配置：

针对Guzzle #

创建一个全局共享的Guzzle客户端实例，所有请求都复用这个实例：

// 在项目的全局初始化文件（比如bootstrap.php）中定义
$guzzleClient = new \GuzzleHttp\Client([
    'proxy' => 'https://xxx.xxx.xxx.xxx:xxxx',
    // 代理认证信息（如果需要）
    // 'proxy' => 'https://用户名:密码@xxx.xxx.xxx.xxx:xxxx'
]);

// 项目中所有发起请求的地方都使用这个$guzzleClient
$response = $guzzleClient->get('https://目标网址');

针对Symfony HttpBrowser #

HttpBrowser基于Symfony HttpClient，直接在Symfony配置文件中全局设置：
编辑config/packages/framework.yaml，添加HttpClient的默认选项：

framework:
    http_client:
        default_options:
            proxy: 'https://xxx.xxx.xxx.xxx:xxxx'
            # 如需代理认证，添加下面一行
            # proxy_auth: '你的用户名:密码'

保存配置后，Symfony项目中所有通过HttpBrowser或HttpClient发起的请求都会自动使用该代理。

四、方案3：系统级libcurl全局配置（需PHP配合） #

libcurl本身支持全局配置文件，不过PHP的Curl扩展默认不会自动读取，需要额外触发：

1. 创建系统级Curl配置文件/etc/curlrc，添加：

proxy = "https://xxx.xxx.xxx.xxx:xxxx"
# 代理认证（可选）
# proxy-user = "用户名:密码"

2. 在PHP代码中设置Curl选项加载系统配置：

curl_setopt($curlHandle, CURLOPT_PROXY, curl_getinfo($curlHandle, CURLINFO_PROXY));

不过这种方式不如方案1直接，一般不推荐作为全局生效的首选。

内容的提问来源于stack exchange，提问作者Валерий Новожилов