همه مقالات تخصصی

try_files در Nginx برای وردپرس: ریشهٔ مشکل لینک‌های دائمی و 404

try_files را برای وردپرس و برنامه‌های تک‌صفحه‌ای درست بنویسید، پارامترهای query را حفظ کنید و بلوک PHP را در برابر اجرای فایل ناخواسته امن نگه دارید.

try_files در Nginx برای وردپرس: ریشهٔ مشکل لینک‌های دائمی و 404

وقتی لینک‌های دائمی وردپرس در Nginx 404 می‌دهند، تقریباً همیشه try_files درست نوشته نشده است. این دستور مشخص می‌کند Nginx به ترتیب چه چیزهایی را امتحان کند. این راهنما الگوی صحیح و اشتباه‌های رایج را نشان می‌دهد.

۱. الگوی استاندارد وردپرس

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

Nginx اول فایل واقعی ($uri)، بعد پوشه ($uri/) و در نهایت index.php وردپرس را با همان query string امتحان می‌کند. بدون ?$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 را بررسی کنید. اگر 404 از وردپرس بود، لینک‌های دائمی را بازنویسی کنید. ترتیب بلوک‌ها را با انطباق location کنترل کنید و مجوز فایل‌ها را در صورت 403 بررسی کنید.

۵. اشتباه‌های ظریف

قرار دادن root داخل location به‌جای server، یا قرارگرفتن یک location regex قبل از آن، رفتار را عوض می‌کند. تنظیم کش و فشرده‌سازی را بعد از اینکه مسیرها درست شد اضافه کنید، مثلاً با تنظیم PHP-FPM.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید صفحهٔ اصلی باز می‌شد ولی /sample-post/ ۴۰۴ می‌داد. try_files فقط $uri $uri/ =404 بود. با تغییر آخرین مقدار به /index.php?$args لینک‌های دائمی کار کردند. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • نگذاشتن ?$args.
  • نبودن try_files در بلوک PHP.
  • تعریف دو location که یکدیگر را پنهان می‌کنند.
  • تست فقط صفحهٔ اصلی و نه مسیرهای عمیق.

۸. پرسش‌های متداول

چرا فقط صفحهٔ اصلی کار می‌کند؟ احتمالاً مسیر fallback به index.php وجود ندارد.

=404 در try_files چه می‌کند؟ اگر هیچ گزینه‌ای پیدا نشد، 404 برمی‌گرداند.

با Apache هم همین‌طور است؟ نه؛ Apache از mod_rewrite و .htaccess استفاده می‌کند.

۹. چک‌لیست سریع

  1. try_files با ?$args نوشته شد.
  2. بلوک PHP try_files $uri =404 دارد.
  3. nginx -t و reload انجام شد.
  4. یک مسیر عمیق با curl تست شد.
  5. لاگ خطا بدون خطای تازه است.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

Nginx try_files · WordPress: Nginx configuration