→ سیستم‌نامه

یک افزونه‌ی لاگین که کل کش سایت را خاموش کرده بود: پرونده‌ی DONOTCACHEPAGE

5 دقیقه مطالعهآخرین بروزرسانی: سپتامبر 8, 2026

یک افزونه‌ی لاگین، بدون هیچ ربط ظاهری به کش، تمام Public Page Cache یک فروشگاه پرترافیک را خاموش کرده بود — و پیدا کردنش به یک ردیابی مرحله‌به‌مرحله نیاز داشت، نه یک نگاه سطحی به تنظیمات.

سرنخ اول: چرا صفحه‌ی اصلی هیچ‌وقت از کش سرو نمی‌شود؟

بعد از رفع مشکل اتصال دیتابیس (که در مقاله‌های قبلی این مجموعه توضیح داده شد)، نوبت بررسی خود Homepage رسید. یک Query Profiler اختصاصی روی صفحه‌ی اصلی اجرا شد و عدد اول ترسناک بود:

Duration: 5.633 sec
WPDB Queries: 1297 (1266 SELECT / 16 INSERT / 5 SHOW / 5 UPDATE / 1 DELETE)

با تفکیک این کوئری‌ها بر اساس منبع (Source)، مشخص شد بیشترین سهم از این پلاگین‌ها و کامپوننت‌ها می‌آید: Elementor، WooCommerce، Woodmart (قالب سایت)، ldd-ultra-light، Advanced Woo Labels، Smart Coupons، Wordfence، sync-basalam، Elementor Pro. نکته‌ی مهم همین‌جا بود: به‌جای گفتن کلی «المنتور سنگینه»، دقیقاً مشخص شد کدام Component چقدر کوئری تولید می‌کند — چون بدون این تفکیک، هر تصمیم بعدی فقط حدس است.

اما عدد ۱۲۹۷ کوئری فقط وقتی فاجعه‌بار است که این صفحه اصلاً کش نشود و هر بازدید دوباره همه‌ی این کوئری‌ها را از نو اجرا کند. پس سوال اصلی این شد: چرا LiteSpeed Cache دارد همه‌ی این‌ها را برای هر بازدیدکننده از نو اجرا می‌کند؟

سرنخ دوم: DONOTCACHEPAGE

ابزار دیباگ خود LiteSpeed بالاخره دلیل را مستقیم گفت:

forced no cache [reason] DONOTCACHEPAGE const
role id: failed, guest

یعنی حتی یک کاربر مهمانِ ساده هم Cache نمی‌شد — دقیقاً همان کسی که Public Page Cache اصلاً برایش ساخته شده. جست‌وجوی سراسری سایت برای این ثابت (constant) نشان داد رد پایش در چند پلاگین دیده می‌شود: Wordfence، WooCommerce، Payzito، Elementor، Query Monitor، LiteSpeed Cache، خود WP Rocket. اما همین‌جا یک اشتباه رایج در کمین است: صرف وجود یک رشته‌ی متنی در کد یک پلاگین، دلیل نمی‌شود که همان پلاگین مقصر واقعی باشد. باید دید در همین اجرای مشخص، کدام‌شان واقعاً این ثابت را فعال کرده.

سرنخ سوم: ردیابی مرحله‌به‌مرحله، نه حدس

برای همین به‌جای شک‌کردن به مظنون «همیشگی» (قالب سنگین Woodmart)، چند Trace مرحله‌ای دقیقاً همان لحظه‌ای که این ثابت مقدار می‌گیرد ثبت شدند. نتیجه غیرمنتظره و بسیار روشن بود:

BEFORE PRIORITY 100: FALSE

digits_login
BEFORE=FALSE
AFTER=TRUE

XTS\Modules\Quick_Buy\Redirect::add_to_cart_action
BEFORE=TRUE
AFTER=TRUE

مقصر واقعی digits_login بود — بخشی از افزونه‌ی لاگین Digits — نه Woodmart، که فقط بعد از آن اجرا می‌شد و مقدار را همان‌طور TRUE تحویل می‌گرفت (بی‌گناه، ولی چون دومین اسم در Trace بود، به‌راحتی می‌شد اشتباهی به‌جای مقصر واقعی گرفته شود). این دقیقاً همان نکته‌ای است که بدون ردیابی مرحله‌به‌مرحله، به‌راحتی گمراه‌کننده می‌شود: ترتیب اجرا با مسئولیت واقعی یکی نیست.

