downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

ftp://> <file://
[edit] Last updated: Fri, 17 May 2013

view this page in

http://

https://

http:// -- https://Accès aux URLs HTTP(s)

Description

Permet des accès, en lecture uniquement, à 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, elle sera aussi inclue dans votre requête.

Le flux permet d'accéder au corps (body) de la ressource. Les en-têtes sont stockés dans la variable $http_response_header.

Si vous avez besoin de connaitre l'URL de la ressource depuis laquelle votre document provient (après l'exécution de toutes les redirections), vous devrez analyser la série d'en-têtes retournés par le flux.

La directive from sera utilisée pour l'en-tête From: si elle a été définie, et non écrasée par les Options et paramètres de contexte.

Options

  • http://example.com
  • http://example.com/fichier.php?var1=val1&var2=val2
  • http://user:password@example.com
  • https://example.com
  • https://example.com/fichier.php?var1=val1&var2=val2
  • https://user:password@example.com

Options

Résumé du gestionnaire
Attribut Supporté
Restreint par allow_url_fopen Oui
Autorise la lecture Oui
Autorise l'écriture Non
Autorise l'ajout Non
Autorise la lecture et l'écriture simultanément N/A
Support de la fonction stat() Non
Support de la fonction unlink() Non
Support de la fonction rename() Non
Support de la fonction mkdir() Non
Support de la fonction rmdir() Non

Historique

Version Description
4.3.7 Détecte les serveurs IIS bogués pour éviter les erreurs "SSL: Fatal Protocol Error".
4.3.0 Ajout de https://.
4.0.5 Ajout du support des redirections.

Exemples

Exemple #1 Détecte la dernière URL après des redirections

<?php
$url 
'http://www.example.com/redirecting_page.php';

$fp fopen($url'r');

$meta_data stream_get_meta_data($fp);
foreach (
$meta_data['wrapper_data'] as $response) {

    
/* Avons-nous été redirigés ? */
    
if (strtolower(substr($response010)) == 'location: ') {

        
/* mise à jour de $url avec le chemin après redirection */
        
$url substr($response10);
    }

}

?>

Exemple #2 Envoi d'en-têtes personnalisés avec une requête HTTP

Des en-têtes personnalisés peuvent être envoyés en utilisant des options de contexte. Il est également possible d'utiliser le contournement suivant : des en-têtes personnalisés peuvent être envoyés avec une requête HTTP en tirant avantage d'un effet de bord dans la gestion de la directive de configuration INI user_agent. Définissez user_agent à n'importe quelle chaîne valide (comme la chaîne par défaut, PHP/version) suivie d'un caractère de retour chariot et d'un caractère de nouvelle ligne, suivis des entêtes additionnels.

<?php
ini_set
('user_agent'"PHP\r\nX-MyCustomHeader: Foo");

$fp fopen('http://www.example.com/index.php''r');
?>

Avec cette portion de code, la requête suivante sera émise :

GET /index.php HTTP/1.0
Host: www.example.com
User-Agent: PHP
X-MyCustomHeader: Foo

Notes

Note: HTTPS n'est supporté que si l'extension openssl est active.

Les connexions HTTP sont en lecture seule ; l'écriture de données ou la copie de fichier vers une ressource HTTP ne sont pas supportés.

L'envoi de requêtes POST et PUT, par exemple, peut être effectué à l'aide des contextes HTTP.

Voir aussi



ftp://> <file://
[edit] Last updated: Fri, 17 May 2013
 
add a note add a note User Contributed Notes http:// - [6 notes]
up
1
dwalton at acm dot org
6 years ago
As it says on this page:

"The stream allows access to the body of the resource; the headers are stored in the $http_response_header variable. Since PHP 4.3.0, the headers are available using stream_get_meta_data()."

This one sentence is the only documentation I have found on the mysterious $http_response_header variable, and I'm afraid it's misleading.  It implies that from 4.3.0 onward, stream_get_meta_data() ought to be used in favor of $http_response_header. 

