If anyone doesn't understand the purpose of these values and is scratching their head, they're all array indexes, and are used as the $option parameter to the various HTTP functions documented in this section. For example:
<?php
$body = http_get('http://example.com/private_area/', array(httpauth => 'username:password'));
print $body;
?>
This only had me "...huh?!" for a little while, but might have others confused for longer as the fact that these are what they are isn't clearly printed anywhere... to find out that these did what they say they do was a guessing game for me even.
-dav7
Options utilisables avec la classe HttpRequest et les fonctions relatives
-
Options relatives aux délais d'expiration
- timeout (entier)
- durée maximale en secondes pendant laquelle la demande en entière peut terminer son action
- connecttimeout (entier)
- durée maximale en secondes pour se connecter. Incluant la résolution du nom
- dns_cache_timeout (entier)
- durée maximale en secondes avant de faire expirer une entrée DNS du cache
-
Options relatives aux URL
- url (chaîne de caractères)
- l'URL de la demande
- port (entier)
- utilise un autre port que celui spécifié dans l'URL
- redirect (entier)
- si l'on doit effectuer une redirection et combien l'on doit suivre ; par défaut, 0
- unrestrictedauth (booléen)
- si l'on doit continuer d'envoyer des identifiants lors des redirections vers un hôte différent
- referer (chaîne de caractères)
- l'URL référante à envoyer
-
Options associées aux cookies
- encodecookies (booléen)
- si les cookies personnalisés doivent être url-encodés avant l'envoi
- cookies (array)
- liste des cookies, sous la forme d'un tableau associatif , sous cette forme : array("cookie" => "value")
- cookiestore (chaîne de caractères)
- chemin vers un fichier où les cookies sont/seront stockés
- cookiesession (booléen)
-
si vaut
TRUE, ne charge pas les cookies de session depuis le magasin de cookies
-
Options relatives aux en-têtes
- useragent (chaîne de caractères)
- l'agent utilisateur à envoyer ; par défaut, PECL::HTTP/x.y.z (PHP/x.y.z); omis si explicitement défini par une chaîne vide
- lastmodified (entier)
- timestamp pour l'en-tête If-(Un)Modified-Since
- etag (chaîne de caractères)
- etag pour l'en-tête If-(None-)Match
- headers (array)
- liste des en-têtes personnalisés, sous la forme d'un tableau : array("header" => "value")
-
Options relatives à l'identification
- httpauth (chaîne de caractères)
- Identification HTTP, au format "user:pass"
- httpauthtype (entier)
- constantes représentant les types d'identification HTTP
- (array)
-
Options relatives aux proxy
- proxyhost (chaîne de caractères)
- hôte du proxy, dans le format "host[:port]"
- proxyport (entier)
- utilise un port différent pour le proxy que celui spécifié dans proxyhost
- proxytype (entier)
- constantes des types de proxy HTTP
- proxyauth (chaîne de caractères)
- identifiant du proxy, au format "user:pass"
- proxyauthtype (entier)
- constantes des types d'identification
-
Options liées au transfert
- compress (booléen)
- si l'on doit demander ou accepter une réponse dont le contenu est encodé gzip/deflate
- resume (entier)
- commence le téléchargement à la position spécifié si le serveur le supporte (indiqué par le code réponse 206)
- range (array)
- tableau de tableaux, chaque contenant deux entiers, spécifiant l'intervalle de téléchargement si le serveur le supporte (indiqué par le code réponse 206) ; uniquement reconnu si l'option "resume" est vide
-
Options qui imposent des limites
- maxfilesize (entier)
- taille maximale de fichier pouvant être téléchargé ; n'a aucun effet, si la taille de l'entité demandé est inconnu (e.g. pages dynamiques avec un encodage de transfert, etc.)
- low_speed_limit (entier)
- la vitesse minimale de transfert qu'une demande réussie peut avoir
- low_speed_time (entier)
- la durée durant laquelle low_speed_limit doit être transféré pour une demande réussie
- max_send_speed (entier)
- vitesse maximale d'envoi, en octets par seconde
- max_recv_speed (entier)
- vitesse maximale de réception, en octets par seconde
-
Options de Callback
- onprogress (callable)
- progression du callback
-
Options réseaux
- interface (chaîne de caractères)
- interface réseau de sortie (ifname, ip ou hostname)
- portrange (array)
- 2 entiers spécifiant la rangée de port de sortie à essayer
-
SSL options
- ssl (array)
-
Note: Les options SSL sont définies via un tableau contenant un nom d'option de demande simple "ssl".
- cert (chaîne de caractères)
- chemin vers le certificat
- certtype (chaîne de caractères)
- type du certificat
- certpasswd (chaîne de caractères)
- mot de passe du certificat
- key (chaîne de caractères)
- chemin vers la clé
- keytype (chaîne de caractères)
- type de la clé
- keypasswd (chaîne de caractères)
- mot de passe pour la clé
- engine (chaîne de caractères)
- moteur ssl à utiliser
- version (entier)
- version ssl à utiliser
- verifypeer (booléen)
- si l'on doit vérifier le pair
- verifyhost (booléen)
- si l'on doit vérifier l'hôte
- cipher_list (chaîne de caractères)
- liste des algorithmes de chiffrements autorisés
- cainfo (chaîne de caractères)
- capath (chaîne de caractères)
- random_file (chaîne de caractères)
- egdsocket (chaîne de caractères)
add a note
User Contributed Notes 2 notes
dav7 dot net at php (reverse) ¶
16 years ago
sandeepone at gmail dot com ¶
12 years ago
If someone looking how to use in OOP's context:
$options = array(
'useragent' => "Firefox (+http://www.firefox.org)", // who am i
'connecttimeout' => 120, // timeout on connect
'timeout' => 120, // timeout on response
'redirect' => 10, // stop after 10 redirects
'referer' => "http://www.google.com"
);
$request = new HttpRequest('http://example.com');
$request->setOptions($options);
$request->send();
