Options de contexte HTTP

Options de contexte HTTPListe 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.

header cha�ne de caract�res

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'URI enti�re sera utilis�e lors de la construction de la requ�te. (i.e. GET http://www.example.com/path/to/file.php 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 redirection � suivre. La valeur 1 ou inf�rieure signifie qu'aucune redirection ne sera suivie.

Par d�faut, vaut 20.

protocol_version nombre d�cimal

Version du protocole HTTP.

Par d�faut, vaut 1.0.

Note: Dans les versions ant�rieures � 5.3.0, PHP n'impl�mente pas le d�codage du transfert. Aussi, si la valeur est d�finie � 1.1, il est de votre responsabilit� d'�tre conforme � 1.1.

timeout nombre d�cimal

D�lai maximal d'attente pour la lecture, sous la forme d'un nombre d�cimal (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

Historique

Version Description
5.3.0 Le param�tre protocol_version support les transfert chunked lorsqu'on lui assigne la valeur 1.1.
5.2.10 Ajout du param�tre ignore_errors .
5.2.1 Ajout du param�tre timeout .
5.2.10 Le param�tre header peut d�sormais �tre un tableau index� num�riquement.
5.1.0 Ajout la possibilit� d'utiliser des proxy HTTPS via des proxy HTTP.
5.1.0 Ajout du param�tre max_redirects .
5.1.0 Ajout du param�tre protocol_version .

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