header

header(string $header, [bool $replace], [int $response_code]): void
```php

`header` permite especificar el encabezado HTTP `string` al enviar los ficheros HTML. Consúltese [`HTTP/1.1 Specification`](https://datatracker.ietf.org/doc/html/rfc2616) para obtener más información sobre los encabezados HTTP.

Nunca se olvide que `header` debe ser llamada antes de que se envíe cualquier contenido, ya sea por líneas HTML habituales en el fichero, o por salidas PHP. Un error muy común es leer un fichero con `include` o `require`, y dejar espacios o líneas vacías, que producirán una salida antes de que la función `header` sea llamada. El mismo problema existe con los ficheros PHP/HTML estándar.

## Parámetros

`header`  
El encabezado.

Existen dos encabezados especiales. El primero comienza con la cadena "`HTTP/`" (insensible a mayúsculas/minúsculas), que se utiliza para indicar el estado HTTP a enviar. Por ejemplo, si se ha configurado Apache para utilizar scripts PHP para manejar las peticiones hacia ficheros inexistentes (utilizando la directiva `ErrorDocument`), asegúrese de que el script genere un código de estado correcto.

El segundo tipo de llamada especial es `"Location:"`. No solo devuelve un encabezado al cliente, sino que además envía un estado `REDIRECT` (302) al navegador siempre que no se haya enviado un código de estado `201` o `3xx`.

`replace`  
El argumento opcional `replace` indica si la función `header` debe reemplazar un encabezado previamente enviado, o bien añadir otro encabezado del mismo tipo. Por omisión, un nuevo encabezado sobrescribirá el anterior, pero si se pasa `false` en este argumento, se pueden forzar múltiples encabezados para un mismo tipo de encabezado. Por ejemplo:

`response_code`  
Fuerza el código de respuesta HTTP al valor especificado. Tenga en cuenta que este argumento solo tiene efecto si `header` no está vacío.

## Valores devueltos

No se retorna ningún valor.

## Errores/Excepciones

Cuando falla el intento de enviar un encabezado, `header` genera un error de nivel `E_WARNING`.

## Ejemplos

Caja de descarga

Si se desea que los usuarios reciban una alerta para guardar los ficheros generados, como si se genera un fichero PDF, se puede utilizar el encabezado [Content-Disposition](https://datatracker.ietf.org/doc/html/rfc2183) para proporcionar un nombre de fichero por defecto, a mostrar en el diálogo de guardado.

Directivas concernientes a la caché

Los scripts PHP generan a menudo HTML dinámico, que no debe ser almacenado en caché, ni por el cliente, ni por los proxy intermedios. Se puede forzar la desactivación de la caché de muchos clientes y proxy con:

> [!NOTE]
> Puede darse cuenta de que sus páginas nunca son almacenadas en caché incluso si se utilizan todos los encabezados anteriores. Existe toda una colección de parámetros que los usuarios pueden modificar en su navegador para cambiar el comportamiento por defecto de la caché. Al enviar los encabezados anteriores, se pueden imponer sus propias valores.
>
> Además, los parámetros `session_cache_limiter` y `session.cache_limiter` pueden ser utilizados para generar los encabezados de caché correctos, cuando se utilizan sesiones.

Configurar una cookie

`setcookie` ofrece un medio práctico de configurar cookies. Para definir una cookie con atributos no soportados por `setcookie`, `header` puede ser utilizado.

Por ejemplo, el código siguiente define una cookie que incluye un atributo `Partitioned`.