Migración de PHP-FPM de la versión 8.2 a 8.4 en entornos Linux (Debian/Ubuntu) y restauración del servicio phpsessionclean

En entornos de producción, es común actualizar el motor de PHP para beneficiarse de nuevas funcionalidades, mejoras de rendimiento y parches de seguridad. Sin embargo, al migrar de PHP 8.2-FPM a PHP 8.4-FPM, pueden quedar residuos de configuración o servicios huérfanos, como el antiguo servicio php8.2-fpm, e incluso deshabilitarse utilidades como phpsessionclean encargadas de limpiar sesiones caducadas.

Este documento describe los pasos para:

Deshabilitar y eliminar PHP 8.2-FPM.
Configurar y verificar PHP 8.4-FPM como versión activa.
Restaurar y habilitar phpsessionclean.
Verificar que no existen referencias obsoletas a PHP 8.2.

Verificación de versiones instaladas

Antes de iniciar la limpieza, verificar qué versiones de PHP están presentes en el sistema:

service php
php8.2-fpm       php8.4-fpm       phpsessionclean

También se recomienda revisar los unit files de systemd:

systemctl list-unit-files | grep php

Eliminación de referencias a PHP 8.2-FPM

Si php8.2-fpm no está cargado como servicio nativo systemd pero sigue apareciendo en el sistema, suele deberse a que aún existe un script SysV en /etc/init.d/.

1 Eliminar enlaces SysV

sudo update-rc.d -f php8.2-fpm remove

2 Enmascarar la unidad para evitar activaciones accidentales

sudo systemctl mask php8.2-fpm

3 (Opcional) Purgar el paquete

sudo apt purge -y php8.2-fpm
sudo apt autoremove -y

Revisión de configuración en Nginx o Apache

Es imprescindible que todas las referencias al socket de PHP apunten a la versión 8.4:

grep -R "php8\.2" /etc/nginx/sites-enabled/ /etc/apache2/sites-enabled/ /etc/php/ -n

Si se encuentra:

fastcgi_pass unix:/run/php/php8.2-fpm.sock;

debe cambiarse por:

fastcgi_pass unix:/run/php/php8.4-fpm.sock;

Recargar el servicio web:

# Nginx
sudo nginx -t && sudo systemctl reload nginx

# Apache
sudo apachectl configtest && sudo systemctl reload apache2

Restauración de `phpsessionclean`

El servicio phpsessionclean se encarga de eliminar sesiones PHP caducadas y suele instalarse junto con php-common o phpX.Y-common.

1 Comprobar si existe como systemd timer

systemctl list-unit-files | grep phpsessionclean

Si existe, habilitarlo:

sudo systemctl enable --now phpsessionclean.timer

Forzar una ejecución manual:

sudo systemctl start phpsessionclean.service

2 Reinstalar el paquete si no existe

En sistemas con PHP 8.4 desde Sury o repos oficiales de Ubuntu/Debian:

sudo apt install --reinstall -y php8.4-common

sudo apt install --reinstall -y php-common

6. Verificación final

Comprobar servicios activos:

service php

Debería aparecer:

php8.4-fpm       phpsessionclean

Comprobar estado de PHP 8.4-FPM:

systemctl status php8.4-fpm

Comprobar el timer de limpieza de sesiones:

systemctl status phpsessionclean.timer

7. Conclusiones

Migrar de PHP 8.2-FPM a 8.4-FPM requiere más que instalar la nueva versión; es esencial limpiar restos de la anterior para evitar conflictos, así como asegurarse de que los servicios auxiliares como phpsessionclean continúan activos.

Siguiendo este procedimiento: