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

کش FastCGI در Nginx برای وردپرس: صفحات سریع بدون کش کردن بخش مدیریت

کش FastCGI را برای وردپرس تنظیم کنید، wp-admin و کاربران واردشده را از کش کنار بگذارید و با هدر X-Cache تست کنید.

کش FastCGI در Nginx برای وردپرس: صفحات سریع بدون کش کردن بخش مدیریت

وردپرس برای هر بازدید PHP و پایگاه‌داده را اجرا می‌کند. کش FastCGI در Nginx صفحات ناشناس را از دیسک می‌دهد و بار PHP-FPM را کم می‌کند. خطر اصلی کش‌شدن صفحهٔ شخصی یک کاربر برای دیگری است، پس استثناها مهم‌ترین بخش‌اند.

۱. مسیر و ناحیهٔ کش

# در بلوک http
fastcgi_cache_path /var/cache/nginx/wp levels=1:2 keys_zone=WP:50m inactive=60m max_size=1g;
fastcgi_cache_key "$scheme$request_method$host$request_uri";

مسیر باید برای کاربر Nginx قابل‌نوشتن باشد. اندازهٔ max_size را متناسب با دیسک بگذارید.

۲. شرط‌های عبور از کش

set $skip_cache 0;
if ($request_method = POST) { set $skip_cache 1; }
if ($query_string != "") { set $skip_cache 1; }
if ($request_uri ~* "/wp-admin/|/wp-login.php|/wp-json/") { set $skip_cache 1; }
if ($http_cookie ~* "comment_author|wordpress_logged_in|wp-postpass") { set $skip_cache 1; }

این شرط‌ها فرم‌ها، مدیریت، API و کاربران واردشده را از کش بیرون نگه می‌دارند. اگر WooCommerce دارید، سبد و صفحات پرداخت و حساب کاربری را هم صریحاً مستثنی کنید.

۳. فعال‌سازی در بلوک PHP

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_cache WP;
    fastcgi_cache_valid 200 301 10m;
    fastcgi_cache_bypass $skip_cache;
    fastcgi_no_cache $skip_cache;
    add_header X-Cache $upstream_cache_status always;
}

مسیر سوکت و نسخهٔ PHP را مطابق سرور خود بگذارید. تنظیم PHP-FPM را در تنظیم pool ببینید.

۴. تست

curl -sI https://example.com/ | grep -i x-cache
curl -sI https://example.com/ | grep -i x-cache

بار اول باید MISS و بار دوم HIT ببینید. برای wp-admin باید BYPASS یا هیچ مقدار کشی نبینید. کوکی واردشده را هم شبیه‌سازی کنید تا مطمئن شوید صفحهٔ شخصی کش نمی‌شود.

۵. پاک‌کردن کش

پس از انتشار محتوای مهم، پاک‌کردن کش لازم است: یا با افزونهٔ پاک‌سازی سازگار با FastCGI یا با حذف فایل‌های مسیر کش. برای فشرده‌سازی و هدرهای فایل ایستا gzip و کش ایستا را هم ببینید.

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

فرض کنید صفحهٔ اصلی پیش از کش در هر بازدید PHP را اجرا می‌کرد. پس از فعال‌سازی، بازدید دوم HIT شد و درخواست‌های ناشناس دیگر به PHP-FPM نرسیدند. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی؛ سرعت واقعی را روی سایت خودتان بسنجید.

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

  • کش‌کردن صفحات کاربر واردشده.
  • فراموش‌کردن استثنای سبد خرید و پرداخت.
  • کش‌کردن پاسخ‌های با query string پویا.
  • پاک‌نکردن کش پس از به‌روزرسانی محتوا.

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

با افزونهٔ کش هم‌زمان استفاده کنم؟ بهتر است یک لایهٔ کش صفحه داشته باشید تا رفتارها قاطی نشود.

X-Cache BYPASS یعنی چه؟ یعنی شرط عبور فعال شد و صفحه از کش نیامد.

کش چقدر معتبر بماند؟ بسته به نرخ تغییر محتوا؛ چند دقیقه تا یک ساعت معمول است.

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

  1. مسیر کش ساخته و دسترسی داده شد.
  2. شرط‌های عبور نوشته شد.
  3. هدر X-Cache اضافه شد.
  4. MISS و HIT تست شد.
  5. کوکی واردشده و wp-admin کش نمی‌شوند.

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

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

منابع رسمی

Nginx fastcgi_cache · WordPress: performance optimization