WordPress为特定域名的 HTTP 请求自动设置代理

以下是对 WordPress 中为特定 HTTP 请求自动设置代理 功能的详细整理，包括用途、使用场景、扩展性说明以及完整代码注释说明。

📌 功能介绍：为特定域名的 HTTP 请求自动设置代理（WordPress）

✨ 用途：

在某些场景下，WordPress 插件或主题可能会请求外部 API（如 OpenAI），但由于网络限制或 DNS 阻断，部分 API 无法直接访问。此功能的作用就是：

• ✅ 自动检测目标域名；

• ✅ 仅为特定域名请求设置代理（SOCKS5 或 HTTP）；

• ✅ 保证其他请求不受影响；

• ✅ 支持 灵活扩展多个域名 + 多种代理类型配置。

🧪 使用场景举例：

✅ 推荐写法（可扩展的代理规则）

add_action('http_api_curl', function($handle, $r, $url) {
    // 可配置的代理规则表（可扩展多个）
    $proxy_rules = [
        'api.openai.com' => [
            'proxy' => '43.143.133.170:端口号',
            'type'  => CURLPROXY_SOCKS5_HOSTNAME, // 支持解析域名的 SOCKS5
        ],
        // 举例：扩展第二个代理规则
        // 'api.another.com' => [
        //     'proxy' => '127.0.0.1:1080',
        //     'type'  => CURLPROXY_SOCKS5,
        // ],
    ];

    foreach ($proxy_rules as $domain => $settings) {
        if (strpos($url, $domain) !== false) {
            curl_setopt($handle, CURLOPT_PROXY, $settings['proxy']);
            curl_setopt($handle, CURLOPT_PROXYTYPE, $settings['type']);
            break;
        }
    }
}, 10, 3);

🧾 配置说明：

在 $proxy_rules 中设置每一个需要代理的目标域名及其配置。

'api.openai.com' => [
    'proxy' => '43.143.133.170:端口号',         // 代理 IP 与端口
    'type'  => CURLPROXY_SOCKS5_HOSTNAME,      // 支持域名的 SOCKS5（推荐）
],

支持的代理类型（CURLOPT_PROXYTYPE 对应的 PHP 常量）：

✅ 简洁版本（仅用于 OpenAI）

如果你只需要为 api.openai.com 设置代理，可以使用以下简化版本：

add_action('http_api_curl', function($handle, $r, $url) {
    if (strpos($url, 'api.openai.com') !== false) {
        curl_setopt($handle, CURLOPT_PROXY, '43.143.133.170:55970');
        curl_setopt($handle, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5_HOSTNAME);
    }
}, 10, 3);

💡 说明总结：

• 📌 这个钩子 http_api_curl 只影响通过 wp_remote_get() / wp_remote_post() / wp_remote_request() 发出的请求；

• 💬 适合用于插件、主题中需要访问外部接口（如 AI、地图、天气、支付等）的网络请求；

• 🔒 不会影响浏览器端访问，仅限 WordPress 服务器发出的 HTTP 请求。