DeployerPHP zero-downtime deploy'da OPcache'ten gelen 500 hatalarını nasıl engellerim?

Kısa cevap: Symlink çevirmek atomik ama yeterli değil — flip’ten sonra PHP-FPM’i graceful reload etmeniz lazım; OPcache’i hiçbir release’ten sonra eski koda yapışık bırakmayın.

Yaşadığınız şey klasik OPcache cache poisoning: OPcache, derlenmiş bytecode’u dosya yoluna göre keyler. current symlink’inin kendi yolu hiç değişmediği için worker’lar bir önceki release’in bytecode’unu sunmaya devam eder; bazı worker’lar eski, bazıları yeni realpath’i görünce dosya yolları karışır ve 500 patlar.

1. En temiz yol: symlink’ten sonra PHP-FPM’i graceful reload edin. kill -USR2 <fpm-master> ya da systemctl reload php-fpm — bu, FPM’in yeni realpath’i görmesini sağlar ve OPcache’i tazeler. Reload, restart değil: mevcut istekler tamamlanır, yeni worker’lar yeni kodu derler, kesinti olmaz. Deployer’da bunu deploy:symlink adımına hook’layın.
2. Alternatif: opcache_reset()’i deploy hook’undan çağırın. FPM soketine cachetool ile bağlanıp cache’i resetlemek, web’den bir reset endpoint’i tetiklemekten daha temiz — CLI ve FPM ayrı OPcache tutar, yani php artisan ile resetlemek FPM’i etkilemez. Reload bunu zaten kapsadığı için çoğu zaman gerek kalmaz.
3. opcache.revalidate_freq’i ayarlamak tek başına çözüm değil. Aynı dosya yolu değiştiğinde işe yarar; ama release’ler arası yol farkında revalidate sizi kurtarmaz. Release sınırında garantili olan reset/reload’dur.
4. Octane bambaşka bir hikaye. Octane’de kod diskten değil bellekten sunulur; uzun ömürlü worker’lar eski sınıfları RAM’da tutar. Symlink flip’ten sonra php artisan octane:reload ile worker’ları yenilemeniz şart, yoksa OPcache’i ne yaparsanız yapın eski kod ayakta kalır.

Sonuç: Akış net olsun — symlink’i çevirin → PHP-FPM’i graceful reload edin (Octane’deyseniz octane:reload) → isterseniz opcache_reset. Bunu Deployer’da symlink adımına bağlayın ve bir release’ten sonra OPcache’i asla eski koda yapışık bırakmayın. Octane’in bellekte kod tutmasının deploy tarafındaki bedeli ayrı bir hub yazısının konusu; oradaki kalıcı-süreç modelini iyi tanırsanız bu reload adımını atlamazsınız.