الموقع يتعطل مع كل تحديث؟ نشر بمجلدات نسخ ورابط رمزي واحد
باختصار: إذا كان موقع شركتك يتعطل لدقيقة أو اثنتين في كل مرة ترفع فيها نسخة جديدة من الكود، بصفحات بيضاء أو أخطاء أو تصميم مكسور، فالسبب أن الملفات الجديدة تُنسخ فوق القديمة أثناء استقبال الموقع للزوار، فيرى بعضهم خليطاً من النسختين. الحل نشر كل نسخة في مجلد مستقل، ثم تبديل رابط رمزي واحد يشير إلى النسخة الحالية دفعة واحدة. هكذا يرى الزائر النسخة القديمة كاملة أو الجديدة كاملة، ولا شيء بينهما، والرجوع إلى السابقة يصبح أمراً واحداً.
كيف تظهر المشكلة
شركة تطوير صغيرة في عمّان تدير تطبيق حجوزات لعيادة على خادم خاص. عند كل تحديث، يرفع المطور الملفات بأداة نقل الملفات أو بأمر نسخ إلى مجلد الموقع مباشرة. العملية تأخذ دقيقة أو أكثر. خلالها تتصل موظفة الاستقبال: «النظام يعطي خطأ»، ثم بعد دقيقة: «رجع يشتغل».
ما حدث أن بعض الملفات كانت قد تحدثت وبعضها لا. ملف جديد يستدعي دالة في ملف لم يُنسخ بعد، أو صفحة جديدة تحمل ملف تنسيق قديماً. وإذا انقطع النسخ في منتصفه لأي سبب، يبقى الموقع مكسوراً حتى يلاحظ أحد.
الفكرة: لا تعدّل النسخة التي يعمل عليها الموقع
بدل أن تكتب فوق الملفات التي يقدمها الخادم الآن، تجهز النسخة الجديدة كاملة في مكان آخر، ثم تجعل الخادم ينتقل إليها في لحظة واحدة. الهيكل الشائع:
/var/www/clinic/
releases/
2026-11-01/
2026-11-08/
shared/
current -> releases/2026-11-08
مجلد releases يحتوي كل نسخة في مجلدها، وshared يحتوي ما يجب أن يبقى بين النسخ، وcurrent رابط رمزي يشير إلى النسخة الفعالة. والخادم يقدم الموقع دائماً من current.
الخطوة الأولى: جهّز النسخة الجديدة كاملة
ارفع الكود إلى مجلد جديد داخل releases، وشغّل فيه كل ما يلزم قبل أن يراه أي زائر: تثبيت المكتبات، وبناء ملفات التنسيق والسكربت، ونسخ ملف الإعدادات. إذا فشلت أي خطوة هنا، فلا ضرر، لأن الموقع ما زال يعمل من النسخة القديمة. هذه وحدها ميزة كبيرة: الخطأ في التجهيز لم يعد يعني موقعاً معطلاً.
الخطوة الثانية: افصل ما يجب أن يبقى
بعض الملفات ليست جزءاً من الكود، بل من البيانات: صور يرفعها الموظفون، وملفات يرفعها المرضى، وملف الإعدادات الذي فيه كلمات مرور قاعدة البيانات، وملفات السجلات. هذه لا يجب أن تكون داخل مجلد النسخة، وإلا ضاعت عند الانتقال إلى نسخة جديدة.
ضعها في shared، واجعل كل نسخة تشير إليها بروابط رمزية. مثلاً مجلد الرفع في كل نسخة رابط إلى shared/uploads. هكذا تبقى الملفات في مكان واحد مهما تغيرت النسخ.
الخطوة الثالثة: بدّل الرابط دفعة واحدة
هنا التفصيل المهم. قد تظن أن أمر ln -sfn وحده يكفي لتغيير الرابط. بحسب دليل ln، الخيار -s ينشئ رابطاً رمزياً، و-f يحذف الوجهة الموجودة، و-n يتعامل مع اسم الرابط كملف عادي إذا كان رابطاً رمزياً إلى مجلد. لكن «حذف الموجود ثم إنشاء الجديد» خطوتان، وبينهما لحظة قصيرة لا يوجد فيها رابط أصلاً.
الطريقة الأدق تعتمد على إعادة التسمية. يشرح دليل rename في لينكس أنه إذا كان المسار الجديد موجوداً، فسيُستبدل ذرياً، بحيث لا توجد لحظة تجد فيها عملية أخرى المسار مفقوداً. لذلك أنشئ رابطاً مؤقتاً ثم أعد تسميته فوق current:
ln -s releases/2026-11-08 current_tmp
mv -T current_tmp current
الخيار -T في mv، بحسب دليله، يعامل الوجهة كملف عادي، فلا ينقل الرابط المؤقت إلى داخل المجلد الذي يشير إليه current بدل أن يستبدله. أسماء المجلدات والتواريخ هنا مثال توضيحي.
الخطوة الرابعة: تأكد أن الخادم يرى التغيير
في nginx، إذا كان root يشير إلى /var/www/clinic/current/public فهو يتبع الرابط. لكن تطبيقات PHP تحتاج انتباهاً إضافياً، لأن nginx يمرر إلى PHP-FPM مسار الملف، وقد تحتفظ PHP بذاكرة للمسارات التي حللتها سابقاً.
يذكر توثيق nginx المتغير $realpath_root، ويصفه بأنه المسار المطلق المقابل لقيمة root أو alias للطلب الحالي، مع تحويل كل الروابط الرمزية إلى مساراتها الحقيقية، بخلاف $document_root الذي يعطي قيمة root كما هي. استخدام $realpath_root في المعاملات التي تمرر مسار السكربت إلى PHP يجعل كل طلب يصل بمسار النسخة الفعلية، فلا تخلط PHP بين النسختين. وبعد التبديل، أعد تحميل PHP-FPM إذا كنت تستخدم ذاكرة مؤقتة للكود، لتتخلص من النسخة القديمة المحفوظة.
الرجوع إلى النسخة السابقة
هذه أكبر فائدة عملية. إذا اكتشفت بعد النشر خطأً لم يظهر في الاختبار، فلا تحتاج إلى رفع الملفات القديمة من جديد. النسخة السابقة ما زالت في releases كما هي. بدّل الرابط إليها بالطريقة نفسها، فيعود الموقع خلال ثوانٍ. ثم أصلح الخطأ بهدوء.
احتفظ بآخر ثلاث نسخ أو خمس، واحذف الأقدم تلقائياً، حتى لا يمتلئ القرص. واكتب خطوات النشر والرجوع في سكربت واحد يشغله أي شخص في الفريق، بدل أن تبقى في ذاكرة مطور واحد، فيوم الخطأ ليس اليوم المناسب لتذكر الأوامر.
انتبه إلى قاعدة البيانات
تبديل الرابط يجعل الكود يتغير في لحظة، لكن قاعدة البيانات واحدة لكل النسخ. إذا كانت النسخة الجديدة تغير بنية الجداول، فالرجوع إلى القديمة قد لا يعمل مع البنية الجديدة. اجعل تغييرات القاعدة متوافقة مع النسختين قدر الإمكان، مثل إضافة عمود جديد قبل أن يعتمد عليه الكود، وحذف القديم في تحديث لاحق.
هل هذا مناسب لووردبريس؟
لموقع ووردبريس عادي تحدّثه من لوحة التحكم، هذا الهيكل لا ينطبق مباشرة، لأن ووردبريس يحدّث ملفاته بنفسه. لكنه مناسب جداً للقوالب والإضافات المخصصة التي يطورها فريقك ويرفعها، وللتطبيقات المبنية بـ Laravel أو Node.js أو أي إطار آخر، وللمواقع الثابتة.
مثال توضيحي: نظام حجوزات عيادة
هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. شركة التطوير تنقل تطبيق الحجوزات إلى هيكل releases وshared وcurrent. تنقل مجلد الملفات المرفوعة وملف الإعدادات إلى shared. عند التحديث التالي، تُجهز النسخة في مجلد جديد خلال دقيقتين بينما يعمل الموقع كالمعتاد، ثم تُبدّل بالرابط في لحظة. وبعد أسبوع، عندما يظهر خطأ في تقرير جديد، تعيد الرابط إلى النسخة السابقة خلال ثوانٍ.
أسئلة شائعة
ليش الموقع بتعطل دقيقة كل ما ننزل تحديث؟
لأن الملفات الجديدة تُنسخ فوق القديمة والموقع يعمل، فيرى الزوار خليطاً من النسختين حتى ينتهي النسخ.
شو الفرق بين ln -sfn وطريقة mv -T؟
ln -sfn يحذف الرابط ثم ينشئه، وبينهما لحظة بلا رابط. أما إعادة التسمية فتستبدل الرابط ذرياً دون أي لحظة فراغ.
وين بحط الصور اللي برفعها الموظفين؟
في مجلد مشترك خارج النسخ، وتربطه كل نسخة برابط رمزي، حتى لا تضيع عند النشر.
كيف برجع للنسخة القديمة بسرعة؟
بدّل الرابط current ليشير إلى مجلد النسخة السابقة بالطريقة نفسها، فيعود الموقع خلال ثوانٍ.
إذا كانت تحديثات موقعك أو تطبيقك تعني دقائق من الأعطال في كل مرة، احكِ لنا ونبني معك طريقة نشر تنتقل فيها بين النسخ دون أن يلاحظ زبائنك.