Lorixen.
AR

خطأ 419 Page Expired في Laravel: لماذا تضيع نماذج الحجز؟

باختصار: صفحة «419 Page Expired» في موقع مبني بـ Laravel تعني أن النموذج أُرسل دون رمز الحماية الصحيح الذي يتوقعه التطبيق. في كود إطار Laravel نفسه، استثناء عدم تطابق الرمز (TokenMismatchException) يتحول إلى استجابة برمز 419. الأسباب المعتادة: نموذج بلا ‎@csrf‎، أو جلسة انتهت لأن الصفحة بقيت مفتوحة طويلاً، أو صفحة نموذج مخزنة في ذاكرة تخزين مؤقت تحمل رمز زائر آخر، أو طلبات JavaScript لا ترسل الرمز. الحل يبدأ بتحديد أي سبب منها ينطبق على موقعك، لا بإيقاف الحماية.

لماذا يرى زبائنك هذه الصفحة؟

عيادة علاج طبيعي في عمّان لديها نموذج حجز طويل: الاسم، رقم الهاتف، نوع الإصابة، وصف الحالة، والوقت المفضل. بعض المرضى يبدأون بالتعبئة، ثم يذهبون لإحضار تقرير الطبيب أو للرد على مكالمة، ويعودون بعد وقت طويل ويضغطون «إرسال». تظهر لهم صفحة إنجليزية غريبة تقول «Page Expired»، وكل ما كتبوه ضاع.

صاحب العيادة يرى النتيجة فقط: حجوزات أقل، ورسائل واتساب تقول «الموقع خربان». هذا مثال توضيحي، لكنه يجمع أكثر سيناريو شائع وراء خطأ 419.

ما هو رمز CSRF ببساطة؟

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

لذلك يضيف كل نموذج يرسل بيانات حقلاً مخفياً يحمل هذا الرمز، ويستخدم التوثيق التوجيه ‎@csrf‎ في قوالب Blade لإنشائه. عند الإرسال، يقارن Laravel الرمز القادم مع الرمز المخزن في الجلسة. إذا لم يتطابقا، يرفض الطلب، والنتيجة صفحة 419.

الأسباب الشائعة وكيف تميز بينها

1. نموذج بلا رمز

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

2. الجلسة انتهت

إذا ظهرت الصفحة فقط لمن ترك النموذج مفتوحاً طويلاً، كما في مثال العيادة، فالجلسة على الخادم انتهت مدتها، ومعها الرمز. النموذج ما زال يحمل الرمز القديم، والخادم لم يعد يعرفه.

3. صفحة النموذج مخزنة مؤقتاً

إذا كان الموقع خلف خدمة تخزين مؤقت أو شبكة توزيع محتوى، وكانت صفحة النموذج نفسها تُخزن وتُعرض للجميع، فقد يحصل زائر على صفحة فيها رمز يخص جلسة زائر آخر. النتيجة 419 لعدد كبير من الزوار بشكل عشوائي. الحل ألا تُخزن صفحات النماذج التي تحمل رموزاً خاصة بالجلسة، أو أن يُجلب الرمز بطريقة لا تعتمد على الصفحة المخزنة.

4. طلبات JavaScript لا ترسل الرمز

إذا كان النموذج يُرسل عبر JavaScript دون إعادة تحميل الصفحة، فيجب أن يرسل الرمز أيضاً. توثيق Laravel يخصص قسمين لهذا: ترويسة X-CSRF-TOKEN التي يمكن أن يضعها الكود في كل طلب، وترويسة X-XSRF-TOKEN المرتبطة بملف تعريف الارتباط الذي يضعه Laravel. إذا نسي المطور ذلك، ستفشل الطلبات بنفس الخطأ.

5. مشكلة في تخزين الجلسات نفسها

