إصلاح خطأ "Headers already sent" في PHP: دليل خطوة بخطوة

تعرف على خطأ "Headers already sent": عدوك الجديد (وصديقك)

إذا سبق لك البرمجة بلغة PHP، فبالتأكيد واجهت هذا الخطأ. يظهر فجأة، غالباً في أكثر الأوقات غير المناسبة - عندما تكون على وشك إنهاء السكربت. الرسالة مخيفة، حمراء اللون، وتجعلك تعتقد أن الكود بأكمله معطل. لكن في الحقيقة، هذا واحد من أكثر الأخطاء فائدة في PHP. إنه يعلمك كيفية التعامل الصحيح مع بروتوكول HTTP.

في هذا الدليل التعليمي، سنشرح لماذا يظهر خطأ Headers already sent، وكيفية تشخيصه، والأهم من ذلك، كيفية إصلاحه بشكل نهائي. لن نكتفي بنسخ إجابة من Stack Overflow - بل سنفهم الجوهر. هيا بنا!

ما هي رؤوس HTTP ولماذا يعترض PHP عليها؟

قبل العلاج، يجب فهم التشريح. عندما يرسل PHP الرد إلى المتصفح، يفعل ذلك على مرحلتين:

\n
• أولاً - الرؤوس (headers). هذه معلومات خدمية: نوع المحتوى (Content-Type)، الترميز، الكوكيز، حالة الرد (200 OK، 404 Not Found).
\n
• ثانياً - نص الرد (body). هذا هو HTML نفسه، النص، JSON - ما يراه المستخدم.
\n

المشكلة أن PHP لا يستطيع إرسال الرؤوس بعد أن بدأ في إرسال النص. إذا حاولت استدعاء header() بعد أن قمت بإخراج أي حرف (حتى مسافة)، سيظهر خطأ PHP:

Warning: Cannot modify header information - headers already sent by (output started at /path/to/file.php:12)

هذا هو كل السحر. الخطأ ليس قاتلاً - إنه مجرد تحذير بأن دالة header() لم تعمل. لكن العواقب قد تكون خطيرة: لن يتم تنفيذ إعادة التوجيه، لن يتم تعيين الكوكيز، سيتعطل رد JSON.

أهم 5 أسباب لحدوث هذا الخطأ

دعنا نستعرض السيناريوهات الأكثر شيوعاً. هل تجد نفسك في أحدها؟

1. مسافة أو سطر فارغ قبل <?php

هذا كلاسيكي. تفتح الملف، وقبل علامة الفتح <?php توجد مسافة، سطر فارغ، أو حرف BOM (Byte Order Mark). يعتبر PHP هذا الحرف جزءاً من الإخراج - وتبدأ المشكلة.

// ❌ خطأ: مسافة قبل <?php\n <?php\nheader('Location: /new-page.php');\n?>

// ✅ صحيح: لا توجد أحرف قبل <?php\n<?php\nheader('Location: /new-page.php');\n?>

2. الإخراج عبر echo أو print قبل دالة header()

خطأ منطقي وشائع بين المبتدئين: إخراج شيء أولاً، ثم محاولة إعادة توجيه المستخدم.

<?php\necho "مرحباً بالعالم!";\nheader('Location: /thanks.php'); // ❌ خطأ: تم الإخراج بالفعل\n?>

3. كود HTML قبل كتلة PHP

قد يحتوي الملف على كود مختلط: ترميز HTML أولاً، ثم منطق PHP مع دالة header().

<!DOCTYPE html>\n<html>\n<head>\n    <title>موقعي</title>\n</head>\n<body>\n<?php\nheader('Location: /login.php'); // ❌ خطأ: تم إرسال HTML بالفعل\n?>\n</body>\n</html>

4. أخطاء PHP ودوال مثل var_dump()

قد يقوم السكربت بإخراج تحذيرات أو معلومات تصحيح قبل استدعاء دالة header(). مثلاً، إذا كان display_errors مفعّلاً وقام PHP بإخراج warning.

<?php\nvar_dump($some_variable); // إخراج بيانات\nheader('Content-Type: application/json'); // ❌ خطأ\n?>

5. أحرف غير مرئية في الملفات المضمنة (include/require)

تقوم بتضمين ملف باستخدام include أو require، وفي نهاية هذا الملف يوجد سطر فارغ إضافي أو مسافة بعد علامة الإغلاق ?>.

// config.php\n<?php\n$db_host = 'localhost';\n?>\n // ← هذه المسافة بعد ?> تفسد كل شيء!

كيف تجد مصدر المشكلة: تشخيص خطوة بخطوة

الأهم من ذلك - الخطأ يشير دائماً إلى أين بدأ الإخراج بالضبط. اقرأ الرسالة بعناية