headerEnviar encabezado sin formato HTTP
&reftitle.description;
voidheaderstringstringboolreplacetrueinthttp_response_codeheader es usado para enviar encabezados HTTP
sin formato. Ver la especificación HTTP/1.1 specification
para más información sobre encabezados HTTP.
Recuerde que header debe ser llamado antes de
mostrar nada por pantalla, etiquetas HTML, líneas en blanco desde un
fichero o desde PHP. Es un error muy común leer código con funciones
como include o require,
u otro tipo de funciones de acceso de ficheros que incluyen espacios o líneas
en blanco que se muestran antes de llamar a la función header.
Sucede el mismo problema cuando se utiliza un solo fichero PHP/HTML.
]]>
&reftitle.parameters;
string
El encabezado en formato cadena.
Existen dos casos especiales en el uso de header. El primero el encabezado que
empieza con la cadena "HTTP/" (las mayúsculas
no son importantes), es utilizado para averiguar el código de status HTTP
a enviar. Por ejemplo, si se tiene Apache configurado para usar
un script en PHP para controlar las peticiones a ficheros no encontrados (usando
la directiva ErrorDocument), querrá asegurarse
de que el script genera el código de status que corresponde.
]]>
El segundo caso especial es el encabezado "Location:" No solamente
envía el encabezado al navegador, sino que también devuelve el
código de status (302) REDIRECT al navegador
a no ser que el código de status 201 o
3xx ya haya sido enviado.
]]>
replace
El parámetro opcional replace indica
cuando el encabezado debe reemplazar un encabezado previo similar o
añadir un segundo encabezado del mismo tipo. Por defecto lo reemplazará,
pero si se pasa &false; como segundo argumento se puede forzar
múltiples encabezados del mismo tipo. Por ejemplo:
]]>
http_response_code
Fuerza el código de respuesta HTTP a un valor específico. Observe que
este parámetro solamente tiene efecto si string
no está vacío.
&reftitle.returnvalues;
&return.void;
&reftitle.changelog;
&Version;&Description;5.1.2
Esta función ahora previene que se pueda enviar más de un encabezado a la vez
como protección en contra de ataques de inyección de encabezados.
&reftitle.examples;
Diálogo de descarga
Si se quiere preguntar al usuario si quiere guardar los datos
que se están enviando, como un fichero PDF generado, puede usarse el encabezado Content-Disposition para
proporcionar un nombre de fichero recomendado y forzar al navegador el mostarar
el diálogo para guardar el fichero.
]]>
Directivas caché
Scripts PHP normalmente generan contenido dinámico que no debe ser puesto
en caché por el navegador cliente o por ningún proxy caché entre el servidor y el
navegador cliente. En muchos proxies y clientes se puede forzar la desactivación
de la caché con:
]]>
Seguramente encontrará que sus páginas no están en caché incluso si
no se usan los encabezados mencionados más arriba. Existen varias opciones
que los usuarios pueden cambiar en sus navegadores para cambiar el comportamiento
por defecto de la caché. Al enviar los encabezados mencionados más arriba, se
sobreescrirán cualquiera de las opciones que intentan guardar en caché lo que
muestre su script.
Adicionalmente, las opciones de configuración de session_cache_limiter y
session.cache_limiter pueden ser usadas para generar automáticamente
encabezados caché cuando se están usando sesiones.
&reftitle.notes;
¬e.network.header.sapi;
Se puede usar búfer de salida para evitar este problema,
procesando en el servidor todo el contenido a mostrar en el navegador antes
de ser enviado. Se puede hacer esto usando
ob_start y ob_end_flush
en el script, o definiendo la directiva output_buffering
en el &php.ini; o
en los ficheros de configuración del servidor.
El encabezado con el status HTTP siempre será el primero a ser enviado
al cliente, sin tener en cuenta si está usando header
con el status en primer lugar o no. El status puede ser sobreescrito
pasando a header un nuevo status
en cualquier momento a no ser que los encabezados HTTP ya hayan sido enviados.
Existe un bug en Microsoft Internet Explorer 4.01 que hace
que no funcione. No existe una solución. También hay un bug
en Microsoft Internet Explorer 5.5 que también sucede lo mismo,
puede ser resuelto actualizando a Service Pack 2 o superior.
Si el modo seguro está habilitado el
uid del script es añadido en realm
del encabezado WWW-Authenticate si se define
este encabezado (usado para autenticación HTTP).
HTTP/1.1 require una URI absoluta como argumento para
Location:
incluyendo el esquema, nombre del host y ruta absoluta, pero
algunos clientes aceptan también URIs relativas. Se puede usar
$_SERVER['HTTP_HOST'],
$_SERVER['PHP_SELF']
y dirname para crear una URI absoluta desde
una relativa:
]]>
El ID de sesión no es pasado con el encabezado Location incluso si session.use_trans_sid está
habilitado. Debe ser pasado manualmente usando la constante
SID.
&reftitle.seealso;
headers_sentsetcookiehttp_response_code
La secciónAutenticación
HTTP