Options de contexte HTTP
Options de contexte HTTP — Liste des options de contexte HTTP
Description
Options de contexte pour les protocoles http://
et https://.
Options
-
method
chaîne de caractères
-
GET, POST, ou
n'importe quelle autre méthode HTTP supportée par le serveur disant.
Par défaut, vaut GET.
-
En-têtes supplémentaires à envoyer lors de la requête.
Les valeurs de cette option écraseront les autres valeurs
(comme User-agent:, Host:,
et Authentication:).
-
user_agent
chaîne de caractères
-
Valeur à envoyer avec l'en-tête User-Agent:. Cette valeur
ne doit être utilisée que si l'agent utilisateur n'est pas
spécifié dans l'option de contexte header ci-dessus.
Par défaut, la valeur de l'option de configuration
user_agent du fichier
php.ini sera utilisée.
-
content
chaîne de caractères
-
Les données supplémentaires à envoyer après les en-têtes. Typiquement utilisées
lors des requêtes POST ou PUT.
-
proxy
chaîne de caractères
-
URI de l'adresse du proxy. (e.g.
tcp://proxy.example.com:5100).
-
request_fulluri
booléen
-
Lorsque défini à TRUE, l'URO entière sera utilisé lors de la
construction de la requête. (i.e.
GET http://www.example.com/path/to/file.html HTTP/1.0).
Bien que ce format de demande ne soit pas standard, certains serveurs de
proxy le demandent.
Par défaut, vaut FALSE.
-
max_redirects
integer
-
Le nombre maximal de redirections à suivre. La valeur 1
ou inférieure signifie qu'aucune redirection ne sera suivie.
Par défaut, vaut 20.
-
protocol_version
nombre à virgule flottante
-
Version du protocole HTTP.
Par défaut, vaut 1.0.
-
timeout
nombre à virgule flottante
-
Délai maximal d'attente pour la lecture, sous la forme d'un nombre à virgule flottante
(e.g. 10.5).
Par défaut, la valeur de l'option de configuration
default_socket_timeout du fichier
php.ini sera utilisé.
-
ignore_errors
booléen
-
Récupère le contenu même lors de la réception d'un code d'échec.
Par défaut, vaut FALSE
Exemples
Exemple #1 Récupération d'une page et envoi de données POST
<?php
$postdata = http_build_query(
array(
'var1' => 'du contenu',
'var2' => 'doh'
)
);
$opts = array('http' =>
array(
'method' => 'POST',
'header' => 'Content-type: application/x-www-form-urlencoded',
'content' => $postdata
)
);
$context = stream_context_create($opts);
$result = file_get_contents('http://example.com/submit.php', false, $context);
?>
Notes
Note:
Options de contexte du flux sous-jacent
Des options de contexte supplémentaires peuvent être
supportées par le
transport sous-jacent.
Pour les flux http://, référez-vous aux
options de contexte du transport tcp://.
Pour les flux https://, référez-vous aux
options de contexte du transport ssl://.