HTTP et HTTPS
PHP 3, PHP 4, PHP 5. https:// depuis PHP 4.3.0
- https://example.com
- https://example.com/file.php?var1=val1&var2=val2
- https://user:motdepasse@example.com
- https://example.com
- https://example.com/file.php?var1=val1&var2=val2
- https://user:motdepasse@example.com
Permet des accès en lecture uniquement, pour des fichiers accessibles sur le réseau avec la méthode GET de HTTP 1.0. Un en-tête Host: est envoyé avec la requête, pour gérer les hôtes virtuels, basés sur des noms. Si vous avez configuré une version de navigateur avec l'option user_agent dans votre fichier php.ini, ou via le contexte de flux, il sera aussi utilisé dans votre requête.
Lorsque vous utilisez SSL, le serveur IIS de Microsoft violera le protocole en fermant la connexion sans envoyer l'indicateur close_notify. PHP le reportera en tant que "SSL: Fatal Protocol Error" quand vous arrivez à la fin des données. L'astuce est de baisser le niveau de la directive error_reporting pour ne pas inclure les warnings. À partir de PHP 4.3.7, le bogue est détecté automatiquement lors de l'ouverture du flux en utilisant https:// et supprimera cet avertissement pour vous. Si vous utilisez fsockopen() pour créer une socket ssl://, vous devez vous occuper vous-même de supprimer l'erreur.
Les redirections sont supportées depuis PHP 4.0.5; si vous utilisez une version plus ancienne, vous devrez ajouter vous-même les slash finaux dans vos URL. S'il est important de connaître l'URL de la ressource qui vous a fourni le document, une fois que toutes les redirections ont été suivies, vous devez analyser les en-têtes de réponses retournés par le flux.
Example#1 https:// et redirections
<?php
$url = 'https://www.example.com/redirecting_page.php';
$fp = fopen($url, 'r');
/* Avant PHP 4.3.0 utilisez $http_response_header
au lieu de stream_get_meta_data() */
$meta_data = stream_get_meta_data($fp);
foreach($meta_data['wrapper_data'] as $response) {
/* Redirections? */
if (substr(strtolower($response), 0, 10) == 'location: ') {
/* modification de $url avec la nouvelle URL */
$url = substr($response, 18);
}
}
?>
Example#2 Analyse une page et envoie des données avec la méthode 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('https://example.com/submit.php', false, $context);
?>
Le flux donne l'accès au corps (body) de la ressource. Les en-têtes sont stockés dans la variable $http_response_header. Depuis PHP 4.3.0, les en-têtes sont aussi accessibles avec la fonction stream_get_meta_data().
Les connexions HTTP sont en lecture seule. Vous ne pouvez pas écrire dans des fichiers ouverts via le protocole HTTP.
Note: HTTPS est supporté depuis PHP 4.3, si vous avez compilé le support d'OpenSSL.
| Attribut | Supporté |
|---|---|
| Limité par allow_url_fopen | Oui |
| Autorisé en lecture | Oui |
| Autorisé en écriture | Non |
| Autorisé en ajout | Non |
| Autorise les lectures / écritures simultanées | Non applicable |
| Supporte stat() | Non |
| Supporte unlink() | Non |
| Supporte rename() | Non |
| Supporte mkdir() | Non |
| Supporte rmdir() | Non |
| Nom | Utilisation | Par défaut |
|---|---|---|
| method | GET, POST, ou une autre méthode HTTP acceptée par le serveur distant. | GET |
| header | Les autres en-têtes envoyés durant la requête. Les valeurs de cette option remplaceront les valeurs déjà configurées (comme User-agent:, Host:, et Authentication:). | |
| user_agent | Valeur à envoyer pour l'en-tête User-Agent:. Cette valeur sera utilisée si un type de navigateur n'est pas spécifié dans l'option de contexte header ci-dessus. | Directive dans le php.ini : user_agent. |
| content | D'autres données envoyées après les en-têtes. Typiquement, utilisé pour placer les requêtes POST ou PUT. | |
| proxy | URI du serveur de proxy. (i.e. tcp://proxy.example.com:5100 ). Les proxys HTTPS (via les proxys HTTP) ne fonctionnent qu'avec PHP 5.1.0 ou supérieur. | |
| max_redirects | Le nombre maximum de redirection à suivre. Une valeur de 1 ou inférieure signifie qu'aucune redirection n'est suivie. Ajouté en PHP 5.1.0. | 20 |
| protocol_version | Version du protocole HTTP. Ajouté en PHP 5.1.0. | 1.0 |
| timeout | Lit de délai maximal en secondes, spécifié par un nombre à virgule flottante (e.g. 10.5). Ajouté en PHP 5.2.1. | default_socket_timeout |
Note: Options de contexte pour les sockets Plusieurs options de contexte supplémentaires sont supportées par le gestionnaire de transport Pour les flux https://, voyez les options de contexte du transport tcp://. Pour les flux https://, voyez les options de contexte du transport ssl://.
Les en-têtes personnalisés peuvent être envoyés avec une requête HTTP dans les versions antérieures à la version 5 en tirant avantage d'un effet de bord dans la gestion de la configuration INI de user_agent. Définissez user_agent en n'importe quelle chaîne valide (comme la chaîne par défaut, PHP/version) suivi d'un caractère de retour chariot et d'un caractère de nouvelle ligne, suivis des en-têtes additionnels. Cette méthode fonctionne en PHP 4 ainsi que toutes les versions suivantes.
Example#3 Envoi d'en-têtes personnalisés avec une requête HTTP
<?php
ini_set('user_agent', "PHP\r\nX-MyCustomHeader: Foo");
$fp = fopen('https://www.example.com/index.php', 'r');
?>
Équivaut à la requête suivante :
GET /index.php HTTP/1.0 Host: www.example.com User-Agent: PHP X-MyCustomHeader: Foo