如何在PHP的Selenium WebDriver中添加--proxy-header？

这种代理专属请求头是浏览器与代理服务器之间传递的通信头，并非普通HTTP请求头，无法通过开发者工具手动添加，必须通过Firefox的代理配置或扩展实现，以下是具体方案：

实现方案一：通过Firefox Profile配置代理头 #

利用Firefox的偏好设置直接注入代理头，适用于大部分场景：

use Facebook\WebDriver\Firefox\FirefoxOptions;
use Facebook\WebDriver\Firefox\FirefoxProfile;
use Facebook\WebDriver\Remote\RemoteWebDriver;
use Facebook\WebDriver\Remote\DesiredCapabilities;

// 初始化Firefox Profile
$profile = new FirefoxProfile();

// 配置代理服务器信息（替换为你的代理地址和端口）
$profile->setPreference('network.proxy.type', 1);
$profile->setPreference('network.proxy.http', 'proxy.example.com');
$profile->setPreference('network.proxy.http_port', 8080);
$profile->setPreference('network.proxy.ssl', 'proxy.example.com');
$profile->setPreference('network.proxy.ssl_port', 8080);
$profile->setPreference('network.proxy.no_proxies_on', '');

// 开启代理额外头，并注入自定义代理头
$profile->setPreference('network.proxy.extraHeaders', true);
$profile->setPreference('network.proxy.http_headers', 'X-Header-Value: VALUE');
$profile->setPreference('network.proxy.ssl_headers', 'X-Header-Value: VALUE');

// 将Profile转为Options并配置能力
$options = new FirefoxOptions();
$options->setProfile($profile);

$capabilities = DesiredCapabilities::firefox();
$capabilities->setCapability(FirefoxOptions::CAPABILITY, $options);

// 连接Docker中的Selenium Hub（替换为你的Hub地址）
$driver = RemoteWebDriver::create(
    'http://localhost:4444/wd/hub',
    $capabilities
);

实现方案二：通过Firefox扩展强制注入代理头 #

如果方案一不生效，可通过自定义扩展拦截请求并注入代理头，稳定性更强：

1. 创建扩展文件：

   • manifest.json：

     {
       "manifest_version": 2,
       "name": "Proxy Header Injector",
       "version": "1.0",
       "permissions": ["proxy", "webRequest", "webRequestBlocking", "<all_urls>"],
       "background": {"scripts": ["background.js"]}
     }
     

   • background.js：

     chrome.webRequest.onBeforeSendHeaders.addListener(
       function(details) {
         details.requestHeaders.push({name: "X-Header-Value", value: "VALUE"});
         return {requestHeaders: details.requestHeaders};
       },
       {urls: ["<all_urls>"]},
       ["blocking", "requestHeaders"]
     );
     

2. 将上述文件打包为.xpi格式的扩展包，在PHP中加载：

// 加载本地扩展文件（替换为你的扩展路径）
$profile->addExtension('/path/to/proxy-header-injector.xpi');

注意事项 #

• 普通的addHeader方法仅能添加浏览器向目标服务器发送的请求头，无法作用于代理层面，所以不适用。
• Docker环境中需确保Firefox版本与Selenium WebDriver版本兼容，避免配置失效。

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