Corriger les erreurs « deprecated since 8.5 » dans FreeScout
Si les fonctionnalités FreeScout cessent de fonctionner après votre passage à PHP 8.5, consultez le journal FreeScout pour les messages se terminant par is deprecated since 8.5. Chacune nomme le fichier qui l'a causée. Mettez à jour le module ou le composant FreeScout propriétaire de ce fichier, videz le cache et redémarrez le worker de file d'attente.
PHP 8.5 est la version PHP par défaut sur Ubuntu 26.04, ces erreurs apparaissent donc souvent juste après une mise à niveau du système d'exploitation.
Symptômes
FreeScout lui-même se charge généralement encore, mais des fonctionnalités individuelles échouent :
- Le Tester la connexion bouton indique qu'il ne peut pas joindre un serveur.
- Les tâches en arrière-plan, comme la synchronisation, la récupération ou la génération de brouillons IA, cessent de produire des résultats.
- Une intégration qui fonctionnait avant la mise à niveau devient silencieuse.
- Une page de paramètres ou une action renvoie une erreur serveur.
Le signe révélateur est que curl à la même adresse fonctionne depuis la ligne de commande du serveur, tandis que le module indique qu'il ne peut pas se connecter.
Les messages de journal
Ouvrez le journal d'application de FreeScout (Gérer > Journaux > Journaux d'application, ou storage/logs/laravel-<date>.log sur le serveur). Les dépréciations PHP 8.5 ressemblent à ceci :
Function curl_close() is deprecated since 8.5, as it has no effect since PHP 8.0
Function imagedestroy() is deprecated since 8.5, as it has no effect since PHP 8.0
chr(): Providing a value not in-between 0 and 255 is deprecated
Using null as an array offset is deprecated, use an empty string insteadLe module ajoute généralement son propre contexte autour du message, comme la tâche ou la requête qui a échoué.
Pourquoi cela se produit
PHP 8.5 déprécie quelques fonctions et cas limites plus anciens. Plusieurs, comme curl_close() et imagedestroy(), ne font plus rien depuis PHP 8.0, donc le code plus ancien les appelle encore.
Sur la plupart des applications PHP, une dépréciation n'est qu'un avertissement dans le journal. FreeScout traite chaque avis de dépréciation comme une erreur. Ainsi une requête peut aboutir puis échouer sur un appel résiduel comme curl_close(). Vos URL, clés API, réseau et extensions PHP sont généralement corrects.
Correction : mettez à jour le code concerné
Trouvez le fichier dans l'entrée du journal
Ouvrez l'entrée complète du journal. Un chemin sousModules/<Name>pointe vers ce module. Un chemin sousapp/ouvendor/pointe vers FreeScout lui-même.Mettez à jour ce module ou FreeScout
Ouvrir Gérer > Modules et installez les mises à jour disponibles, ou consultez le site du développeur du module pour une version compatible PHP 8.5. Pour FreeScout lui-même, mettez à jour vers la dernière version.Vider le cache et redémarrer le worker de file d'attente
Exécutez ces commandes depuis votre répertoire FreeScout. Le worker de file d'attente est un processus de longue durée, il conserve donc l'ancien code jusqu'à son redémarrage.terminalphp artisan freescout:clear-cache php artisan queue:restartRéessayer ce qui a échoué
Cliquer Tester la connexion à nouveau, relancez toute synchronisation interrompue et confirmez que les nouvelles tâches en arrière-plan se terminent.
Confirmer que cela a fonctionné
- La fonctionnalité qui avait échoué fonctionne à nouveau.
- Les nouvelles entrées de journal ne mentionnent plus
is deprecated since 8.5.
Si aucune mise à jour n'est encore disponible
Exécutez FreeScout sur PHP 8.4 jusqu'à ce que le développeur publie un correctif. PHP 8.4 ne traite pas ces fonctions comme obsolètes, le même code s'exécute donc normalement.
Basculez les deux versions de PHP utilisées par FreeScout. Gérer > Système affiche la version exécutée par votre serveur web. Le worker de file d'attente et le cron utilisent PHP en ligne de commande, donc vérifiez php -v sur le serveur aussi. Ensuite, redémarrez PHP-FPM ou votre serveur web, et le worker de file d'attente.
Pour le déplacement complet, voir Mise à niveau de FreeScout vers PHP 8.5.
ReplyRabbit et PHP 8.5