Don't be fooled!  stream_get_meta_data() requires a stream reference, which makes it ONLY useful with fopen() and related functions.  However, $http_response_header can be used to get the headers from the much simpler file_get_contents() and related functions, which makes it still very useful in 5.x.

Also note that even when file_get_contents() and friends fail due to a 4xx or 5xx error and return false, the headers are still available in $http_response_header.
up
0
Nick Lewis
4 years ago
A note on how to deal with Cookies

To receive a cookie:

$httphandle = fopen($url,"r");
$meta = stream_get_meta_data($httphandle);
for ($j = 0; isset($meta['wrapper_data'][$j]); $j++) {
   $httpline = $meta['wrapper_data'][$j];
   @list($header,$parameters) = explode(";",$httpline,2);
   @list($attr,$value) = explode(":",$header,2);
   if (strtolower(trim($attr)) == "set-cookie") {
      $cookie = trim($value);
      break;
   }
}
fclose($httphandle);
echo $cookie;

To send a cookie:

$user_agent = ini_get("user_agent");
ini_set("user_agent",$user_agent . "\r\nCookie: " . $cookie);
$httphandle = fopen($url,"r");
fclose($httphandle);
ini_set("user_agent",$user_agent);
up
0
spazdaq
5 years ago
just an FYI about digest authentication.

While one of the above http examples has the username and password info supplied with the url, this must only be for basic authentication. it does not appear to work for digest authentication. you have to handle the digest followup request on your own.
up
0
Sinured
5 years ago
If you want to send more than one custom header, just make header an array:

<?php
$default_opts
= array(
   
'http' => array(
       
'user_agent' => 'Foobar',
       
'header' => array(
           
'X-Foo: Bar',
           
'X-Bar: Baz'
       
)
    )
);
stream_context_get_default($default_opts);
readfile('http://www.xhaus.com/headers');
?>
up
-1
gaver at telenet dot be
11 months ago
If you want to communicate between your server and a https server

<?php
$variable
=$_GET['variable'];
$host = "https://user:password@secure site";
$path = "securescript.php";
$url=$host.$path;

$formdata = array ( "variable1" => "10000","variable2" => "02" , "variable3" => "03" );

// get form data in a string
 
foreach($formdata AS $key => $val){
   
$poststring .= urlencode($key) . "=" . urlencode($val) . "&";
  }
// strip off trailing ampersand
$poststring = substr($poststring, 0, -1);
// create a complete nice string
$urlcom= $host.$path."?".$poststring;

// echo $urlcom; // if you want to debug your string

//and you can read out the data in one command... from a secure https server handling login and everything you need
 
$postdataget=file_get_contents($urlcom);
// and yes you can debug the responseheader to view if you have authorization
//  var_dump($http_response_header);

//and if you want to read the data, this is the response from the server
//  var_dump($postdataget);

?>
up
-1
NEA at AraTaraBul dot com
5 years ago
HTTP post function;

<?php
function post_it($datastream, $url) {

$url = preg_replace("@^http://@i", "", $url);
$host = substr($url, 0, strpos($url, "/"));
$uri = strstr($url, "/");

     
$reqbody = "";
      foreach(
$datastream as $key=>$val) {
          if (!empty(
$reqbody)) $reqbody.= "&";
     
$reqbody.= $key."=".urlencode($val);
      }

$contentlength = strlen($reqbody);
    
$reqheader "POST $uri HTTP/1.1\r\n".
                  
"Host: $host\n". "User-Agent: PostIt\r\n".
    
"Content-Type: application/x-www-form-urlencoded\r\n".
    
"Content-Length: $contentlength\r\n\r\n".
    
"$reqbody\r\n";

$socket = fsockopen($host, 80, $errno, $errstr);

if (!
$socket) {
  
$result["errno"] = $errno;
  
$result["errstr"] = $errstr;
   return
$result;
}

fputs($socket, $reqheader);

while (!
feof($socket)) {
  
$result[] = fgets($socket, 4096);
}

fclose($socket);

return
$result;
}
?>

 
show source | credits | sitemap | contact | advertising | mirror sites