Aggiornare FreeScout a PHP 8.5 (checklist Ubuntu 26.04)
Prima di spostare FreeScout su PHP 8.5, conferma che FreeScout e ogni modulo che usi lo supportino, poi controlla le estensioni PHP, riavvia il queue worker e osserva il log per deprecated since 8.5 messaggi. Ubuntu 26.04 installa PHP 8.5 per impostazione predefinita, quindi un aggiornamento del sistema operativo è spesso ciò che innesca il cambiamento.
Questo conta di più per FreeScout che per la maggior parte delle app PHP, a causa di come FreeScout gestisce gli avvisi di deprecazione.
Perché PHP 8.5 può rompere i moduli FreeScout
Ogni versione di PHP depreca alcune funzioni più vecchie. PHP 8.5 depreca diverse funzioni che non facevano nulla da PHP 8.0, tra cui curl_close(), imagedestroy(), e xml_parser_free(). Depreca anche alcuni casi limite, come l'uso di null come chiave di array o passando chr() un valore fuori da 0 a 255.
La maggior parte delle app PHP registra una deprecazione e continua. FreeScout trasforma ogni avviso di deprecazione in un errore, quindi una singola chiamata residua blocca la richiesta o il job in background che l'ha incontrata. Un modulo può sembrare installato e sano mentre ogni connessione che effettua fallisce.
Se vedi questi errori dopo l'aggiornamento, Correggi gli errori "deprecated since 8.5" in FreeScout spiega come individuare e correggere il modulo responsabile.
Prima dell'aggiornamento
- Controlla il supporto: leggi le note di rilascio e i requisiti di sistema di FreeScout per PHP 8.5 e conferma che ogni modulo installato abbia una release compatibile con PHP 8.5.
- Aggiorna prima i moduli: installa quegli aggiornamenti mentre sei ancora sulla tua versione PHP attuale, così ogni modulo è pronto prima del passaggio.
- Backup: fai una copia della directory di FreeScout, del database e dei tuoi file di configurazione PHP.
- Prova su una copia: se puoi, esegui l'aggiornamento prima su una copia di staging dell'help desk.
Dopo l'aggiornamento
Controlla la versione di PHP con cui viene eseguito FreeScout
Apri Gestisci > Sistema. Mostra la versione PHP usata dal tuo server web ed elenca le estensioni PHP necessarie a FreeScout, segnalando quelle mancanti.Abbina il PHP da riga di comando
Eseguiphp -vsul server. Il queue worker e ilschedule:runcron usano il PHP da riga di comando, che può differire dalla versione del server web. Entrambi devono eseguire la stessa versione con le stesse estensioni.Reinstalla estensioni e impostazioni
Una nuova versione di PHP arriva con i propri pacchetti di estensioni ephp.inifile. Installa le estensioni Gestisci > Sistema contrassegna come mancante, poi riapplica impostazioni personalizzate comeupload_max_filesizeepost_max_size.Punta il server web al nuovo PHP
Se usi PHP-FPM, verifica che il tuo web server usi il socket o il servizio PHP 8.5 FPM, poi riavvia PHP-FPM e il web server.Svuota le cache e riavvia il worker della coda
Esegui questi comandi dalla tua directory FreeScout in modo che nessun processo continui a eseguire codice vecchio:terminalephp artisan freescout:clear-cache php artisan queue:restart
Cosa controllare nei log
Apri Gestisci > Log > Log dell'app dopo aver usato l'help desk per un po'. Cerca:
is deprecated since 8.5, che punta a un modulo o file non ancora pronto per PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, dachr()chiamate.Using null as an array offset is deprecated.
Ogni voce indica il file. Un percorso sotto Modules/<Name> ti dice quale modulo necessita di un aggiornamento.
Verifica le funzionalità che effettuano connessioni in uscita, perché sono le prime a fallire: recupero della posta, provider AI, fonti di conoscenza e integrazioni come Linear, Jira, Slack o connettori dei negozi. Dove un modulo offre un Verifica connessione pulsante, usalo.
Se qualcosa si rompe
Riporta FreeScout a PHP 8.4 mentre aspetti gli aggiornamenti. PHP 8.4 non tratta queste funzioni come deprecate, quindi lo stesso codice funziona normalmente lì. Passa sia il server web che il PHP da riga di comando, poi riavvia PHP-FPM, il server web e il worker della coda.