مشکل بزرگ‌تر این بود که سورس digit.php با ionCube رمزنگاری شده بود — یعنی امکان باز کردن و اصلاح تمیز آن تابع داخلی وجود نداشت. یک افزونه‌ی لاگین، بدون هیچ اشاره‌ی ظاهری به کش، داشت با یک خط کد داخلی، Public Cache کل سایت را برای هر بازدیدکننده خاموش می‌کرد — و چون بسته بود، نمی‌شد از داخل خودش درستش کرد.

سرنخ چهارم: رفع یک مشکل، مشکل دوم را آشکار کرد

حتی بعد از اینکه DONOTCACHEPAGE مربوط به Digits برای LiteSpeed نادیده گرفته شد، باز هم Cache فعال نشد. Trace بعدی نشان داد یک لایه‌ی مشکل دیگر هم وجود دارد:

DNC_RAW=TRUE
DNC_EFFECTIVE=FALSE
CACHEABLE=NO

یعنی پرچم DONOTCACHEPAGE خنثی شده بود، ولی State داخلی خودِ LiteSpeed هنوز صفحه را Cacheable اعلام نمی‌کرد. بررسی Hookهای ثبت‌شده‌ی LiteSpeed نشان داد کال‌بک استاندارد آن برای علامت‌گذاری صفحه به‌عنوان قابل‌کش (Control::set_cacheable) روی این سایت اصلاً ثبت نشده بود — یعنی حتی وقتی مانع اول برداشته شد، هیچ‌کس به LiteSpeed نمی‌گفت «حالا این صفحه رو کش کن».

راه‌حل: یک Hotfix محدود و هدفمند

به‌جای ادامه دادن دیباگ طولانی برای پیدا کردن چرایی دقیق نبود آن Hook، یک MU Plugin بسیار محدود نوشته شد: فقط برای درخواست GET صفحه‌ی اصلی توسط کاربر مهمان، اول پرچم DONOTCACHEPAGE مربوط به Digits نادیده گرفته می‌شد، و بعد مستقیماً از API داخلی LiteSpeed خواسته می‌شد صفحه را Cacheable اعلام کند:

do_action(
    'litespeed_control_set_cacheable',
    'LaraStores homepage hotfix'
);

نتیجه بلافاصله در هدر پاسخ دیده شد:

x-litespeed-cache: hit

بعد از کل این دیباگ، برای اولین بار Public Page Cache واقعی روی صفحه‌ی اصلی کار کرد.

گسترش با احتیاط، نه سرخوشانه

بعد این Hotfix به بقیه‌ی صفحات عمومی سنگین فروشگاه هم گسترش یافت (صفحه‌ی اصلی، لیست محصولات، دسته‌بندی‌ها، برندها، صفات محصول)، اما با چند مانع محافظتی روشن:

هرگز کش نمی‌شود اگر URL شامل query string باشد:
?filter_...  ?min_price=...  ?orderby=...  ?s=...  ?add-to-cart=...  ?utm_source=...

هرگز کش نمی‌شود برای:
AJAX / REST / Cron / صفحات ادمین / کاربر لاگین‌کرده
یا مهمانی که سبد خرید/سشن فعال WooCommerce دارد

نتیجه

این پرونده نشان داد یک افزونه‌ی به‌ظاهر بی‌ربط (لاگین) می‌تواند بدون هیچ نشانه‌ی آشکاری، کل مکانیزم کش عمومی سایت را از کار بیندازد؛ و اینکه رفع یک نشانه (پرچم DONOTCACHEPAGE) کافی نیست اگر لایه‌ی زیرین (موتور کش) هم واقعاً صفحه را Cacheable اعلام نکند. راه‌حل درست، حدس‌زدن روی «مظنون همیشگی» نبود؛ یک ردیابی مرحله‌به‌مرحله‌ی دقیق بود که مقصر واقعی را — حتی وقتی سورسش رمزنگاری‌شده و غیرقابل‌اصلاح بود — از بیرون خنثی کرد، و در نهایت یک Hotfix محدود و محافظه‌کارانه که فقط جایی فعال می‌شود که واقعاً امن است.

SOS سایتت خوابیده؟