روابط WordPress تعطي 404 بعد النقل إلى nginx
باختصار: إذا نقلت موقع WordPress من استضافة تعمل بـ Apache إلى خادم يعمل بـ nginx، فقد تفتح الصفحة الرئيسية بشكل طبيعي، لكن كل صفحة أخرى، كالمنتجات والمقالات والأقسام، تعطي خطأ 404. السبب أن قواعد الروابط الجميلة كانت في ملف .htaccess، وnginx لا يقرأ هذا الملف أصلاً. دليل WordPress الرسمي لـ nginx يوضح أن WordPress لا يستطيع تعديل إعدادات nginx بنفسه، وأن الحل سطر try_files في إعدادات الموقع يمرر الطلبات التي لا تطابق ملفاً حقيقياً إلى index.php مع معاملات الاستعلام.
الأعراض بعد النقل
متجر عطور في عمّان انتقل إلى خادم سحابي أسرع. المطور نقل الملفات وقاعدة البيانات، وفتح الصفحة الرئيسية فظهرت كاملة. في اليوم التالي يتصل الزبائن: «الرابط اللي بعتولي إياه على واتساب بيطلع صفحة مش موجودة». صفحات المنتجات، وصفحات الأقسام، وحتى صفحة السلة، كلها 404. لوحة التحكم تعمل، لكن معاينة أي منتج منها تفشل.
هذا النمط شبه مؤكد: الملفات الثابتة والصفحة الرئيسية تعمل لأنها تطابق ملفات حقيقية، وكل ما يعتمد على قواعد إعادة الكتابة فشل. والمطور لم يلاحظه لأنه فتح الصفحة الرئيسية ولوحة التحكم فقط، وهما بالضبط الصفحتان اللتان لا تحتاجان هذه القواعد.
لماذا كان يعمل على Apache
الروابط الجميلة مثل /ar/product/عطر-الورد/ لا تطابق ملفاً حقيقياً على الخادم. Apache يقرأ ملف .htaccess في مجلد الموقع، وفيه قواعد يكتبها WordPress تلقائياً تقول: إذا لم يوجد ملف أو مجلد بهذا الاسم، فمرر الطلب إلى index.php، وWordPress يعرف ماذا يعرض.
يشرح دليل WordPress لإدارة nginx أنه لا يوجد في nginx ملف إعدادات على مستوى المجلد مثل .htaccess في Apache، وأن كل الإعدادات يجب أن تتم على مستوى الخادم من قِبل المسؤول، وأن WordPress لا يستطيع تعديل هذه الإعدادات كما يفعل مع Apache. ولذلك لا يستطيع WordPress توليد قواعد إعادة الكتابة لك.
ملف .htaccess الذي نقلته مع الموقع ما زال موجوداً، لكنه بلا أثر. يمكنك تركه مؤقتاً كمرجع للقواعد التي يجب ترجمتها، ثم حذفه بعد الانتهاء.
الحل: try_files
في إعدادات الموقع في nginx، داخل قسم الموقع الرئيسي، يعرض الدليل السطر:
location / {
try_files $uri $uri/ /index.php?$args;
}
معناه: جرّب الملف المطلوب كما هو، ثم كمجلد، وإن لم يوجد أي منهما، مرر الطلب إلى index.php مع معاملات الاستعلام. ويوضح تعليق في مثال الدليل أن إضافة ?$args مهمة حتى لا تنكسر الروابط غير الافتراضية عند استخدام معاملات الاستعلام، كروابط البحث والفلترة والتتبع.
بعد إضافة السطر، اختبر الإعدادات قبل إعادة التحميل، ثم أعد تحميل nginx، وجرّب رابط منتج ورابط قسم ورابط مقال.
إذا كان WordPress في مجلد فرعي
إذا كان الموقع في مجلد فرعي، مثل /shop/، فالقاعدة يجب أن تشير إلى index.php في ذلك المجلد، ويجب أن تكون داخل قسم المسار المناسب. وإذا كان موقعك شبكة مواقع متعددة، فيعرض الدليل إعدادات مختلفة لكل نوع، لأن قواعدها أكثر تعقيداً. لا تنسخ سطراً واحداً وتتوقع أن يناسب كل الحالات.
قواعد أخرى كانت في .htaccess
ملف .htaccess في المواقع القديمة يحتوي غالباً أكثر من قواعد WordPress. افتحه قبل أن تنساه، وابحث عن:
- تحويلات قديمة من روابط موقع سابق إلى الجديدة، أضافها أحد بعد إعادة تصميم.
- تحويل إلى HTTPS أو إلى www أو بدونه.
- منع الوصول إلى ملفات أو مجلدات معينة.
- قواعد تخزين مؤقت وترويسات.
- قواعد إضافات الأمان أو التخزين المؤقت، التي كتبتها في الملف تلقائياً.
كل هذه توقفت أيضاً بعد النقل إلى nginx. يجب ترجمتها إلى إعدادات nginx واحدة واحدة، أو التأكد أنها لم تعد مطلوبة. التحويلات القديمة تحديداً مهمة، لأن الروابط من مواقع أخرى ونتائج البحث ما زالت تشير إلى العناوين القديمة.
إضافات تكتب قواعد
بعض إضافات التخزين المؤقت والأمان تعتمد على كتابة قواعد في .htaccess، وعلى nginx تعرض في إعداداتها قواعد خاصة لـ nginx يجب أن تنسخها يدوياً إلى إعدادات الخادم. راجع كل إضافة من هذا النوع بعد النقل، واقرأ ما تقوله عن nginx.
«index.php» في الروابط
يذكر الدليل أنه دون تعديلات، سيضيف WordPress index.php إلى الروابط على nginx. إذا رأيت روابط مثل /index.php/product/... فهذا يعني أن WordPress لا يرى أن إعادة الكتابة متاحة. بعد إضافة try_files، اذهب إلى إعدادات الروابط الدائمة في لوحة التحكم واحفظها مرة أخرى بالشكل الذي تريده.
اختبر قبل نقل الزبائن
أفضل وقت لاكتشاف هذه المشكلة قبل تغيير DNS، لا بعده. يمكن للمطور أن يفتح الموقع على الخادم الجديد من حاسوبه فقط، بتوجيه النطاق محلياً إلى عنوان الخادم الجديد، ويجرب صفحات مختلفة قبل أن يراها أي زبون. قائمة اختبار قصيرة: الصفحة الرئيسية، ومنتج، وقسم، ومقال، وصفحة بحث، والسلة، وتسجيل الدخول، وصفحة غير موجودة.
الروابط العربية في nginx
إذا كانت روابط منتجاتك بالعربية، فهي تصل إلى الخادم مرمّزة بعلامات النسبة المئوية، ويفك nginx ترميزها قبل مطابقتها بالملفات. قاعدة try_files تعمل معها كما تعمل مع الروابط اللاتينية، لأن الطلب الذي لا يطابق ملفاً يذهب إلى index.php، وWordPress يتعامل مع الباقي. لكن التحويلات القديمة التي ستترجمها من .htaccess قد تحتوي روابط عربية بالشكل المرمّز أو بالشكل المقروء، وكل منهما يُكتب بطريقة مختلفة في إعدادات nginx. اختبر كل تحويل عربي بعد ترجمته بفتح الرابط القديم والتأكد أنه يصل إلى الصفحة الجديدة الصحيحة، لا إلى صفحة 404 ولا إلى الصفحة الرئيسية. واحفظ قائمة التحويلات في ملف مستقل داخل إعدادات nginx، مع تعليق بتاريخ إضافة كل مجموعة وسببها، حتى يسهل مراجعتها وحذف ما لم يعد مطلوباً بعد سنوات.
مثال توضيحي: متجر عطور بعد الانتقال
هذا مثال توضيحي لطريقة المعالجة، دون حالة حقيقية. المطور يضيف سطر try_files إلى إعدادات الموقع، ويختبر الإعدادات ويعيد التحميل، فتعود صفحات المنتجات والأقسام. يفتح ملف .htaccess القديم فيجد تحويلات من موقع سابق وقاعدة تحويل إلى HTTPS، فيترجمها إلى إعدادات nginx. يحفظ إعدادات الروابط الدائمة في لوحة التحكم، ويراجع إضافة التخزين المؤقت وقواعدها الخاصة بـ nginx. ثم يجرّب قائمة الاختبار كاملة.
أسئلة شائعة
نقلت الموقع لـ nginx وكل الصفحات بتطلع 404 إلا الرئيسية، ليش؟
لأن قواعد الروابط كانت في .htaccess، وnginx لا يقرأ هذا الملف. أضف try_files إلى إعدادات الموقع.
شو السطر اللي لازم أضيفه؟
try_files $uri $uri/ /index.php?$args داخل قسم الموقع الرئيسي، كما يعرض دليل WordPress.
ليش ?$args مهمة؟
حتى لا تنكسر الروابط التي تحمل معاملات استعلام، كالبحث والفلترة.
شو كمان كان بملف .htaccess لازم أنقله؟
التحويلات القديمة، وتحويل HTTPS أو www، وقواعد المنع والتخزين المؤقت وقواعد الإضافات.
إذا كنت تخطط لنقل موقعك إلى خادم جديد أو نقلته وظهرت أخطاء، اكتب لنا ونراجع الإعدادات قبل أن يلاحظها زبائنك.