如何在 Guzzle 中使用代理 ｜2026 分步指南

TL;DR

• Guzzle接受代理URL，可以作为客户端默认设置或作为每个请求的选项。 当每个请求都应遵循一个路由时使用客户端默认设置；当只有选定的调用需要代理时使用请求选项。
• 经过身份验证的代理URL可以包含方案、用户名、密码、主机和端口。 将该URL存储在环境支持的秘密存储中，而不是将其提交到PHP源代码中。
• Guzzle的proxy选项的数组形式将单独的端点映射到HTTP和HTTPS，并支持一个no绕过列表。 如果自己提供数组，则将NO_PROXY解析到no值中。
• 代理轮换可以在提供商网关或您的应用程序中发生。 提供商端轮换保持PHP代码简单；应用程序端轮换让您可以明确选择端点和跟踪故障。
• 成功的HTTP状态不足以证明代理处于活动状态。 验证观察到的出口IP，验证响应正文，并将连接失败记录与目标服务器错误分开。

什么是Guzzle代理？

Guzzle代理是一个中介端点，Guzzle使用它在HTTP请求到达目的地之前发送请求。代理查看外部连接，转发请求，并将目的地响应返回给您的PHP应用程序。实际上，Guzzle仍然构建请求并暴露响应，而代理决定网络路由和可见的源IP。

此功能源自Guzzle的proxy请求选项，而不是来自单独的插件。官方Guzzle代理选项文档接受每种协议一个代理URL或一个关联数组用于协议特定的路由。该URL可以包含身份验证凭据。此设计适用于私有网关，例如Nstdata Residential Prime Proxies、内部公司代理或本地调试代理。

代理改变网络路径；它并不能使每个请求有效或授权。您的应用程序仍然需要合理的超时、状态检查、模式验证，以及遵守目标的条款和适用法律。有关更广泛的PHP级说明，请参见Nstdata的PHP代理设置指南。

为什么要在Guzzle中使用代理？

在Guzzle中使用代理非常有用，当PHP服务必须控制请求的来源、分离流量类别、测试本地响应或使用受管理的出口路由时。常见的授权案例包括QA、广告验证、价格监控、公共数据收集和网络测试。

路由决策应与工作负载匹配。稳定的会话可以帮助当多个调用属于一个逻辑工作流时，而轮换的路由可以在提供商管理的池中分配独立的请求。IP轮换描述了路由模式，但它并不能替代应用程序级别的速率限制或响应验证。

Guzzle仍然负责围绕路由的HTTP行为。客户端可以强制连接和总超时，默认情况下在HTTP错误时抛出异常，并暴露传输统计信息。这些控制有助于区分代理连接失败与目标返回的有效403、429或500响应。

先决条件

您需要PHP、Composer、当前的Guzzle包、一个授权测试URL和一个或多个代理URL。目前的Guzzle库推荐使用Composer安装，而Packagist的Guzzle包页面列出了每个版本的支持PHP约束。