Mise à niveau de FreeScout vers PHP 8.5 (liste de contrôle Ubuntu 26.04)
Avant de passer FreeScout à PHP 8.5, confirmez que FreeScout et chaque module que vous utilisez le prennent en charge, puis vérifiez les extensions PHP, redémarrez le worker de file d'attente et surveillez le journal pour deprecated since 8.5 messages. Ubuntu 26.04 installe PHP 8.5 par défaut, donc une mise à niveau du système d'exploitation est souvent ce qui déclenche le changement.
Cela compte davantage pour FreeScout que pour la plupart des applications PHP, en raison de la façon dont FreeScout gère les avis de dépréciation.
Pourquoi PHP 8.5 peut casser les modules FreeScout
Chaque version de PHP déprécie certaines fonctions plus anciennes. PHP 8.5 déprécie plusieurs fonctions qui ne faisaient plus rien depuis PHP 8.0, notamment curl_close(), imagedestroy(), et xml_parser_free(). Elle déprécie également certains cas limites, comme l'utilisation de null comme clé de tableau ou en passant chr() une valeur en dehors de 0 à 255.
La plupart des applications PHP journalisent une dépréciation et continuent. FreeScout transforme chaque avis de dépréciation en erreur, donc un seul appel résiduel arrête la requête ou la tâche en arrière-plan qui l'a rencontré. Un module peut sembler installé et sain alors que chaque connexion qu'il établit échoue.
Si vous voyez ces erreurs après la mise à jour, Corriger les erreurs « deprecated since 8.5 » dans FreeScout explique comment trouver et corriger le module responsable.
Avant votre mise à niveau
- Vérifier le support : lisez les notes de version et les prérequis système de FreeScout pour PHP 8.5, et confirmez que chaque module installé dispose d'une version compatible PHP 8.5.
- Mettez d'abord à jour les modules : installez ces mises à jour pendant que vous êtes encore sur votre version PHP actuelle, afin que chaque module soit prêt avant le passage.
- Sauvegarde : faites une copie du répertoire FreeScout, de la base de données et de vos fichiers de configuration PHP.
- Tester sur une copie : si possible, exécutez la mise à niveau sur une copie de préproduction du centre d'aide d'abord.
Après votre mise à niveau
Vérifier la version de PHP utilisée par FreeScout
Ouvrir Gérer > Système. Il affiche la version de PHP utilisée par votre serveur web et liste les extensions PHP dont FreeScout a besoin, en signalant celles qui manquent.Faire correspondre le PHP en ligne de commande
Exécuterphp -vsur le serveur. Le worker de file d'attente et leschedule:runcron utilise le PHP en ligne de commande, qui peut différer de la version du serveur web. Les deux doivent exécuter la même version avec les mêmes extensions.Réinstaller les extensions et les paramètres
Une nouvelle version de PHP arrive avec ses propres paquets d'extensions etphp.inifichiers. Installez les extensions Gérer > Système marque comme manquants, puis réappliquez les paramètres personnalisés tels queupload_max_filesizeetpost_max_size.Pointez le serveur web vers le nouveau PHP
Si vous utilisez PHP-FPM, confirmez que votre serveur web utilise le socket ou le service PHP 8.5 FPM, puis redémarrez PHP-FPM et le serveur web.Vider les caches et redémarrer le worker de file d'attente
Exécutez ces commandes depuis votre répertoire FreeScout afin qu'aucun processus ne continue d'exécuter l'ancien code :terminalphp artisan freescout:clear-cache php artisan queue:restart
Ce qu'il faut vérifier dans les journaux
Ouvrir Gérer > Journaux > Journaux d'application après avoir utilisé le help desk pendant un certain temps. Recherchez :
is deprecated since 8.5, qui pointe vers un module ou un fichier qui n'est pas encore prêt pour PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, depuischr()appels.Using null as an array offset is deprecated.
Chaque entrée nomme le fichier. Un chemin sous Modules/<Name> vous indique quel module nécessite une mise à jour.
Testez les fonctionnalités qui établissent des connexions sortantes, car ce sont elles qui échouent en premier : récupération du courrier, fournisseurs IA, sources de connaissances et intégrations telles que Linear, Jira, Slack ou les connecteurs de boutique. Lorsqu'un module propose un Tester la connexion bouton, utilisez-le.
Si quelque chose ne fonctionne pas
Remettez FreeScout sur PHP 8.4 en attendant les mises à jour. PHP 8.4 ne traite pas ces fonctions comme dépréciées, donc le même code s'exécute normalement. Basculez à la fois le serveur web et le PHP en ligne de commande, puis redémarrez PHP-FPM, le serveur web et le worker de file d'attente.