Lorixen.
AR

«headers already sent» بعد تعديل ملف: سطر فارغ أو BOM

باختصار: إذا عدّل أحد ملفاً في موقع PHP، مثل wp-config.php أو functions.php في قالب WordPress، ليضيف جملة عربية أو يغير إعداداً، ثم ظهرت رسالة «Cannot modify header information – headers already sent» أو توقفت عمليات تسجيل الدخول والتحويل، فالسبب غالباً شيء طُبع قبل أن يرسل PHP ترويساته: سطر فارغ، أو مسافة، أو علامة ترتيب البايتات BOM التي تضيفها بعض برامج التحرير في بداية ملفات UTF-8 دون أن تراها. احفظ الملف بترميز UTF-8 دون BOM، واحذف ما قبل علامة فتح PHP وما بعد إغلاقها.

العطل الذي يظهر بعد تعديل صغير

صاحب عيادة في عمّان يطلب من موظف أن يغيّر جملة ترحيب في قالب الموقع. يفتح الموظف ملف القالب عبر مدير الملفات أو ينزله إلى حاسوبه ويعدّله ببرنامج تحرير بسيط، ثم يرفعه. الجملة الجديدة تظهر، لكن فجأة لا يستطيع أحد الدخول إلى لوحة التحكم: صفحة الدخول تعيد تحميل نفسها، أو تظهر في أعلى الصفحة رسالة تحذير بالإنجليزية عن الترويسات، أو صفحة بيضاء. نموذج الحجز يُرسل لكن لا يحوّل إلى صفحة الشكر.

ما الذي حدث؟ الملف المعدّل صار يطبع شيئاً قبل أن يحاول الموقع إرسال الترويسات، حتى لو بدا الملف في المحرر مطابقاً تماماً لما كان عليه.

لماذا الترتيب مهم

كل رد من الخادم يبدأ بالترويسات، ثم المحتوى. الترويسات تحمل أشياء مثل التحويل إلى صفحة أخرى، والكوكيز التي تحفظ تسجيل الدخول، ونوع المحتوى. بمجرد أن يُطبع أي حرف من المحتوى، تُرسل الترويسات، ولا يمكن إضافة غيرها.

يقول دليل PHP في صفحة الدالة header إنها يجب أن تُستدعى قبل إرسال أي مخرجات فعلية، سواء كانت وسوم HTML عادية، أو أسطراً فارغة في ملف، أو مخرجات من PHP. ويضيف أن من الأخطاء الشائعة جداً قراءة كود عبر include أو require فيه مسافات أو أسطر فارغة تُطبع قبل استدعاء header.

تسجيل الدخول يحتاج كوكي، والتحويل بعد الحفظ يحتاج ترويسة. إذا طُبع شيء قبلهما، يفشلان.

علامة BOM الخفية

الأسطر الفارغة والمسافات يمكن رؤيتها إذا انتبهت لها. لكن السبب الأكثر إرباكاً لا يُرى: علامة ترتيب البايتات.

تشرح الأسئلة الشائعة في موقع يونيكود أن هذه العلامة هي المحرف U+FEFF في بداية تدفق البيانات، وأنها في UTF-8 تظهر كالبايتات EF BB BF، وأن استخدامها مع UTF-8 يكون فقط كتوقيع يميز الترميز، ولا علاقة له بترتيب البايتات. بعض برامج التحرير تضيفها تلقائياً عند الحفظ بترميز UTF-8، خاصة عندما يحتوي الملف على حروف عربية، لأن البرنامج يريد أن يتأكد أن الملف سيُقرأ بالترميز الصحيح.

المشكلة أن PHP لا يعرف أن هذه البايتات «توقيع». يراها نصاً قبل علامة الفتح، فيطبعها. ثلاثة بايتات لا تراها في المحرر تكفي لإرسال الترويسات مبكراً.

كيف تكتشفها

  • رسالة التحذير نفسها: إذا ظهرت، فهي تذكر عادة اسم الملف ورقم السطر الذي بدأت فيه المخرجات. إذا كان السطر الأول من ملف عدّلته، فالأرجح أنه BOM أو مسافة قبل علامة الفتح.
  • برنامج تحرير يعرض الترميز: برامج التحرير البرمجية تعرض في شريط الحالة ترميز الملف، وتميز بين UTF-8 وUTF-8 مع BOM. افتح الملف المعدّل وانظر.
  • المقارنة بنسخة سابقة: إذا كان لديك نسخة الملف قبل التعديل، فحجمها أصغر بثلاثة بايتات إذا كانت BOM هي الفرق.

