FreeScout'u PHP 8.5'e yükseltme (Ubuntu 26.04 kontrol listesi)
FreeScout'u PHP 8.5'e taşımadan önce FreeScout'un ve çalıştırdığınız her modülün bunu desteklediğini doğrulayın, ardından PHP uzantılarını kontrol edin, kuyruk worker'ını yeniden başlatın ve günlükte şunu izleyin deprecated since 8.5 mesajlar. Ubuntu 26.04 varsayılan olarak PHP 8.5 yükler, bu yüzden değişikliği genellikle bir işletim sistemi yükseltmesi tetikler.
Bu, FreeScout'un kullanımdan kaldırma bildirimlerini nasıl ele aldığı nedeniyle çoğu PHP uygulamasından daha çok FreeScout için önemlidir.
PHP 8.5 neden FreeScout modüllerini bozabilir
Her PHP sürümü bazı eski işlevleri kullanımdan kaldırır. PHP 8.5, PHP 8.0'den beri hiçbir şey yapmayan birkaç işlevi kullanımdan kaldırır, bunlar arasında curl_close(), imagedestroy(), ve xml_parser_free(). Ayrıca şunu kullanmak gibi bazı uç durumları da kullanımdan kaldırır: null dizi anahtarı olarak veya şunu geçirerek: chr() 0 ile 255 aralığı dışında bir değer.
Çoğu PHP uygulaması bir kullanımdan kaldırma uyarısını günlüğe kaydeder ve devam eder. FreeScout her kullanımdan kaldırma bildirimini bir hataya dönüştürür, bu yüzden tek bir kalan çağrı, ona çarpan isteği veya arka plan görevini durdurur. Bir modül kurulu ve sağlıklı görünebilirken kurduğu her bağlantı başarısız olabilir.
Yükseltmeden sonra bu hataları görürseniz, FreeScout'ta "deprecated since 8.5" hatalarını düzeltin sorumlu modülü bulma ve düzeltme adımlarını açıklar.
Yükseltmeden önce
- Desteği kontrol edin: FreeScout'un PHP 8.5 sürüm notlarını ve sistem gereksinimlerini okuyun ve kurulu her modülün PHP 8.5 uyumlu bir sürümü olduğunu doğrulayın.
- Önce modülleri güncelleyin: bu güncellemeleri hâlâ mevcut PHP sürümünüzdeyken yükleyin, böylece her modül geçişten önce hazır olur.
- Yedekle: FreeScout dizininin, veritabanının ve PHP yapılandırma dosyalarınızın bir kopyasını alın.
- Bir kopya üzerinde test edin: mümkünse yükseltmeyi önce yardım masasının bir hazırlık kopyasında çalıştırın.
Yükselttikten sonra
FreeScout'un çalıştırdığı PHP sürümünü kontrol edin
Aç Yönet > Sistem. Web sunucunuzun kullandığı PHP sürümünü gösterir ve FreeScout'un ihtiyaç duyduğu PHP uzantılarını listeler, eksik olanları işaretler.Komut satırı PHP'siyle eşleştirin
Çalıştırphp -vsunucuda. Kuyruk çalışanı veschedule:runcron, web sunucusunun sürümünden farklı olabilen komut satırı PHP'sini kullanır. Her ikisi de aynı sürümü aynı uzantılarla çalıştırmalıdır.Uzantıları ve ayarları yeniden yükleyin
Yeni bir PHP sürümü kendi uzantı paketleriyle gelir vephp.inidosyaları. Uzantıları yükleyin: Yönet > Sistem eksik olarak işaretler, ardından şu gibi özel ayarları yeniden uygular:upload_max_filesizevepost_max_size.Web sunucusunu yeni PHP'ye yönlendirin
PHP-FPM kullanıyorsanız, web sunucunuzun PHP 8.5 FPM soketini veya hizmetini kullandığını doğrulayın, ardından PHP-FPM'i ve web sunucusunu yeniden başlatın.Önbellekleri temizleyin ve kuyruk çalışanını yeniden başlatın
Eski kodu çalıştırmaya devam eden bir işlem olmaması için bunları FreeScout dizininizden çalıştırın:terminalphp artisan freescout:clear-cache php artisan queue:restart
Günlüklerde neleri kontrol etmeli
Aç Yönet > Günlükler > Uygulama Günlükleri yardım masasını bir süre kullandıktan sonra. Şunu arayın:
is deprecated since 8.5, henüz PHP 8.5'e hazır olmayan bir modül veya dosyaya işaret eder.Providing a value not in-between 0 and 255 is deprecated, şuradan:chr()çağrılar.Using null as an array offset is deprecated.
Her giriş dosyayı adlandırır. Şu altındaki bir yol Modules/<Name> hangi modülün güncelleme gerektirdiğini size söyler.
Giden bağlantı kuran özellikleri test edin, çünkü bunlar önce başarısız olur: posta alma, yapay zeka sağlayıcıları, bilgi kaynakları ve Linear, Jira, Slack veya mağaza bağlayıcıları gibi entegrasyonlar. Bir modülün sunduğu yerde Bağlantıyı test et düğmesini kullanın.
Bir şey bozulursa
Güncellemeleri beklerken FreeScout'u PHP 8.4'e geri taşıyın. PHP 8.4 bu işlevleri kullanımdan kaldırılmış olarak değerlendirmez, bu yüzden aynı kod orada normal çalışır. Hem web sunucusunu hem de komut satırı PHP'sini değiştirin, ardından PHP-FPM'i, web sunucusunu ve kuyruk çalışanını yeniden başlatın.