Mi web falla después de actualizar PHP: cómo localizar la incompatibilidad
Investiga errores de código, extensiones y configuración después del cambio. Distingue un parche de seguridad de un salto de rama y prueba la recuperación.
Si una web falla después de actualizar PHP, registra qué cambió y localiza el primer error relacionado con el recorrido afectado. La causa puede estar en el código, una extensión, una dependencia o la configuración cargada por el nuevo proceso. Volver a la versión anterior puede recuperar disponibilidad, pero no explica ni corrige la incompatibilidad.
Distinguir parche y cambio de rama
Anota versiones anteriores y actuales con la revisión del proveedor. Aplicar una corrección dentro de una rama no tiene el mismo alcance que pasar a otra con cambios de lenguaje y comportamiento.
PHP publica guías de migración, como la de 8.4 a 8.5. Consulta las correspondientes al salto real, especialmente si atraviesas varias ramas. Una aplicación compatible con una versión no queda automáticamente validada para todas las posteriores.
Definir qué parte dejó de funcionar
Comprueba si falla toda la web o solo administración, formulario, checkout, importación o cron. Anota hora, URL y acción, junto con el resultado esperado. Evita reproducir una compra con cobro real solo para obtener un error.
Una portada que responde no demuestra que los recorridos dinámicos estén bien. La caché puede ocultar el problema en algunas páginas mientras la aplicación falla cuando necesita ejecutar PHP.
Leer el error en un entorno adecuado
Consulta logs de PHP, servidor y aplicación con acceso restringido. Mantén fuera de las páginas públicas trazas, rutas y datos de configuración. El error que ve el visitante puede ser solo una respuesta genérica del servidor.
Separa avisos de compatibilidad de errores que detienen la operación. No todos tienen el mismo impacto y algunas aplicaciones convierten determinados avisos en excepciones. Relaciona el mensaje con el momento y el recorrido antes de modificar componentes.
Comparar extensiones y configuración
Revisa si el nuevo entorno tiene las extensiones que requiere la aplicación y si están cargadas en el proceso web. Una instalación nueva puede no conservar todos los módulos o ajustes del servicio anterior.
El manual de configuración de PHP documenta la carga de archivos y directorios adicionales. Compara los valores efectivos, no solo un archivo que crees que utiliza la web. Incluye memoria, límites de subida, zona horaria y rutas cuando estén relacionados con el fallo.
Localizar código o dependencias incompatibles
En WordPress revisa core, tema, plugins y personalizaciones. En una aplicación propia incluye framework, bibliotecas y código heredado. La traza puede señalar una dependencia, pero también hay que entender qué llamada la alcanza.
Reproduce la combinación en staging cuando sea viable y cambia componentes de forma controlada. Desactivar todos los plugins en producción sin conocer su función puede interrumpir pedidos, formularios o integraciones que sí estaban operando.
Si necesitas preparar ese entorno, consulta cómo crear staging sin afectar la tienda. Para documentar el fallo, utiliza la guía de errores reproducibles.
Decidir la recuperación según el riesgo
Si la actualización corrige una vulnerabilidad, volver al intérprete sin parche recupera también esa exposición. La decisión puede necesitar restricción temporal de acceso o una alternativa corregida y compatible, coordinada con el proveedor.
Conserva registro del cambio y evita restaurar una base de datos antigua sobre pedidos nuevos. Recuperar archivos, configuración y datos son operaciones distintas: cada una debe tener su propio alcance.
Validar después de corregir
Comprueba el recorrido que fallaba, las funciones críticas y las tareas en segundo plano. Confirma que todos los procesos usan el entorno previsto y revisa los logs tras las pruebas.
La actualización de PHP con compatibilidad puede incluir estas comprobaciones. Si la causa es específica del CMS, realizamos un diagnóstico WordPress; para código heredado, delimitamos el trabajo dentro del mantenimiento de aplicaciones.