Zend Framework 1.10.9 Manual

Le constructeur de classe accepte deux paramètres : l'URI (ou un objet Zend_Uri_Http), et un tableau ou un objet Zend_Config d'options de configuration. Ils peuvent aussi être définis avec des méthodes plus tard : setUri() et setConfig().

$client = new Zend_Http_Client('http://example.org', array(
    'maxredirects' => 0,
    'timeout'      => 30));

// OU
$client = new Zend_Http_Client();
$client->setUri('http://example.org');
$client->setConfig(array(
    'maxredirects' => 0,
    'timeout'      => 30));

// You can also use a Zend_Config object to set the client's configuration
$config = new Zend_Config_Ini('httpclient.ini, 'secure');
$client->setConfig($config);

Note:

Zend_Http_Client utilise Zend_Uri_Http pour valider les URLs. Ce qui veut dire que certains caractères comme les pipes ("|") ou le symbole "^" ne seront pas acceptés par défaut dans les URLs. Ceci peut être modifié par le réglage de l'option "allow_unwise" de Zend_Uri à TRUE. Voir Autoriser les caractères "imprudents" dans les URIs pour de plus amples informations.

Le constructeur et setConfig() acceptent un tableau associatif de paramètre de configuration, ou un objet Zend_Config. Fixer ces paramètres est optionnel, ils ont tous une valeur par défaut.

Exécuter des requêtes HTTP basiques est très simple grâce à la méthode request(), et ceci nécessite rarement plus d'une ligne de code :

$client = new Zend_Http_Client('http://example.org');
$response = $client->request();

Si aucune méthode de requêtage HTTP n'est définie, alors la dernière utilisée via setMethod() sera utilisée. Si setMethod() n'a jamais été appelée, GET est alors utilisée par défaut.

// requête POST
$response = $client->request('POST');

// autre manière de faire :
$client->setMethod(Zend_Http_Client::POST);
$response = $client->request();

Ajouter des paramètres GET à la requête HTTP est très simple. Vous pouvez les ajouter en tant que partie de l'URL désirée, ou en utilisant la méthode setParameterGet(). Celle-ci prend en premier paramètre le nom du paramètre GET, et en second sa valeur. Un tableau associatif peut aussi être utilisé.

// Avec la méthode setParameterGet
$client->setParameterGet('knight', 'lancelot');

// Ce qui est équivalent à :
$client->setUri('http://example.com/index.php?knight=lancelot');

// Ajout de plusieurs paramètres en un appel
$client->setParameterGet(array(
    'first_name'  => 'Bender',
    'middle_name' => 'Bending'
    'made_in'     => 'Mexico',
));

Coté POST, c'est très similaire à GET, sauf que les paramètres POST doivent faire partie du corps de la requête. Il n'est donc pas possible de les ajouter dans l'URL. Utilisez simplement setParameterPost() de la même manière que sa soeur setParameterGet().

// passage de paramètre POST simple
$client->setParameterPost('language', 'fr');

// Plusieurs paramètres, dont un avec plusieurs valeurs
$client->setParameterPost(array(
    'language'  => 'es',
    'country'   => 'ar',
    'selection' => array(45, 32, 80)
));

Zend_Http_Client fournit un moyen d'accéder à la dernière requête qu'il a effectuée, ainsi qu'à la dernière réponse qu'il a reçue. Zend_Http_Client->getLastRequest() ne prends pas de paramètres et retourne la dernière requête sous forme de chaîne de caractères. Zend_Http_Client->getLastResponse() retourne elle la dernière réponse, mais sous forme d'objet Zend_Http_Response.