How to configure a network proxy for the V2.0 PHP SDK - Alibaba Cloud SDK

En développement logiciel, un proxy agit comme un intermédiaire qui contrôle l'accès à une fonctionnalité ou à une ressource. Il permet de mettre en œuvre des mécanismes tels que la vérification des autorisations, la journalisation des opérations, la mise en cache des données et le chargement différé, sans modifier le code source initial. Cette approche renforce la sécurité de votre programme, améliore ses performances et en facilite la maintenance ainsi que l'évolution. Cette rubrique explique comment configurer un proxy pour le SDK PHP V2.0.

Types de proxy

Le SDK prend en charge les proxy HTTP et HTTPS.

Type de proxy

Description

Proxy HTTP

Définissez le paramètre httpProxy sur l'adresse IP et le port du serveur proxy. Le format attendu est http://<IP address>:<port>. Ce paramétrage s'applique exclusivement aux requêtes utilisant le protocole HTTP.

Proxy HTTPS

Définissez le paramètre httpsProxy sur l'adresse IP et le port du serveur proxy. Le format attendu est http://<IP address>:<port>. Ce paramétrage s'applique exclusivement aux requêtes utilisant le protocole HTTPS.

Remarque

Si le serveur proxy exige une authentification, ajoutez le nom d'utilisateur et le mot de passe avant l'adresse IP. Utilisez alors le format http://<user>:<password>@<IP address>:<port> ou socks5://<user>:<password>@<IP address>:<port>.

Une fois le proxy configuré, utilisez le paramètre noProxy pour spécifier une liste d'adresses à exclure du routage via le proxy. Séparez les adresses par une virgule. Les noms de domaine et les adresses IP sont pris en charge.

Méthodes de configuration du proxy

Remarque

Ordre de priorité de la configuration du proxy, du plus élevé au plus bas : configuration RuntimeOptions, puis configuration Config.

Utilisez la classe AlibabaCloud\Tea\Utils\Utils\RuntimeOptions pour configurer un proxy spécifique à la requête en cours.

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"
]);

Utilisez la classe Darabonba\OpenApi\Models\Config pour appliquer une configuration de proxy à l'ensemble des requêtes.

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"
]);

Références

Pour plus d'informations, consultez Pratiques de configuration de proxy HTTP.