Lorixen.
AR

تحديث نظام Laravel دون إزعاج الزبائن: وضع الصيانة برابط سري

باختصار: إذا كان نظامك مبنياً بـ Laravel، مثل نظام حجوزات أو متجر أو بوابة زبائن، وتريد أن ينشر المطور تحديثاً كبيراً بينما يرى الزبائن صفحة «نعود بعد قليل»، وفريقك وحده يستطيع تجربة النسخة الجديدة قبل فتحها للجميع، فالأداة مدمجة في Laravel: أمر php artisan down مع خيار secret. توثيق Laravel يشرح أن هذا الخيار يحدد رمز تجاوز سرياً، وأن من يفتح رابط الموقع متبوعاً بهذا الرمز يحصل على ملف تعريف ارتباط يسمح له بتصفح التطبيق بشكل طبيعي كأنه ليس في وضع الصيانة. وبعد التأكد، يُنهي المطور الوضع بأمر php artisan up.

لماذا تحتاج هذا بدل «الرفع والدعاء»؟

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

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

ماذا يحدث عند تفعيل وضع الصيانة؟

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

ويمكن تخصيص قالب صفحة الصيانة الافتراضي بإنشاء قالب خاص في resources/views/errors/503.blade.php. اكتب فيها رسالة واضحة بالعربية: ماذا يحدث، ومتى تتوقع العودة تقريباً، ورقم هاتف أو واتساب للحالات العاجلة.

الرابط السري لفريقك

هذا هو الجزء الأهم. التوثيق يشرح:

  1. تحديد الرمز: عند تفعيل الصيانة، يمكن تمرير خيار secret مع رمز تجاوز من اختيارك.
  2. فتح الرابط: بعد تفعيل الصيانة، يفتح عضو الفريق رابط الموقع متبوعاً بالرمز، فيصدر Laravel ملف تعريف ارتباط للتجاوز إلى متصفحه.
  3. التصفح الطبيعي: بعد إصدار الملف، يستطيع تصفح التطبيق كأنه ليس في وضع الصيانة، بينما يرى الآخرون صفحة الصيانة.

وإذا أردت أن يولّد Laravel الرمز بنفسه، يذكر التوثيق خيار with-secret، ويعرض الرمز بعد دخول التطبيق في وضع الصيانة. وعند فتح الرابط السري، يُعاد توجيه المتصفح إلى الصفحة الرئيسية للتطبيق.

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

ماذا يختبر الفريق عبر الرابط السري؟

لا تكتفِ بفتح الصفحة الرئيسية والتأكد أنها تظهر. جهّز قائمة قصيرة بالمهام التي يقوم بها الزبائن والموظفون فعلاً، ووزعها على من يملك الرابط:

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

إذا ظهر خطأ، يبقى الموقع في وضع الصيانة، ويصلح المطور المشكلة قبل أن يراها أي زبون. هذا هو الهدف كله من الرابط السري.

نصائح حول الرمز السري

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

ومن الممارسة الجيدة:

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

خيارات تحسّن تجربة الزائر

التوثيق يذكر خيارات أخرى مفيدة:

  • refresh: يرسل ترويسة Refresh مع كل استجابات الصيانة، فيحدّث المتصفح الصفحة تلقائياً بعد عدد الثواني المحدد. الزائر الذي يترك الصفحة مفتوحة يرى الموقع عندما يعود دون أن يضغط شيئاً.
  • retry: يضبط قيمة ترويسة Retry-After، مع ملاحظة التوثيق أن المتصفحات تتجاهل هذه الترويسة عموماً.
  • render: يعرض قالباً مُعداً مسبقاً، ويذكر التوثيق أن صفحة الصيانة قد تُعرض قبل تحميل أي من اعتماديات التطبيق، لذلك قد يُستخدم هذا الخيار لتجهيزها مسبقاً.
  • redirect: يعيد توجيه كل الطلبات إلى رابط محدد، مثل الصفحة الرئيسية.

انتبه للطوابير والمهام الخلفية

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

في عيادة الأسنان، هذا يعني أن رسائل تأكيد الحجز وتذكير المواعيد التي تُرسل عبر الطوابير ستتوقف طوال فترة الصيانة. إذا طالت الصيانة، فقد تصل رسائل تذكير متأخرة. خطط لذلك:

  • اجعل الصيانة قصيرة قدر الإمكان.
  • لا تبدأها قبل موعد إرسال تذكيرات الصباح مباشرة.
  • بعد الفتح، راقب أن المهام المتراكمة عولجت.

إذا كان الموقع على أكثر من خادم

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

الصيانة نفسها تعني توقفاً

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

قائمة قبل الصيانة وبعدها

  1. اختر وقتاً هادئاً، وأبلغ الفريق مسبقاً.
  2. جهّز صفحة الصيانة بالعربية، مع وسيلة تواصل للحالات العاجلة.
  3. فعّل الصيانة برمز سري جديد، وأرسله لمن سيختبر فقط.
  4. اختبر الحجز والدفع وتسجيل الدخول عبر الرابط السري.
  5. أنهِ الصيانة، وافتح الموقع من جهاز لم يستخدم الرابط السري للتأكد.
  6. راقب الطوابير والرسائل المتأخرة.

أسئلة شائعة

كيف أخلي الزباين يشوفوا صفحة صيانة وأنا أجرب الموقع؟

فعّل وضع الصيانة بأمر php artisan down مع خيار secret، وافتح الموقع متبوعاً بالرمز، فيتجاوز متصفحك الصيانة وحده.

الرسائل التلقائية وقفت وقت الصيانة، ليش؟

لأن Laravel لا يعالج مهام الطوابير أثناء وضع الصيانة، وتستأنف بعد الخروج منه.

كيف أرجع الموقع للزباين؟

بأمر php artisan up، ثم تأكد من جهاز آخر لم يفتح الرابط السري.

هل أقدر أعدّل شكل صفحة الصيانة؟

نعم، بإنشاء قالب خاص في resources/views/errors/503.blade.php.

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

المصادر

WhatsAppاحجز مكالمة