إذا كان الخطأ يظهر للجميع حتى مع النموذج الصحيح، فقد لا تُحفظ الجلسات أصلاً. التوثيق يذكر عدة طرق لتخزين الجلسات: ملفات في مجلد storage/framework/sessions، أو ملفات تعريف ارتباط مشفرة، أو قاعدة البيانات، أو خدمات مثل Redis. إذا كان التخزين بالملفات والمجلد غير قابل للكتابة، أو إذا كان الموقع يعمل على أكثر من خادم وكل خادم يحفظ جلساته محلياً، فقد يصل الطلب إلى خادم لا يعرف جلسة الزائر.

6. تبويب قديم بعد تسجيل الدخول أو الخروج

سبب أقل وضوحاً يظهر في لوحات الموظفين. توثيق الجلسات في Laravel يذكر أن إعادة إنشاء معرف الجلسة تتم غالباً لمنع هجمات تثبيت الجلسة، وأن Laravel يعيد إنشاءه تلقائياً أثناء تسجيل الدخول إذا كنت تستخدم إحدى حزم البداية الرسمية أو Fortify. وتوثيق الحماية يذكر أن الرمز يتغير مع كل إعادة إنشاء للجلسة.

النتيجة العملية: موظف الاستقبال يفتح نموذج «إضافة موعد» في تبويب، ثم يسجل الدخول من جديد في تبويب آخر، ثم يعود إلى التبويب الأول ويرسل النموذج. الرمز في التبويب القديم لم يعد صالحاً، فيظهر 419. الحل هنا تدريبي أكثر منه تقني: حدّث الصفحة قبل الإرسال بعد أي تسجيل دخول أو خروج، واجعل رسالة الخطأ تقول ذلك بوضوح.

لا تحل المشكلة بإيقاف الحماية

أسهل «حل» يلجأ إليه البعض هو استثناء كل المسارات من التحقق. لا تفعل ذلك. التوثيق يسمح باستثناء مسارات محددة عبر دالة validateCsrfTokens، ويضرب مثالاً بمسارات استقبال الإشعارات الآلية (webhooks) من خدمات خارجية، لأن تلك الخدمات لا تملك رمز جلسة أصلاً. هذا استثناء ضيق ومبرر. أما استثناء نموذج الحجز أو تسجيل الدخول، فيفتح الباب للهجوم الذي صُممت الحماية لمنعه.

تحسينات تقلل الإزعاج للزبون

بعد معالجة السبب التقني، فكر في تجربة الزبون:

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

خطوات فحص سريعة للمطور

  1. افتح النموذج وأرسله فوراً. إذا ظهر 419، تحقق من وجود ‎@csrf‎.
  2. افتحه واتركه مدة طويلة ثم أرسله. إذا ظهر 419 هنا فقط، فالمشكلة في مدة الجلسة وتجربة المستخدم.
  3. جرّب من متصفحين مختلفين في الوقت نفسه. إذا ظهر الخطأ لأحدهما بشكل عشوائي، تحقق من التخزين المؤقت لصفحة النموذج.
  4. راقب طلبات الشبكة في أدوات المطور. إذا كان الإرسال عبر JavaScript، تأكد من وجود ترويسة الرمز.
  5. تحقق من مكان تخزين الجلسات وأنه يعمل على كل الخوادم.

أسئلة شائعة

شو يعني 419 Page Expired بموقع Laravel؟

يعني أن رمز الحماية في النموذج لم يطابق الرمز المخزن في جلسة الزائر، فرفض Laravel الطلب.

ليش بيطلع الخطأ بس للي بيطوّل بالتعبئة؟

لأن جلسته انتهت على الخادم، والنموذج ما زال يحمل الرمز القديم.

هل أطفي حماية CSRF وأرتاح؟

لا. استثنِ فقط مسارات الإشعارات الآلية من خدمات خارجية، واترك النماذج العادية محمية.

الخطأ بيطلع لزوار عشوائيين، ليش؟

قد تكون صفحة النموذج مخزنة مؤقتاً وتحمل رمز جلسة زائر آخر، أو أن الجلسات لا تُحفظ بشكل صحيح.

إذا كان زبائنك يرون صفحة 419 عند الحجز أو الطلب، راسلنا ونحدد السبب معك.

المصادر

WhatsAppاحجز مكالمة