Actualizar FreeScout a PHP 8.5 (lista de comprobación de Ubuntu 26.04)
Antes de pasar FreeScout a PHP 8.5, confirma que FreeScout y todos los módulos que usas lo admiten, luego revisa las extensiones de PHP, reinicia el worker de la cola y vigila el registro en busca de deprecated since 8.5 mensajes. Ubuntu 26.04 instala PHP 8.5 por defecto, así que una actualización del sistema operativo suele ser lo que provoca el cambio.
Esto importa más para FreeScout que para la mayoría de las aplicaciones PHP, por cómo FreeScout gestiona los avisos de obsolescencia.
Por qué PHP 8.5 puede romper los módulos de FreeScout
Cada versión de PHP deprecia algunas funciones más antiguas. PHP 8.5 deprecia varias funciones que no hacen nada desde PHP 8.0, incluyendo curl_close(), imagedestroy(), y xml_parser_free(). También deja obsoletos algunos casos límite, como usar null como clave de array o pasando chr() un valor fuera de 0 a 255.
La mayoría de las aplicaciones PHP registran una deprecación y continúan. FreeScout convierte cada aviso de deprecación en un error, por lo que una sola llamada sobrante detiene la solicitud o el trabajo en segundo plano que la encontró. Un módulo puede parecer instalado y saludable mientras cada conexión que realiza falla.
Si ves estos errores después de actualizar, Corregir errores de "deprecated since 8.5" en FreeScout explica cómo encontrar y corregir el módulo responsable.
Antes de actualizar
- Comprobar soporte: lee las notas de la versión y los requisitos del sistema de FreeScout para PHP 8.5, y confirma que cada módulo instalado tenga una versión compatible con PHP 8.5.
- Actualiza primero los módulos: instala esas actualizaciones mientras sigues en tu versión actual de PHP, para que todos los módulos estén listos antes del cambio.
- Copia de seguridad: haz una copia del directorio de FreeScout, la base de datos y tus archivos de configuración de PHP.
- Probar en una copia: si puedes, ejecuta la actualización primero en una copia de pruebas del help desk.
Después de actualizar
Comprobar la versión de PHP con la que se ejecuta FreeScout
Abrir Gestionar > Sistema. Muestra la versión de PHP que usa tu servidor web y enumera las extensiones de PHP que necesita FreeScout, señalando las que faltan.Coincide con el PHP de la línea de comandos
Ejecutarphp -ven el servidor. El worker de la cola y elschedule:runcron usa PHP de línea de comandos, que puede diferir de la versión del servidor web. Ambos deben ejecutar la misma versión con las mismas extensiones.Reinstalar extensiones y configuración
Una nueva versión de PHP viene con sus propios paquetes de extensiones yphp.iniarchivos. Instala las extensiones Gestionar > Sistema marca como faltantes, y luego vuelve a aplicar ajustes personalizados comoupload_max_filesizeypost_max_size.Apunte el servidor web al nuevo PHP
Si usas PHP-FPM, confirma que tu servidor web usa el socket o servicio PHP 8.5 FPM, luego reinicia PHP-FPM y el servidor web.Limpiar las cachés y reiniciar el worker de la cola
Ejecuta estos comandos desde tu directorio de FreeScout para que ningún proceso siga ejecutando código antiguo:terminalphp artisan freescout:clear-cache php artisan queue:restart
Qué comprobar en los registros
Abrir Gestionar > Registros > Registros de la aplicación después de usar el help desk durante un tiempo. Busca:
is deprecated since 8.5, que apunta a un módulo o archivo que aún no es compatible con PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, desdechr()llamadas.Using null as an array offset is deprecated.
Cada entrada nombra el archivo. Una ruta bajo Modules/<Name> te indica qué módulo necesita una actualización.
Prueba las funciones que realizan conexiones salientes, porque son las que fallan primero: obtener correo, proveedores de IA, fuentes de conocimiento e integraciones como Linear, Jira, Slack o conectores de tiendas. Cuando un módulo ofrece un Probar conexión botón, úsalo.
Si algo falla
Vuelve a FreeScout a PHP 8.4 mientras esperas las actualizaciones. PHP 8.4 no trata estas funciones como obsoletas, por lo que el mismo código se ejecuta normalmente allí. Cambia tanto el servidor web como el PHP de la línea de comandos, luego reinicia PHP-FPM, el servidor web y el trabajador de la cola.