Saltar al contenido

Función header() de PHP: Todo lo que necesitas saber

Como desarrollador de PHP, es posible que necesites manipular encabezados HTTP en tu aplicación web. La función header() es una herramienta poderosa que te permite establecer encabezados HTTP en tus scripts de PHP. En esta guía, cubriremos la sintaxis, los parámetros clave y los casos de uso comunes de la función header().

¿Qué es la función header()?

La función header() es una función integrada de PHP que te permite enviar encabezados HTTP sin procesar al cliente.

Cómo usar la función header()

Usar la función header() es sencillo. Aquí tienes la sintaxis de la función:

La sintaxis de PHP de la función header()

php
header(string $header, bool $replace = true, int $response_code = 0);

La función acepta tres parámetros:

  • string: La cadena del encabezado que se enviará.
  • replace: Un valor booleano que indica si se deben reemplazar los encabezados anteriores con el mismo nombre. El valor predeterminado es true.
  • code: El código de respuesta HTTP que se enviará. El valor predeterminado es 200 (o 0 en PHP moderno).

Importante: La función header() debe llamarse antes de enviar cualquier salida al navegador (incluyendo HTML, espacios en blanco o sentencias echo). Si ya se ha enviado salida, PHP generará una advertencia de "Encabezados ya enviados". Puedes verificar si los encabezados se han enviado usando headers_sent(), o usar el almacenamiento en búfer de salida (ob_start()) para retrasar la salida.

Aquí tienes un ejemplo de cómo usar la función header() para establecer un encabezado HTTP:

¿Cómo usar la función header()?

php
<?php

header("Content-Type: application/json");

En este ejemplo, establecemos un encabezado HTTP llamado Content-Type con el valor application/json. Este encabezado se enviará al cliente cuando se ejecute el script.

También puedes usar los parámetros replace y code para enviar redirecciones o códigos de estado personalizados:

php
<?php

// Send a 301 Moved Permanently redirect
header("Location: https://example.com", true, 301);

Conclusión

La función header() es una herramienta poderosa para manipular encabezados HTTP en tu aplicación web PHP. Al comprender su sintaxis, parámetros y el requisito de llamarla antes de generar salida, puedes gestionar eficazmente redirecciones, tipos de contenido y códigos de estado en tus scripts.

Práctica

¿Qué hace la función header de PHP?

¿Te resulta útil?

Vista previa dual-run — compárala con las rutas Symfony en producción.