Como configurar um proxy de rede para o SDK PHP V2.0 - Alibaba Cloud SDK: Central de Documentação do Alibaba Cloud

No desenvolvimento de software, um proxy atua como intermediário no controle de acesso a funcionalidades ou recursos. Com ele, você implementa verificações de permissão, logs de operação, cache de dados e carregamento tardio sem alterar o código original. Essa abordagem aumenta a segurança do programa, melhora o desempenho e facilita a manutenção e a extensão da aplicação. Este tópico descreve como configurar um proxy para o SDK PHP V2.0.

Tipos de proxy

O SDK oferece suporte a proxies HTTP e HTTPS.

Tipo de proxy	Descrição
Proxy HTTP	Defina o parâmetro `httpProxy` com o endereço IP e a porta do servidor proxy. O formato é `http://<IP address>:<port>`. Essa configuração se aplica apenas a requisições que utilizam o protocolo HTTP.
Proxy HTTPS	Defina o parâmetro `httpsProxy` com o endereço IP e a porta do servidor proxy. O formato é `http://<IP address>:<port>`. Essa configuração se aplica apenas a requisições que utilizam o protocolo HTTPS.

Nota

Se o servidor proxy exigir autenticação, adicione o nome de usuário e a senha antes do endereço IP. Utilize o formato http://<user>:<password>@<IP address>:<port> ou socks5://<user>:<password>@<IP address>:<port>.

Após configurar o proxy, use o parâmetro noProxy para especifique uma lista de endereços que ignoram o proxy. Separe vários endereços por vírgula. Nomes de domínio e endereços IP são suportados.

Métodos de configuração de proxy

Nota

Prioridade de configuração do proxy, da mais alta para a mais baixa: configuração RuntimeOptions, seguida pela configuração Config.

Use a classe AlibabaCloud\Tea\Utils\Utils\RuntimeOptions para configure um proxy específico para a requisição atual.

use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

// Runtime parameter settings. These settings apply only to requests that use these runtime parameters.
$runtime = new RuntimeOptions([
    "httpProxy" => "http://127.0.0.1:8080",
    "httpsProxy" => "https://username:password@proxyServer:port",
    "noProxy" => "127.0.0.1,localhost"
]);

Use a classe Darabonba\OpenApi\Models\Config para configure um proxy aplicável a todas as requisições.

use Darabonba\OpenApi\Models\Config;

$config = new Config([
    "protocol" => 'https', // The request protocol determines which proxy parameter to use. `httpsProxy` applies only to HTTPS requests, and `httpProxy` applies only to HTTP requests.
    // Proxy settings
    "httpProxy" => "http://127.0.0.1:8080",
    "httpsProxy" => "https://username:password@proxyServer:port",
    "noProxy" => "127.0.0.1,localhost"
]);

Referências

Para obter mais informações, consulte Práticas de configuração de proxy HTTP.