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

search for in the

ftp://> <file://
Last updated: Fri, 20 May 2011

view this page in

http://

https://

http:// -- https://Acceso a URLS en HTTP(s)

Descripción

Permite acceso de lectura a ficheros/recursos mediante HTTP 1.0, utilizando el método GET de HTTP. Junto con la petición, se envía una cabecera Host: para así poder usar hosts virtuales basados en nombres. Si se ha definido un user_agent en el fichero php.ini o en el contexto del flujo, éste se incluirá también en la petición.

El flujo proporciona acceso al cuerpo del recurso; las cabeceras se guardan en la variable $http_response_header.

Si fuera importante conocer la URL del recurso del que procede el documento (tras procesar todas las redirecciones), se deberán procesar todas las cabeceras de respuesta devueltas por el flujo.

Se usará la directiva from en la cabecera From: siempre que esté asignado y no se sobrescriba por Opciones de contexto y parámetros.

Opciones

  • http://ejemplo.com
  • http://ejemplo.com/fichero.php?var1=val1&var2=val2
  • http://usuario:contraseña@ejemplo.com
  • https://ejemplo.com
  • https://ejemplo.com/fichero.php?var1=val1&var2=val2
  • https://usuario:contraseña@ejemplo.com

Opciones

Resumen de la Envoltura
Atributo Permitido
Restringido por allow_url_fopen
Permite Lecturas
Permite Escrituras No
Permite Añadir contenidos No
Permite Lecturas y Escrituras Simultáneas N/A
Permite usar la función stat() No
Permite usar la función unlink() No
Permite usar la función rename() No
Permite usar la función mkdir() No
Permite usar la función rmdir() No

Historial de cambios

Versión Descripción
4.3.7 Detectado errores en servidores IIS para evitar "SSL: Fatal Protocol Error".
4.3.0 Añadido https://.
4.0.5 Añadido soporte para las redirecciones.

Ejemplos

Example #1 Detectar la URL en la que se finaliza tras las redirecciones

<?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) {

    
/* ¿Dónde se ha redirigido? */
    
if (substr(strtolower($response), 010) == 'location: ') {

        
/* actualizar la $url a la que nos han redirigido */
        
$url substr($response18);
    }

}

?>

Example #2 Enviando cabeceras personalizadas en una petición HTTP

Pueden enviarse cabeceras personalizadas en una petición HTTP aprovechando un efecto colateral de la directiva INI user_agent. Establezca un string válido en user_agent (como el valor por omisión de PHP/versión) seguido de un par retorno de carro/salto de línea y cualquier otra cabecera adicional. Este método funciona en PHP 4 o superior.

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

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

Como resultado se envía la siguiente cabera:

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

Notas

Note: Sólo habrá soporte para HTTPS cuando la extensión openssl esté habilitada.

Las conexiones HTTP son de sólo lectura; no hay soporte para escribir o copiar datos a un recurso HTTP.

Se pueden enviar peticiones POST y PUT, por ejemplo, con ayuda de los Contextos HTTP.

Ver también



ftp://> <file://
Last updated: Fri, 20 May 2011
 
add a note add a note User Contributed Notes http://
Nick Lewis 26-Jun-2008 11:17
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);
spazdaq 24-Oct-2007 10:27
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.
NEA at AraTaraBul dot com 29-Jul-2007 11:06
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;
}
?>
Sinured 28-Jun-2007 10:24
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');
?>
dwalton at acm dot org 17-Nov-2006 08:18
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.

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