كل المقالات التقنية

try_files في Nginx لووردبريس: جذر مشكلة 404 في الروابط الدائمة

اكتبوا try_files بشكل صحيح لووردبريس وتطبيقات الصفحة الواحدة واحفظوا معاملات الاستعلام وأبقوا كتلة PHP آمنة من تنفيذ ملفات غير مقصودة.

try_files في Nginx لووردبريس: جذر مشكلة 404 في الروابط الدائمة

عندما تعطي الروابط الدائمة في ووردبريس 404 على Nginx فإن try_files يكون مكتوباً خطأً في الغالب. تحدد هذه التعليمة ما يجربه Nginx بالترتيب. يعرض هذا الدليل النمط الصحيح والأخطاء الشائعة.

١. النمط القياسي لووردبريس

location / {
    try_files $uri $uri/ /index.php?$args;
}

يجرب Nginx الملف الحقيقي ($uri) ثم المجلد ($uri/) وأخيراً index.php في ووردبريس بسلسلة الاستعلام نفسها. وبدون ?$args تضيع معاملات مثل البحث والمعاينة.

٢. كتلة PHP آمنة

location ~ \.php$ {
    try_files $uri =404;
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php-fpm.sock;
}

يمنع السطر try_files $uri =404 تمرير مسارات لا تحتوي ملف PHP حقيقياً، وهو احتياط أمني مهم. غيّروا مسار المقبس بما يطابق خادمكم.

٣. تطبيق الصفحة الواحدة (SPA)

location / {
    try_files $uri /index.html;
}

في React أو Vue يجب أن تعود مسارات جهة العميل إلى index.html. وتُقدَّم الملفات الثابتة ذات الأسماء الحقيقية مباشرة كالمعتاد.

٤. استكشاف الأخطاء

sudo nginx -t && sudo systemctl reload nginx
curl -I https://example.com/sample-post/
tail -n 20 /var/log/nginx/error.log

إذا جاء الـ404 من Nginx نفسه فافحصوا try_files أو root. وإذا جاء من ووردبريس فأعيدوا حفظ الروابط الدائمة. وراجعوا ترتيب الكتل بـ مطابقة location وأذونات الملفات إن ظهر 403.

٥. أخطاء دقيقة

وضع root داخل location بدل كتلة server، أو ظهور location بتعبير نمطي قبله، يغيّر السلوك. أضيفوا التخزين المؤقت والضغط بعد أن تعمل المسارات، مثلاً مع ضبط PHP-FPM.

٦. مثال توضيحي وليس قياساً حقيقياً

لنفترض أن الصفحة الرئيسية كانت تفتح لكن /sample-post/ أعطى 404. كان try_files هو $uri $uri/ =404 فقط. وتغيير القيمة الأخيرة إلى /index.php?$args جعل الروابط الدائمة تعمل. هذا سيناريو مختلق للتوضيح وليس قياساً حقيقياً.

٧. أخطاء شائعة

  • ترك ?$args.
  • غياب try_files في كتلة PHP.
  • تعريف كتلتَي location يخفي إحداهما الأخرى.
  • اختبار الصفحة الرئيسية فقط دون المسارات العميقة.

٨. أسئلة شائعة

لماذا تعمل الصفحة الرئيسية فقط؟ غالباً لا يوجد رجوع احتياطي إلى index.php.

ماذا يفعل =404 في try_files؟ يعيد 404 إذا لم يُعثر على شيء.

هل الأمر نفسه في Apache؟ لا؛ يستخدم Apache mod_rewrite و.htaccess.

٩. قائمة تحقق سريعة

  1. كُتب try_files مع ?$args.
  2. كتلة PHP فيها try_files $uri =404.
  3. نُفذ nginx -t وإعادة التحميل.
  4. اختُبر مسار عميق بـ curl.
  5. سجل الأخطاء بلا أخطاء جديدة.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

Nginx try_files · ووردبريس: Nginx configuration