代理配置

更新时间:

在软件开发中,代理就像是一个“中间人”,它帮我们控制对某个功能或资源的访问。使用代理可以实现权限检查、记录操作日志、缓存数据、延迟加载等功能,而不用改动原来的代码。这样可以让程序更安全、运行更快,也更容易维护和扩展。本文为您介绍V2.0 PHP SDK代理的配置方式。

代理类型

支持使用HTTP代理和HTTPS代理。

代理类型

描述

HTTP代理

通过参数httpProxy配置代理服务器地址和端口,格式为:http://<IP地址>:<端口>,仅对HTTP协议的请求生效。

HTTPS代理

通过参数httpsProxy配置代理服务器地址和端口,格式为:http://<IP地址>:<端口>,仅对HTTPS协议的请求生效。

说明

若代理服务器要求身份认证才能进行访问,请在IP地址前添加代理服务器配置的用户名和密码,格式为:http://<user>:<password>@<IP地址>:<端口>socks5://<user>:<password>@<IP地址>:<端口>

此外,在配置代理后,也可通过参数noProxy指定无需通过代理访问的地址列表,多个地址之间用逗号分隔,支持域名和IP地址格式。

代理配置方式

说明

代理配置优先级:RuntimeOptions配置 -> Config配置,优先级依次降低。

  • 通过AlibabaCloud\Tea\Utils\Utils\RuntimeOptions类为当前请求配置代理。

    use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
    
    // 运行时参数设置,仅对使用了该运行时参数的请求有效
    $runtime = new RuntimeOptions([
        "httpProxy" => "http://127.0.0.1:8080",
        "httpsProxy" => "https://username:password@proxyServer:port",
        "noProxy" => "127.0.0.1,localhost"
    ]);
     
  • 通过Darabonba\OpenApi\Models\Config类为所有请求配置代理。

    use Darabonba\OpenApi\Models\Config;
    
    $config = new Config([
        "protocol" => 'https', // 请求协议与HTTP代理配置参数有关,httpsProxy仅对https协议有效,httpProxy仅对http协议有效。
        // 代理设置
        "httpProxy" => "http://127.0.0.1:8080",
        "httpsProxy" => "https://username:password@proxyServer:port",
        "noProxy" => "127.0.0.1,localhost"
    ]);
     

相关文档

代理配置相关实践文档,请参见HTTP代理配置实践