Zend_Http_Client - Adaptateurs de connexion

Zend_Http_Client - Adaptateurs de connexion Présentation globale Zend_Http_Client accepte des objets adaptateurs. Ces objets ont la responsabilité de soutenir la connexion vers un serveur, à savoir écrire des requêtes et lire des réponses L'adaptateur peut donc être changé, et même écrit ou réécrit pour correspondre à vos besoins, sans avoir l'obligation de toucher à toute la classe dite "client". Vous vous connectez et manipulez votre connexion toujours de la même manière quelque soit l'adaptateur situé dessous. Actuellement, la classe cliente Zend_Http_Client est fournie avec trois adaptateurs : Zend_Http_Client_Adapter_Socket (défaut) Zend_Http_Client_Adapter_Proxy Zend_Http_Client_Adapter_Test Zend_Http_Client_Adapter_Curl L'objet Zend_Http_Client se voit spécifié un adaptateur via son constructeur avec le tableau d'options, à l'index 'adapter'. Fournissez alors une chaîne représentant la classe d'adaptateur à utiliser (par exemple 'Zend_Http_Client_Adapter_Socket'), ou un objet directement (par exemple new Zend_Http_Client_Adapter_Test). Vous pouvez de même passer un adaptateur plus tard, avec la méthode Zend_Http_Client->setConfig(). Adaptateur Socket L'adaptateur par défaut est Zend_Http_Client_Adapter_Socket. Il est basé sur les fonctions PHP fsockopen() et soeurs. Il ne nécessite donc aucune extension particulière ni option de compilation de PHP. L'adaptateur Socket peut être configuré avec des options, passées par Zend_Http_Client->setConfig() ou au constructeur du client. Zend_Http_Client_Adapter_Socket configuration Paramètre Description Types attendus Valeur par défaut persistent Utilise ou non les connexions TCP persistantes booléen false ssltransport Couche de transport SSL ('sslv2', 'tls') chaîne ssl sslcert Chemin vers le certificat SSL encodé PEM chaîne null sslpassphrase Phrase de passe pour le fichier de certificat SSL chaîne null

Connexions TCP persistantes L'utilisation de connexions TCP persistantes peut potentiellement accélérer vos requêtes HTTP mais n'a, dans la plupart des cas, qu'un petit effet positif et peut surcharger le serveur HTTP auquel vous êtes connecté. Il est recommandé d'utiliser les connexions TCP persistantes seulement si vous vous connectez au même serveur très fréquemment, et que vous êtes sûr que le serveur est capable de gérer un nombre élevé de connections concurrentes. Dans tous les cas vous êtes encouragés à tester l'effet des connections persistantes à la fois sur l'accélération du client et sur la charge du serveur avant d'activer cette option. De plus, quand vous utilisez des connexions persistantes, il est recommandé d'activer l'option "Keep-Alive" décrite dans , sinon les connexions persistantes n'auront que peu ou pas d'effet. HTTPS SSL Paramètres de flux ssltransport, sslcert and sslpassphrase sont seulement appropriées lors de l'utilisation d'HTTPS. Bien que les réglages par défaut du mode SSL fonctionneront pour la plupart des applications, vous pourrez avoir besoin de les changer si le serveur, auquel vous vous connectez, requière un paramétrage particulier du client. Dans ce cas, vous devriez lire les sections sur la couche de transport SSL et ses options à cette adresse. Changer la couche de transport HTTPS 'Zend_Http_Client_Adapter_Socket', 'ssltransport' => 'tls' ); // Instantie un objet client $client = new Zend_Http_Client('https://www.example.com', $config); // Cette requête sera envoyée vers une connexion sécurisée TLS $response = $client->request(); ]]> Le résultat ci-dessus sera similaire à l'ouverture d'une connexion TCP avec la commande PHP suivante : fsockopen('tls://www.example.com', 443) Adaptateur Proxy L'adaptateur Zend_Http_Client_Adapter_Proxy est identique à celui par défaut, Socket, sauf que Proxy se connectera au serveur via un serveur Proxy (mandataire). Cette utilisation peut être rencontrée pour des raisons de performances ou de sécurité. En utilisant l'adaptateur Proxy, quelques paramètres de configuration seront nécessaires en plus du paramètre 'adapter' : Zend_Http_Client paramètres de configuration Paramètre Description Valeurs attendues Valeur par défaut proxy_host Adresse du serveur Proxy chaîne 'proxy.myhost.com' ou '10.1.2.3' proxy_port Port du serveur Proxy entier 8080 (défaut) ou 81 proxy_user nom d'utilisateur pour le Proxy, si requis chaîne 'shahar' ou '' pour aucun (défaut) proxy_pass Mot de passe du Proxy, si requis chaîne 'secret' ou '' pour aucun (défaut) proxy_auth Type d'authentification HTTP du Proxy chaîne Zend_Http_Client::AUTH_BASIC (défaut)

