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 quatre adaptateurs :

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().

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.

// Définit des paramètres de configuration
$config = array(
    'adapter'      => '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)

// Array of options
$options = array(
    'socket' => array(
        // Bind local socket side to a specific interface
        'bindto' => '10.1.2.3:50505'
    ),
    'ssl' => array(
        // Verify server side certificate,
        // do not accept invalid or self-signed SSL certificates
        'verify_peer' => true,
        'allow_self_signed' => false,

        // Capture the peer's certificate
        'capture_peer_cert' => true
    )
);

// Create an adapter object and attach it to the HTTP client
$adapter = new Zend_Http_Client_Adapter_Socket();
$client = new Zend_Http_Client();
$client->setAdapter($adapter);

// Method 1: pass the options array to setStreamContext()
$adapter->setStreamContext($options);

// Method 2: create a stream context and pass it to setStreamContext()
$context = stream_context_create($options);
$adapter->setStreamContext($context);

// Method 3: get the default stream context and set the options on it
$context = $adapter->getStreamContext();
stream_context_set_option($context, $options);

// Now, preform the request
$response = $client->request();

// If everything went well, you can now access the context again
$opts = stream_context_get_options($adapter->getStreamContext());
echo $opts['ssl']['peer_certificate'];

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' :

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.

// Paramètres de configuration
$config = array(
    'adapter'    => '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.

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.

$config = array(
    'adapter'   => '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 and it also accepts the same configuration parameters as the Socket and Proxy adapters. You can also 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. You can get access to the Curl handle by calling $adapter->getHandle();

$putFileSize   = filesize("filepath");
$putFileHandle = fopen("filepath", "r");

$adapter = new Zend_Http_Client_Adapter_Curl();
$client = new Zend_Http_Client();
$client->setAdapter($adapter);
$adapter->setConfig(array(
    'curloptions' => array(
        CURLOPT_INFILE => $putFileHandle,
        CURLOPT_INFILESIZE => $putFileSize
    )
));
$client->request("PUT");

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.

// Création de l'adatateur et de l'objet client :
$adapter = new Zend_Http_Client_Adapter_Test();
$client = new Zend_Http_Client('http://www.example.com', array(
    'adapter' => $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" .
    '<?xml version="1.0" encoding="UTF-8"?>' .
    '<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"' .
    '     xmlns:wfw="http://wellformedweb.org/CommentAPI/"' .
    '     xmlns:dc="http://purl.org/dc/elements/1.1/">' .
    '  <channel>' .
    '    <title>Premature Optimization</title>' .
    // etc....
    '</rss>');

$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.

// Création des objets adaptateur, et client
$adapter = new Zend_Http_Client_Adapter_Test();
$client = new Zend_Http_Client('http://www.example.com', array(
    'adapter' => $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" .
    '<html>' .
    '  <head><title>Moved</title></head>' .
    '  <body><p>This page has moved.</p></body>' .
    '</html>');

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

// 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.

If you need the adapter to fail on demand you can use setNextRequestWillFail($flag). The method will cause the next call to connect() to throw an Zend_Http_Client_Adapter_Exception exception. This can be useful when your application caches content from an external site (in case the site goes down) and you want to test this feature.

// Instantiate a new adapter and client
$adapter = new Zend_Http_Client_Adapter_Test();
$client = new Zend_Http_Client('http://www.example.com', array(
    'adapter' => $adapter
));

// Force the next request to fail with an exception
$adapter->setNextRequestWillFail(true);

try {
    // This call will result in a Zend_Http_Client_Adapter_Exception
    $client->request();
} catch (Zend_Http_Client_Adapter_Exception $e) {
    // ...
}

// Further requests will work as expected until
// you call setNextRequestWillFail(true) again

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 :

class MyApp_Http_Client_Adapter_BananaProtocol
    implements Zend_Http_Client_Adapter_Interface
{
    /**
     * Définit le tableau de configuration pour cet adaptateur
     *
     * @param array $config
     */
    public function setConfig($config = array())
    {
        // Ceci change rarement, vous devriez copier l'implémentation
        // présente dans Zend_Http_Client_Adapter_Socket.
    }

    /**
     * Connecte à une serveur distant
     *
     * @param string  $host
     * @param int     $port
     * @param boolean $secure
     */
    public function connect($host, $port = 80, $secure = false)
    {
        // Etablit la connexion au serveur
    }

    /**
     * Envoie une requête au serveur
     *
     * @param string        $method
     * @param Zend_Uri_Http $url
     * @param string        $http_ver
     * @param array         $headers
     * @param string        $body
     * @return string Request as text
     */
    public function write($method,
                          $url,
                          $http_ver = '1.1',
                          $headers = array(),
                          $body = '')
    {
        // Envoie la requête au serveur distant. Cette fonction devrait
        // retourner la requête complète (en-tête et corps) as a string
    }

    /**
     * Lit la réponse du serveur
     *
     * @return string
     */
    public function read()
    {
        // Lit la réponse du serveur distant, et la retourne sous forme
        // de chaine de caractères
    }

    /**
     * Ferme la connexion avec le serveur
     *
     */
    public function close()
    {
        // Ferme la connexion, appelée en dernière.
    }
}

// Maintenant, vous pouvez utiliser cet adaptateur :
$client = new Zend_Http_Client(array(
    'adapter' => 'MyApp_Http_Client_Adapter_BananaProtocol'
));