Correggi gli errori "deprecated since 8.5" in FreeScout
Se le funzionalità di FreeScout smettono di funzionare dopo il passaggio a PHP 8.5, controlla il log di FreeScout per i messaggi che terminano con is deprecated since 8.5. Ognuno indica il file che lo ha causato. Aggiorna il modulo o il componente FreeScout che possiede quel file, svuota la cache e riavvia il worker della coda.
PHP 8.5 è la versione PHP predefinita su Ubuntu 26.04, quindi questi errori compaiono spesso subito dopo un aggiornamento del sistema operativo.
Sintomi
FreeScout stesso di solito si carica ancora, ma singole funzionalità falliscono:
- Il Verifica connessione il pulsante segnala che non riesce a raggiungere un server.
- I processi in background, come sincronizzazione, recupero o generazione di bozze AI, smettono di produrre risultati.
- Un'integrazione che funzionava prima dell'aggiornamento smette di rispondere.
- Una pagina di impostazioni o un'azione restituisce un errore del server.
Il segno rivelatore è che curl allo stesso indirizzo funziona dalla riga di comando del server, mentre il modulo dice che non riesce a connettersi.
I messaggi di log
Apri il log dell'applicazione di FreeScout (Gestisci > Log > Log dell'app, oppure storage/logs/laravel-<date>.log sul server). Le deprecazioni di PHP 8.5 appaiono così:
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 insteadIl modulo di solito aggiunge il proprio contesto attorno al messaggio, come il job o la richiesta che non è andata a buon fine.
Perché accade
PHP 8.5 depreca alcune funzioni e casi limite più vecchi. Diverse, come curl_close() e imagedestroy(), non fanno nulla da PHP 8.0, quindi il codice più vecchio li chiama ancora.
Nella maggior parte delle app PHP una deprecazione è solo un avviso nel log. FreeScout tratta ogni avviso di deprecazione come un errore. Quindi una richiesta può completarsi con successo e poi fallire su una chiamata residua come curl_close(). I tuoi URL, le chiavi API, la rete e le estensioni PHP di solito sono a posto.
Correzione: aggiorna il codice interessato
Trova il file nella voce di log
Apri la voce di log completa. Un percorso sottoModules/<Name>punta a quel modulo. Un percorso sottoapp/oppurevendor/punta a FreeScout stesso.Aggiorna quel modulo o FreeScout
Apri Gestisci > Moduli e installa eventuali aggiornamenti disponibili, o controlla il sito dello sviluppatore del modulo per una versione compatibile con PHP 8.5. Per FreeScout stesso, aggiorna all'ultima release.Svuota la cache e riavvia il worker della coda
Esegui questi comandi dalla tua directory FreeScout. Il worker della coda è un processo a lunga esecuzione, quindi continua a usare il codice vecchio finché non si riavvia.terminalephp artisan freescout:clear-cache php artisan queue:restartRiprova ciò che non è riuscito
Clicca Verifica connessione di nuovo, riesegui qualsiasi sincronizzazione interrotta e conferma che i nuovi job in background vengano completati.
Conferma che abbia funzionato
- La funzionalità che non funzionava funziona di nuovo.
- Le nuove voci di log non menzionano più
is deprecated since 8.5.
Se non è ancora disponibile un aggiornamento
Esegui FreeScout su PHP 8.4 finché lo sviluppatore non rilascia una correzione. PHP 8.4 non considera queste funzioni deprecate, quindi lo stesso codice funziona normalmente lì.
Cambia entrambe le versioni di PHP usate da FreeScout. Gestisci > Sistema mostra la versione eseguita dal tuo server web. Il worker della coda e il cron usano PHP da riga di comando, quindi controlla php -v anche sul server. Poi riavvia PHP-FPM o il tuo server web, e il queue worker.
Per lo spostamento completo, vedi Aggiornare FreeScout a PHP 8.5.
ReplyRabbit e PHP 8.5