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

حل بقاء كود PHP القديم بعد النشر باستخدام OPcache

إذا كانت الملفات الجديدة على القرص والتطبيق يتصرف كإصدار قديم، فـOPcache أحد الاحتمالات، إلى جانب CDN وPage Cache ومسار الإصدار.

حل بقاء كود PHP القديم بعد النشر باستخدام OPcache

شخّص تخزين opcode وصمّم نشرًا منسقاً دون كشف phpinfo أو endpoint reset عام.

النطاق والمتطلبات

حدّد إصدار PHP وخدمة FPM والإعداد الفعلي لـSAPI الويب. قد يختلف php -i الخاص بـCLI عن FPM. اقرأ الحالة عبر آلية إدارة محمية فقط. استبدل php8.3-fpm بالإصدار المثبت وتأكد من مسار الإصدار الفعلي.

١. اجمع الأدلة

قارن معرّف الإصدار الداخلي بمسار الملف ثم استبعد CDN وPage Cache في اختبار مضبوط. اقرأ validate_timestamps وrevalidate_freq في إعداد الويب الفعلي. عند تعطيل فحص الوقت لا تُلتقط التغييرات تلقائياً، ونسبة الإصابة العالية لا تثبت حداثة الكود.

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

٢. نفّذ تغييراً مضبوطاً

لتحديث الملفات في مكانها، ابدأ بفحص timestamps مفعّل. يحتاج النشر immutable مع تعطيله إلى تحديث cache لـSAPI الويب ضمن rollout. استدعاء opcache_reset من CLI لا يعيد عادة cache FPM. لا تنشئ reset عاماً أو تخدم إصداراً نصف منسوخ.

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

٣. تحقّق من النتيجة

افحص إعداد FPM وحدّث cache بالطريقة المدعومة للتوزيعة. قد يقطع restart خدمة منفردة؛ استخدم rollout تدريجياً مع النسخ. يجب أن تعرض جميعها الإصدار المطلوب. اختبر الصفحات العامة والخاصة والمهام الخلفية والتراجع لا الصفحة الرئيسية فقط.

# 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

التراجع والوقاية

قد يمزج التراجع عن الملفات دون تحديث OPcache الإصدارات. احتفظ بالإعدادات وchecksums. اختر memory_consumption وفق القياس وعدد السكربتات؛ زيادته لا تصلح الكود القديم. اختلاف الإصدار وأخطاء ما بعد النشر أهم من hit ratio وحده.

لفحص الجوانب المرتبطة بهذا المسار، راجع ترحيل روابط ووردبريس بأمان عبر WP-CLI Search-Replace وتخزين آمن في Nginx Proxy Cache دون تسريب الصفحات الخاصة.

المراجع التقنية