Actualizar PHP en producción sin downtime: canary, reload y rollback
Cambiar de versión de PHP no es un deploy: son dos pools de FPM, dos sockets y dos OPcache. Con un canary y un reload ordenado, la web no se entera; con un restart a las once de la mañana, sí.
Por qué ahora: el parche del 19 de noviembre
El equipo de PHP publicó el 19 de noviembre las actualizaciones 8.2.36, 8.3.37, 8.4.28 y 8.5.13. Según el recuento de BleepingComputer son 18 fallos corregidos y siete críticos, entre ellos CVE-2026-115560 en el progreso de subida de sesiones, CVE-2026-126714 (phpAfterShell) en el manejador de sesiones por ficheros y CVE-2026-129289 en PHP-FPM con cuerpos de petición que nunca se leen. Cloudflare sacó el mismo día una release de emergencia de su WAF.
Instalar el parche es media hora. Lo que casi nadie documenta es la otra mitad: cambiar la versión que sirve tu aplicación, en caliente, con vuelta atrás en un minuto. Si ya tienes el deploy montado con releases por symlink, la parte de ficheros está resuelta; si no, empieza por la guía de deploy de Laravel 13 en un VPS y vuelve después. Aquí se trata solo del runtime.
Antes de tocar nada: inventario de lo que corre
Qué binario sirve cada sitio
El error de base es creer que el php de la terminal es el que atiende las peticiones. No tiene por qué. Comprueba las tres capas por separado:
Lee también
php -v; which php
ls -l /run/php/*.sock
systemctl list-units 'php*-fpm*'
Y en nginx, el destino real de cada server block: grep -rn fastcgi_pass /etc/nginx/. Ese socket es la verdad. Todo lo demás son pistas.
Extensiones y plataforma
Guarda la lista de módulos de la rama vieja en un fichero y no la pierdas, porque la vas a comparar al final:
php -m > /tmp/php-viejo-modulos.txt
Antes de instalar nada, deja que Composer haga de semáforo. composer check-platform-reqs dice qué extensiones exige el proyecto y si están; composer why-not php 8.5 lista los paquetes que bloquean la rama objetivo. Si una extensión no tiene build para la versión nueva, el cambio se para aquí, no a mitad del reload.
Instalar la rama nueva en paralelo
Paquetes y servicios por versión
En Debian y Ubuntu, con el repositorio de Sury, cada rama es un paquete y un servicio independientes. Instalar 8.5 no toca 8.2:
apt install php8.5-fpm php8.5-cli php8.5-mysql php8.5-mbstring php8.5-xml php8.5-curl php8.5-zip php8.5-bcmath php8.5-intl
Quedan dos servicios arriba a la vez, cada uno con su socket. No se desinstala nada todavía: esa es precisamente la red de seguridad. Si usas otra distro, los nombres cambian y el patrón no: un pool por rama, un socket por pool.
Validar la configuración
Antes de arrancar, comprueba la sintaxis del pool nuevo y compáralo con el viejo: usuario, listen, pm.max_children, slowlog. Los valores por defecto son distintos entre paquetes y un pm.max_children de 5 donde había 25 se convierte en cola de espera.
php-fpm8.5 -t
Si la configuración pasa, arranca el servicio. Nginx sigue apuntando al socket viejo, así que en este punto la web no ha cambiado nada.
systemctl start php8.5-fpm
Mover el tráfico sin cortar
Nginx: cambiar el socket destino
Un solo carácter separa el cambio de la caída: el destino del fastcgi_pass.
fastcgi_pass unix:/run/php/php8.5-fpm.sock;
Después, nginx -t y systemctl reload nginx. El reload de nginx no tumba el servicio: el master relee la configuración y los workers viejos terminan lo que tienen entre manos. Un restart, en cambio, cierra el socket de escucha y ahí sí hay hueco.
Reload de FPM frente a restart
El otro lado del cambio. systemctl reload php8.5-fpm manda la señal USR2 al proceso master: cada worker acaba la petición en curso y se recicla con el código nuevo. restart mata el master y arranca de cero, con un intervalo en el que nadie atiende.
El reload tiene límites y conviene saberlos: no basta si cambias el listen, el usuario del pool o si añades una extensión nueva, porque eso se lee solo al arrancar el master. Para el cambio de versión que nos ocupa, reload es suficiente.
Lo que no se recarga solo: OPcache, preload y workers
OPcache y preload
Con opcache.validate_timestamps=0, lo normal en producción, el código compilado vive en memoria y no se entera de que los ficheros cambiaron. Por eso el reload de FPM es parte del cambio y no un extra: al reciclar los workers, el OPcache se llena otra vez. Si prefieres no reciclar todavía, un opcache_reset() controlado hace lo mismo sin tocar el servicio.
El opcache.preload es otra historia: se ejecuta una sola vez, al arrancar el master. Si el script de preload falla en la rama nueva, el servicio arranca pero sin precarga, y lo notas en el primer pico. Y ojo con la CLI: tiene su propio OPcache y no sirve como referencia de lo que ve la web. Si quieres medir el efecto real del cambio en el TTFB, la teoría está en caché de página en Laravel 13.
Colas, Horizon y scheduler
Los workers son procesos de larga vida: siguen con el binario viejo hasta que los reinicias.
php artisan queue:restart
Si usas Horizon, php artisan horizon:terminate después de cambiar la ruta del binario en supervisor. Y revisa el crontab, que es el olvido clásico:
crontab -l | grep php
Si dice /usr/bin/php8.2 artisan schedule:run, tu scheduler se queda en la rama vieja aunque la web ya esté en la nueva. El mismo chequeo vale para cualquier unidad de systemd que lance PHP.
Canary y verificación
Mandar una parte del tráfico primero
Con los dos pools vivos puedes repartir por peso desde nginx y ver qué pasa antes de mover el 100%:
upstream php_app { server unix:/run/php/php8.2-fpm.sock weight=9; server unix:/run/php/php8.5-fpm.sock weight=1; }
Un diez por ciento durante media hora, mirando 5xx, TTFB y las líneas de deprecación del log, te ahorra el descubrimiento a las once y media. Si algo se tuerce, el peso vuelve a 0 y listo.
Checklist post-cambio
Un endpoint propio protegido que devuelva PHP_VERSION es la prueba más rápida de qué está sirviendo de verdad. Añade: comparar php -m con el fichero del inventario, revisar que storage/logs/laravel.log no se llene de avisos de deprecación, probar a mano una subida de ficheros y el login, y pasar por el formulario más pesado de la app.
Rollback en un minuto
Como no desinstalamos la rama vieja, volver es revertir el destino y recargar:
fastcgi_pass unix:/run/php/php8.2-fpm.sock; · nginx -t && systemctl reload nginx
Y devolver el cron y los workers al binario anterior. Guarda el diff de nginx en el repositorio antes de tocar nada: el rollback es tan rápido como el último commit que hiciste.
Automatizar el próximo cambio
Cada rama recibe parches cada cuatro semanas, así que esto se repite. Vale la pena dejarlo como script idempotente: comprobar la versión actual, instalar la rama nueva, validar, recargar, verificar y avisar. Y no confundas esto con actualizar el sistema operativo, que es otro procedimiento: para eso está la guía de Ubuntu 26.04 LTS.
Conclusión
El parche urgente de hoy y el cambio de rama de dentro de seis meses usan el mismo mecanismo: un socket, un reload y un canary. Dominarlo es lo que separa "actualizar" de "rezar mientras nginx responde 502". Si este paso a paso te sirvió, en el blog hay más guías de servidores y despliegues sin downtime.

