¿Qué es el error 'Cannot modify header information' en PHP?

El error Cannot modify header information - headers already sent by... es uno de los problemas más comunes a los que se enfrentan los desarrolladores web al trabajar con PHP. Ocurre cuando el script intenta enviar cabeceras HTTP (utilizando funciones como header(), setcookie() o session_start()) después de que el servidor ya ha comenzado a enviar el cuerpo de la respuesta HTML al navegador.

Principales causas del error

Comprender el origen del problema es fundamental para evitar que vuelva a suceder en futuros proyectos. Las causas más frecuentes incluyen:

• Espacios en blanco o saltos de línea antes de la etiqueta de apertura <?php o después de la de cierre ?>.
• Salida impresa previa mediante funciones como echo, print o var_dump antes de llamar a header().
• Archivos guardados con codificación UTF-8 con BOM (Byte Order Mark), que añade caracteres invisibles al inicio del archivo.
• Errores o advertencias (warnings/notices) de PHP que se muestran directamente en pantalla antes de enviar las cabeceras.

Métodos para solucionar el error paso a paso

A continuación, te mostramos los métodos más efectivos para corregir este fallo de forma definitiva en tu aplicación web.

Método 1: Eliminar espacios en blanco y marcas BOM

Revisa el archivo donde se genera el error y asegúrate de que no existan espacios ni líneas vacías antes de <php. Además, verifica la codificación de tus archivos de script:

1. Abre tu archivo PHP en un editor de código avanzado como VS Code o Sublime Text.
2. Cambia la codificación del archivo de UTF-8 with BOM a UTF-8 (sin BOM).
3. Elimina cualquier espacio en blanco o salto de línea ubicado antes de la apertura de PHP o después del cierre.

Método 2: Utilizar el almacenamiento en búfer de salida (Output Buffering)

El búfer de salida almacena temporalmente toda la salida generada por el script en lugar de enviarla inmediatamente al navegador, permitiendo modificar las cabeceras en cualquier momento del código:

1. Abre tu archivo de configuración principal, como index.php o functions.php.
2. Añade la función ob_start(); al inicio absoluto del script, justo después de abrir la etiqueta PHP: <?php ob_start(); ?>.
3. Coloca ob_end_flush(); al final del archivo si es necesario para vaciar y enviar el búfer acumulado.

Método 3: Depurar salidas accidentales

A veces, archivos incluidos mediante include o require imprimen contenido por error:

1. Revisa las rutas de inclusión y asegúrate de que los archivos llamados no contengan sentencias echo prematuras.
2. Desactiva temporalmente la visualización de errores en entornos de producción modificando el archivo php.ini con la directiva display_errors = Off para evitar que las advertencias rompan las cabeceras HTTP.