Fehler "deprecated since 8.5" in FreeScout beheben
Wenn FreeScout-Funktionen nach dem Wechsel zu PHP 8.5 nicht mehr funktionieren, prüfen Sie das FreeScout-Protokoll auf Meldungen, die enden mit is deprecated since 8.5. Jeder nennt die Datei, die ihn verursacht hat. Aktualisieren Sie das Modul oder die FreeScout-Komponente, die diese Datei besitzt, leeren Sie den Cache und starten Sie den Queue-Worker neu.
PHP 8.5 ist die Standard-PHP-Version auf Ubuntu 26.04, daher treten diese Fehler oft direkt nach einem Betriebssystem-Upgrade auf.
Symptome
FreeScout selbst lädt in der Regel noch, aber einzelne Funktionen schlagen fehl:
- Ein Modul Verbindung testen Schaltfläche meldet, dass sie einen Server nicht erreichen kann.
- Hintergrundjobs wie Synchronisierung, Abruf oder KI-Entwurfserstellung liefern keine Ergebnisse mehr.
- Eine Integration, die vor dem Upgrade funktionierte, wird still.
- Eine Einstellungsseite oder Aktion gibt einen Serverfehler zurück.
Das verräterische Zeichen ist, dass curl an dieselbe Adresse funktioniert von der Kommandozeile des Servers, während das Modul meldet, dass es keine Verbindung herstellen kann.
Die Log-Nachrichten
Öffnen Sie das Anwendungsprotokoll von FreeScout (Verwalten > Protokolle > App-Protokolle, oder storage/logs/laravel-<date>.log auf dem Server). PHP 8.5-Deprecations sehen so aus:
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 insteadDas Modul fügt normalerweise eigenen Kontext um die Nachricht hinzu, wie den Job oder die Anfrage, die fehlgeschlagen ist.
Warum es passiert
PHP 8.5 stuft einige ältere Funktionen und Randfälle als veraltet ein. Mehrere, wie curl_close() und imagedestroy(), haben seit PHP 8.0 nichts getan, sodass älterer Code sie noch aufruft.
In den meisten PHP-Apps ist eine Deprecation nur eine Warnung im Log. FreeScout behandelt jede Deprecation-Meldung als Fehler. Daher kann eine Anfrage erfolgreich abgeschlossen werden und dann an einem übrig gebliebenen Aufruf wie diesem scheitern curl_close(). Ihre URLs, API-Schlüssel, Ihr Netzwerk und Ihre PHP-Erweiterungen sind normalerweise in Ordnung.
Behebung: den betroffenen Code aktualisieren
Die Datei im Log-Eintrag finden
Öffnen Sie den vollständigen Log-Eintrag. Ein Pfad unterModules/<Name>verweist auf dieses Modul. Ein Pfad unterapp/odervendor/verweist auf FreeScout selbst.Aktualisieren Sie dieses Modul oder FreeScout
Öffnen Verwalten > Module und installieren Sie alle verfügbaren Updates, oder prüfen Sie die Website des Modulentwicklers auf eine PHP-8.5-kompatible Version. Aktualisieren Sie für FreeScout selbst auf die neueste Version.Den Cache leeren und den Queue-Worker neu starten
Führe diese aus deinem FreeScout-Verzeichnis aus. Der Queue-Worker ist ein langlaufender Prozess, daher behält er den alten Code, bis er neu startet.Terminalphp artisan freescout:clear-cache php artisan queue:restartFehlgeschlagenes erneut versuchen
Klicken Verbindung testen erneut, starten Sie jede gestoppte Synchronisierung neu und bestätigen Sie, dass neue Hintergrundjobs abgeschlossen werden.
Bestätigen, dass es funktioniert hat
- Die fehlgeschlagene Funktion funktioniert wieder.
- Neue Protokolleinträge erwähnen nicht mehr
is deprecated since 8.5.
Wenn noch kein Update verfügbar ist
Betreibe FreeScout auf PHP 8.4, bis der Entwickler einen Fix veröffentlicht. PHP 8.4 behandelt diese Funktionen nicht als veraltet, sodass derselbe Code dort normal läuft.
Beide PHP-Versionen umstellen, die FreeScout verwendet. Verwalten > System zeigt die Version, die Ihr Webserver ausführt. Der Queue-Worker und Cron verwenden PHP auf der Kommandozeile, prüfen Sie also php -v auch auf dem Server. Starten Sie dann PHP-FPM oder Ihren Webserver und den Queue-Worker neu.
Für den vollständigen Umzug siehe FreeScout auf PHP 8.5 upgraden.
ReplyRabbit und PHP 8.5