الإصلاح

  1. افتح الملف في برنامج تحرير برمجي.
  2. احفظه بترميز UTF-8 دون BOM. معظم البرامج تتيح ذلك من قائمة الترميز.
  3. تأكد أن السطر الأول يبدأ مباشرة بعلامة فتح PHP، دون أي مسافة أو سطر فارغ قبلها.
  4. في نهاية الملفات التي تحتوي PHP فقط، احذف علامة الإغلاق أصلاً إن وُجدت، أو تأكد أنه لا شيء بعدها. هذه ممارسة شائعة في ملفات PHP الخالصة لتجنب الأسطر الفارغة في النهاية.
  5. ارفع الملف، وجرّب تسجيل الدخول وإرسال النماذج.

أين تحدث كثيراً في WordPress

  • wp-config.php: يعدّله الناس لتغيير إعدادات قاعدة البيانات أو تفعيل وضع التصحيح.
  • functions.php في القالب: يُضاف إليه كود منسوخ من مقالات.
  • ملفات الترجمة أو القوالب المخصصة التي تحتوي نصوصاً عربية.
  • ملفات الإضافات الصغيرة التي كتبها مطور سابق ويعدّلها أحد آخر.

نسخ الكود من المقالات

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

ملفات أخرى يتأثر بها BOM

ليس PHP وحده. ملف CSS يبدأ بـ BOM قد يجعل المتصفح يتجاهل أول قاعدة فيه في بعض الحالات، وملف JSON يبدأ بها قد يرفضه برنامج يقرأه بصرامة، وملف CSV قد يحتاجها أحياناً لتظهر العربية صحيحة في بعض برامج الجداول. أي أن BOM ليست خطأ دائماً، بل تعتمد على من سيقرأ الملف. القاعدة العملية: ملفات الكود على الخادم دون BOM، والملفات المصدّرة لبرامج معينة حسب ما يطلبه ذلك البرنامج.

اجعل التعديلات أكثر أماناً

  • لا تعدّل ملفات الموقع الحي مباشرة. جرّب على نسخة اختبار، أو على الأقل خذ نسخة من الملف قبل التعديل.
  • استخدم قالباً فرعياً للتعديلات على القالب، حتى لا تضيع مع تحديثه، ولتعرف أين التعديلات بالضبط.
  • ضع إعداد الترميز في برنامج التحرير على UTF-8 دون BOM افتراضياً.
  • سجّل من عدّل ماذا ومتى. عند حدوث عطل، أول سؤال: ما آخر ملف تغيّر؟

مثال توضيحي: عيادة بعد تعديل جملة الترحيب

هذا مثال توضيحي لطريقة التشخيص، دون حالة حقيقية. بعد التعديل توقف تسجيل الدخول. يفتح المطور ملف القالب المعدّل في برنامج تحرير برمجي، فيجد أن ترميزه UTF-8 مع BOM. يحفظه دون BOM، ويتأكد أن السطر الأول يبدأ بعلامة فتح PHP، ويرفعه. يعود تسجيل الدخول والتحويل بعد الحجز. ثم ينقل التعديلات إلى قالب فرعي، ويضبط برنامج التحرير على الحفظ دون BOM افتراضياً.

أسئلة شائعة

شو معنى headers already sent؟

أن شيئاً طُبع قبل أن يرسل PHP الترويسات، فلم يعد ممكناً إرسال تحويل أو كوكي. دليل PHP يذكر أن header يجب أن تُستدعى قبل أي مخرجات.

عدلت سطر واحد بس، ليش خرب الموقع؟

قد يكون برنامج التحرير أضاف علامة BOM في بداية الملف عند الحفظ، أو سطراً فارغاً قبل علامة فتح PHP.

كيف بعرف إذا في BOM بالملف؟

افتح الملف في برنامج تحرير برمجي وانظر إلى الترميز في شريط الحالة: UTF-8 أم UTF-8 مع BOM.

ليش الحروف العربية لها علاقة؟

بعض البرامج تضيف BOM عند حفظ ملف فيه حروف غير لاتينية لتحديد الترميز. احفظ بـ UTF-8 دون BOM.

إذا تعطل موقعك بعد تعديل صغير في ملف، راسلنا ونجد السطر المسؤول ونجعل التعديلات القادمة آمنة.

المصادر

WhatsAppاحجز مكالمة