Manual de PHP
Anterior	Apéndice M. Lista de Protocolos/Envolturas Soportadas	Siguiente

HTTP y HTTPS

PHP 3, PHP 4, PHP 5. https:// a partir de PHP 4.3.0

http://example.com
http://example.com/archivo.php?var1=val1&var2=val2
http://usuario:contrasenya@example.com
https://example.com
https://example.com/archivo.php?var1=val1&var2=val2
https://usuario:contrasenya@example.com

Permite acceso de sólo-lectura a archivos/recursos a través de HTTP 1.0, usando el método HTTP GET. Una cabecera Host: es enviada con la petición para gestionar hosts virtuales basados en nombres. Si ha configurado una cadena user_agent usando su archivo ini o en el contexto de secuencia, también ésta será usada en la petición.

Aviso

Cuando se usa SSL, Microsoft IIS violara el protocolo, cerrando la conexion sin mandar un indicador close_notify. PHP avisara de esto con este mensaje "SSL: Fatal Protocol Error", cuando llegue al final de los datos. Una solucion a este problema es bajar el nivel de aviso de errores del sistema para que no incluya advertencias. PHP 4.3.7 y versiones posteriores detectan servidores IIS con este problema y suprime la advertencia. Si usais la funcion fsockopen() para crear un socket ssl://, tendreis que suprimir la advertencia explicitamente.

Las redirecciones han sido soportadas desde PHP 4.0.5; si se encuentra usando una versión anterior, necesitará incluir barras de cierre en sus URLs. Si es importante conocer la URL del recurso del cual proviene su documento (luego de que todas las redirecciones han sido procesadas), necesitará trabajar con la serie de cabeceras de respuesta devueltas por la secuencia.


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

$da = fopen($url, 'r');

/* Antes de PHP 4.3.0, use $http_response_header
   en lugar de stream_get_meta_data() */
$meta_datos = stream_get_meta_data($da);
foreach($meta_datos['wrapper_data'] as $respuesta) {

  /* Fuimos redireccionados? */
  if (substr(strtolower($respuesta), 0, 10) == 'location: ') {
    /* actualizar $url con la ubicacion desde donde fuimos
       redireccionados */
    $url = substr($respuesta, 10);
  }

}

?>

La secuencia permite acceso al cuerpo del recurso; las cabeceras son almacenadas en la variable $http_response_header. A partir de PHP 4.3.0, las cabeceras están disponibles mediante el uso de stream_get_meta_data().

Las conexiones HTTP son de sólo-lectura; no puede escribir datos o copiar archivos hacia un recurso HTTP.

Nota: HTTPS es soportado a partir de PHP 4.3.0, si ha compilado el soporte para OpenSSL.

Tabla M-2. Resumen de Envoltura

Atributo	Soporte
Restricción por allow_url_fopen.	Si
Permite Lectura	Si
Permite Escritura	No
Permite Adición	No
Permite Lectura y Escritura Simultánea	N/D
Soporte stat()	No
Soporte unlink()	No
Soporte rename()	No
Soporte mkdir()	No
Soporte rmdir()	No

Tabla M-3. Opciones de contexto

Nombre	Uso	Predeterminado
`method`	`GET`, `POST`, u otro método HTTP soportado por el servidor remoto.	`GET`
`header`	Cabeceras adicionales a ser enviadas durante la petición. Los valores en esta opción sobrescribirán otros valores (tales como `User-agent:`, `Host:`, y `Authentication:`).
`user_agent`	Valor a enviar con la cabecera User-Agent:. Este valor solo será usado si user-agent no es especificado en la opción de contexto `header` anterior.	Parámetro `php.ini`: `user_agent`
`content`	Datos adicionales a ser enviados después de las cabeceras. Típicamente usados con peticiones POST o PUT.
`proxy`	URI que especifica la dirección del servidor proxy. (p.ej. `tcp://proxy.example.com:5100` ).
`request_fulluri`	Cuando es definido como `TRUE`, la URI completa será usada a la hora de construir la petición. (Es decir, `GET http://www.example.com/ruta/hacia/archivo.html HTTP/1.0`). Aunque éste es un formato de petición no-estándar, algunos servidores proxy lo requieren.	`FALSE`
`max_redirects`	El número máximo de redirecciones a seguir. Agregada en PHP 5.1.0.	20

Opciones de contexto de las secuencias de socket interno: Puede que se soporten opciones de contexto adicionales por el transporte implícito. Para secuencias http://, refiérase a las opciones de contexto para el transporte tcp://. Para secuencias https://, refiérase a las opciones de contexto del transporte ssl://.

Anterior	Inicio	Siguiente
Socket	Subir	FTP y FTPS