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

رفع کد قدیمی پس از Deploy با تنظیم درست PHP OPcache

اگر فایل جدید روی دیسک است اما برنامه هنوز رفتار نسخه قبلی را دارد، OPcache یکی از مظنون‌هاست؛ ولی CDN، Page Cache و release path نیز باید بررسی شوند.

رفع کد قدیمی پس از Deploy با تنظیم درست PHP OPcache

این راهنما تشخیص cache opcode و طراحی deploy هماهنگ را بدون انتشار phpinfo یا endpoint reset عمومی توضیح می‌دهد.

دامنه و پیش‌نیازها

نسخه PHP، سرویس FPM و فایل ini مؤثر را برای SAPI وب تعیین کنید. خروجی php -i مربوط CLI ممکن است با FPM متفاوت باشد. status و configuration را فقط در مسیر مدیریت محافظت‌شده یا ابزار داخلی بخوانید. نمونه سرویس php8.3-fpm را با نسخه نصب‌شده جایگزین کنید.

۱. شواهد را جمع‌آوری کنید

شناسه release را در پاسخ داخلی و مسیر فایل ثبت کنید، سپس CDN و Page Cache را از آزمون کنار بگذارید. در OPcache، مقدار validate_timestamps و revalidate_freq را بخوانید. خاموش‌بودن validate_timestamps یعنی تغییر فایل الزاماً خودکار دیده نمی‌شود؛ hit rate بالا نشانه به‌روز بودن کد نیست.

systemctl list-units "php*-fpm.service"
# CLI values are clues, not proof of the web SAPI configuration.
php --ini
php -v

۲. تغییر کنترل‌شده

برای محیطی که فایل‌ها درجا تغییر می‌کنند، نمونه validation روشن مناسب شروع است. در deploy immutable با validation خاموش، refresh همان SAPI باید بخشی از rollout باشد. اجرای opcache_reset() از CLI معمولاً cache FPM را reset نمی‌کند. reset عمومی نسازید و فایل‌های هم‌زمان نیمه‌کپی‌شده را در production سرو نکنید.

; Example for environments using in-place file updates
opcache.enable=1
opcache.validate_timestamps=1
opcache.revalidate_freq=2

۳. نتیجه را آزمایش کنید

پیکربندی FPM را تست و refresh را مطابق روش توزیع انجام دهید. در سرویس تک‌نمونه‌ای، restart می‌تواند وقفه ایجاد کند؛ برای چند Replica rollout تدریجی بهتر است. تمام Replicaها باید شناسه نسخه یکسان بدهند. صفحات خصوصی و عمومی، jobهای پس‌زمینه و مسیر rollback را نیز آزمایش کنید.

# Substitute the actual installed PHP/FPM version.
sudo php-fpm8.3 -t
# Planned restart may interrupt requests on a single instance.
sudo systemctl restart php8.3-fpm
systemctl is-active php8.3-fpm

بازگشت و پیشگیری

بازگشت release روی دیسک بدون refresh متناظر OPcache ممکن است نسخه‌ها را مخلوط کند. تنظیمات قبلی و checksum نسخه را نگه دارید. memory_consumption را از measured usage و تعداد اسکریپت انتخاب کنید؛ افزایش آن مشکل stale code را حل نمی‌کند. هشدار اختلاف release و خطاهای پس از deploy از Hit Ratio مهم‌تر است.

برای بررسی بخش‌های مرتبط این مسیر، راهنماهای مهاجرت امن URL وردپرس با WP-CLI و داده Serialized و کش امن Reverse Proxy در Nginx؛ جلوگیری از کش صفحات خصوصی را نیز ببینید.

منابع فنی