proxy_host devrait toujours être fourni. Si ça n'est pas le cas, alors le client retournera sur une connexion Socket par défaut. proxy_port est par défaut à "8080". proxy_user et proxy_pass ne sont requis que si le serveur Proxy demande une authentification. Si vous remplissez ces options, alors un champ d'en-tête HTTP "Proxy-Authentication" sera ajouté à vos requêtes, via votre client. proxy_auth définit le type d'authentification à utiliser, si le serveur Proxy demande une authentification. Actuellement, seule la méthode "basic" (Zend_Http_Client::AUTH_BASIC) est supportée. Utiliser Zend_Http_Client derrière un serveur Proxy 'Zend_Http_Client_Adapter_Proxy', 'proxy_host' => 'proxy.int.zend.com', 'proxy_port' => 8000, 'proxy_user' => 'shahar.e', 'proxy_pass' => 'bananashaped' ); // Crée l'objet client $client = new Zend_Http_Client('http://www.example.com', $config); // utilisez l'objet client ici ... ]]> Comme déjà dit, si proxy_host n'est pas rempli ou défini en tant que chaîne vide, alors le client utilisera l'adaptateur Socket par défaut. Ceci est utile si le proxy est utilisé optionnellement, ou par intermittence. Adaptateur Test Il est quelque fois difficile de tester une application qui a besoin d'une connexion HTTP. Par exemple, une application qui est en charge de lire un flux RSS aura besoin d'une connexion, qui n'est pas tout le temps disponible. C'est pour cette raison que l'adaptateur Zend_Http_Client_Adapter_Test est présent. Vous pouvez de cette manière écrire vos applications, et lors de la phase de tests, passer votre connexion sur l'adaptateur Test (objet mock). La classe Zend_Http_Client_Adapter_Test possède une méthode supplémentaire, setResponse(). Elle prend en paramètre un objet Zend_Http_Response ou une chaîne. Une fois cet objet de réponse déterminé, l'adaptateur de Test retournera toujours cette réponse, sans effectuer de réelle requête HTTP. Tester avec un objet de réponse HTTP unique $adapter )); // Passage de l'objet de réponse $adapter->setResponse( "HTTP/1.1 200 OK" . "\r\n" . "Content-type: text/xml" . "\r\n" . "\r\n" . '' . '' . ' ' . ' Premature Optimization' . // etc.... ''); $response = $client->request('GET'); // ... continuez à parser $response... ]]> L'exemple ci dessus montre comment préconfigurer la réponse qui sera retournée lors d'une requête de votre objet client. Ainsi lors des tests, votre application continuera de se comporter normalement, elle aura tout simplement été trompée (mock). Aucune connexion HTTP n'est dans ce cas là nécessaire. Quelques fois, plusieurs transactions HTTP peuvent être nécessaires. Une réponse peut demander une redirection, vers une autre. Dans ce cas, utiliser setResponse() toute seule n'est pas possible car il ne sera pas possible de spécifier les réponses suivantes, nécessaires alors à l'application. Tester avec plusieurs réponses HTTP $adapter )); // Configuration de la première réponse attendue $adapter->setResponse( "HTTP/1.1 302 Found" . "\r\n" . "Location: /" . "\r\n" . "Content-Type: text/html" . "\r\n" . "\r\n" . '' . ' Moved' . '

This page has moved.

' . ''); // Configuration des réponses successives $adapter->addResponse( "HTTP/1.1 200 OK" . "\r\n" . "Content-Type: text/html" . "\r\n" . "\r\n" . '' . ' My Pet Store Home Page' . '

...

' . ''); // l'objet $client est prêt à être testé // son comportement est déja configuré ]]> La méthode setResponse() détruit toutes les réponses dans le buffer de Zend_Http_Client_Adapter_Test et définit la première réponse qui sera retournée. La méthode addResponse() définit les réponses suivantes. Les réponses seront rejouées dans leur ordre d'ajout. Dans l'exemple ci-dessus, l'adaptateur est configuré pour un scénario de test de redirections 302. En fonction de votre application, le suivi d'une redirection peut être ou non désiré. Dans notre exemple, nous nous attendons à ce que la redirection soit suivie et nous configurons notre adaptateur de tests pour ceci. La réponse de redirection originelle (302) est définie avec la méthode setResponse(), quant à la réponse non redirigeante (200) suivante, elles est définie avec la méthode addResponse(). Lorsque votre objet client est configuré, vous pouvez l'injecter dans votre application à tester, et voir le résultat et les comportements. The cURL Adapter cURL is a standard HTTP client library that is distributed with many operating systems and can be used in PHP via the cURL extension. It offers functionality for many special cases which can occur for a HTTP client and make it a perfect choice for a HTTP adapter. It supports secure connections, proxy, all sorts of authentication mechanisms and shines in applications that move large files around between servers. Setting cURL options 'Zend_Http_Client_Adapter_Curl', 'curloptions' => array(CURLOPT_FOLLOWLOCATION => true), ); $client = new Zend_Http_Client($uri, $config); ]]> By default the cURL adapter is configured to behave exactly like the Socket Adapter. You can change the cURL options by either specifying the 'curloptions' key in the constructor of the adapter or by calling setCurlOption($name, $value). The $name key corresponds to the CURL_* constants of the cURL extension. Transfering Files by Handle You can use cURL to transfer very large files over HTTP by filehandle. setAdapter($adapter); $adapter->setConfig(array( 'curloptions' => array(CURLOPT_INFILE => $putFileHandle, CURLOPT_INFILESIZE => $putFileSize) )); $client->request("PUT"); ]]> Créer vos propres adaptateurs de connexion Vous pouvez créer vos propres adaptateurs, si vous avez un besoin spécial à utiliser. Par exemple, des possibilités de cache, ou des sockets persistantes. Pour ceci, votre classe d'adaptateur doit implémenter l'interface Zend_Http_Client_Adapter_Interface. L'exemple suivant montre un squelette de classe. Toutes les méthodes publiques, ici, sont indispensables à la classe, elles sont issues de l'interface : Création de votre propre adaptateur de connexion 'MyApp_Http_Client_Adapter_BananaProtocol' )); ]]>