Sistem Güncelleme — VERSION Dosyası ve .env Önceliği

Otomatik güncelleme servisi devreye girdikten sonra uygulama sürümü tek bir kaynaktan yönetilir: proje kökündeki VERSION dosyası. Bu dosyayı sistem güncelleme servisi otomatik olarak günceller; geliştiricinin veya yöneticinin elle dokunmasına gerek yoktur.

Sürüm okuma sırası (gösterim)

1. Proje kökündeki VERSION dosyası — UTF-8 BOM ve satır sonları temizlenir; ilk satır MAJOR.MINOR.PATCH biçimindeyse kullanılır.
2. .env içindeki APP_VERSION — yalnızca VERSION dosyası yoksa veya biçim geçersizse devreye girer.
3. Hard-coded fallback — yukarıdakilerin hiçbiri yoksa baseline kullanılır.

v1.4.95: Üst menüdeki sürüm rozeti, php artisan config:cache kullanılsa bile her HTTP isteğinde VERSION dosyasından yeniden okunur; böylece zip ile güncelledikten sonra arayüzde eski yama (ör. 1.4.91) takılı kalmaz.

.env içinde APP_VERSION var mı diye nasıl bakarım?

cd /var/www/vhosts/<domain>/<site>
grep "^APP_VERSION" .env

Bir satır dönerse ve kökte geçerli bir VERSION dosyanız varsa, o satır artık gösterimde kullanılmaz; yine de .env'i temiz tutmak için silebilirsiniz:

sed -i '/^APP_VERSION/d' .env
php artisan config:clear

Sürüm değişmediğinde kontrol listesi

Yeni paket uygulandı, rozet veya “Mevcut sürüm” güncellenmedi mi? Sırayla:

1. cat VERSION — beklenen yamayı gösteriyor mu? Hayır ise zip dosyaları yanlış dizine yazılıyor veya izin hatası vardır.
2. Sistem güncelleme kaydı: Ayarlar → Sistem güncelleme sayfasındaki system_update_logs tablosu; başarısız satırda detail alanına bakın.
3. Laravel günlüğü (v1.4.95+): Başarılı uygulamadan sonra storage/logs/laravel.log içinde system_update.applied satırı aranır (sürüm, dosya sayısı, batch).
4. php artisan tinker --execute='echo config("app.version");' — VERSION ile aynı mı?
5. php artisan optimize:clear — güncelleme sonrası zaten çalıştırılır; elle de deneyin.
6. PHP-FPM / Octane: worker yeniden yükleyin (systemctl reload …-fpm veya Octane için yeniden başlatma).

Geliştiriciler için

• Zip kökünde tek satırlık VERSION dosyası bulunmak zorunda.
• config/app.php içinde sürüm sabit yazılmaz; InstalledAppVersion kullanılır.