الكل إلى الكونتنو
01

Erreur « headers already sent » sur WordPress : trouver la ligne fautive et corriger

« Cannot modify header information, headers already sent » vous donne le fichier et la ligne exacts du problème. Voici comment les lire et corriger les quatre causes classiques.

وليد صدفي
4 دقائق للقراءة
مشاركة:

Le message complet ressemble à ceci : Warning: Cannot modify header information, headers already sent by (output started at /chemin/vers/fichier.php:12). Il apparaît souvent avec des symptômes déroutants : impossible de se connecter à l’administration, redirections qui ne se font pas, cookies qui ne s’enregistrent pas, page blanche après un enregistrement. Bonne nouvelle : c’est l’une des erreurs PHP les plus faciles à corriger, parce qu’elle désigne elle-même le coupable.

Ce qui se passe réellement

Une réponse HTTP commence par des en-têtes : redirections, cookies, type de contenu. PHP doit les envoyer avant le moindre caractère de la page. Si quelque chose a déjà été affiché, même un simple espace, les en-têtes sont partis et WordPress ne peut plus rediriger ni poser de cookie. D’où l’échec de la connexion ou des redirections.

Lire « output started at »

Le message contient deux emplacements. Celui qui compte est entre parenthèses, après output started at : c’est le fichier et la ligne qui ont affiché quelque chose trop tôt. L’autre emplacement indique seulement où WordPress a voulu envoyer un en-tête, il est rarement en cause. Ouvrez le fichier cité à la ligne indiquée.

Les quatre causes classiques

Un espace ou une ligne vide autour des balises PHP

La cause numéro un : un espace avant la balise d’ouverture php, ou une ligne vide après la balise de fermeture, dans functions.php ou wp-config.php. La règle moderne est simple : dans un fichier qui ne contient que du PHP, ne mettez pas de balise de fermeture du tout. Supprimez-la, et tout espace qui suivrait disparaît avec elle.

Un BOM invisible en début de fichier

Certains éditeurs enregistrent les fichiers en UTF-8 avec BOM, trois octets invisibles placés au tout début. Pour PHP, ce sont des caractères affichés. Si l’erreur pointe la ligne 1 d’un fichier qui commence pourtant bien par la balise php, réenregistrez-le en UTF-8 sans BOM depuis votre éditeur.

Des erreurs PHP affichées à l’écran

Un simple avertissement PHP affiché dans la page compte comme une sortie et déclenche à son tour headers already sent. En production, les erreurs doivent aller dans un journal, jamais à l’écran :

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Du code qui affiche au mauvais moment

Un plugin ou un thème qui fait un echo dans un hook trop précoce, comme init ou plugins_loaded, affiche du contenu avant les en-têtes. Toute redirection doit se faire avant le moindre affichage, dans le hook template_redirect, suivie d’un exit :

add_action( 'template_redirect', function () {
    if ( ! is_user_logged_in() && is_page( 'espace-client' ) ) {
        wp_safe_redirect( home_url( '/connexion/' ) );
        exit;
    }
} );

Et la mise en tampon de la sortie ?

Activer output_buffering dans la configuration PHP ou appeler ob_start() masque le symptôme : les en-têtes partent alors correctement. C’est acceptable en dépannage d’urgence, pas comme correction. La sortie parasite existe toujours et peut casser une réponse JSON ou un flux RSS.

الأسئلة الشائعة

Je ne peux plus me connecter à l’administration, que faire ?

Corrigez le fichier cité par le message en SFTP. Si c’est le functions.php du thème, renommez temporairement le dossier du thème : WordPress repasse sur un thème par défaut et la connexion revient.

L’erreur est apparue après avoir collé du code trouvé en ligne, pourquoi ?

Ces extraits contiennent souvent leur propre balise de fermeture php suivie d’une ligne vide. Retirez la balise de fermeture à la fin du fichier. Si vous préférez qu’un développeur s’en charge, notre service de maintenance WordPress corrige ce type d’erreur dans la journée.

Besoin d’un développeur pour régler le problème ou éviter qu’il revienne ? Découvrez notre service de maintenance WordPress.

المؤلف

وليد صدفي

Walid Sadfi est le fondateur d'Evolurise, une équipe d'ingénieurs déployés chez ses clients : développement sur mesure (WordPress, Drupal, React, Laravel), agents IA, DevOps et formation des équipes. Fort de 8 ans d'expérience, il accompagne PME et grands comptes, de la compréhension du problème au déploiement de la solution. Il partage sur ce blog des retours de terrain concrets.