PHP Version Upgrade
Migra una web a una rama soportada de PHP con entornos aislados, comparación funcional y plan de reversión.
- Actualizado:
- Palabras:
- 1145
- Descargas semanales:
- 0
- Descargas totales:
- 0
Enlaces relacionados
Subir de versión de PHP sin romper la web
Usa esta skill cuando una web corre en una rama sin soporte (5.x, 7.x, 8.0 u 8.1) o cuando un parche de seguridad no llega a su rama. La idea es demostrar en local que la web funciona igual en la versión de destino y después cambiarla en producción de forma reversible.
Elige como destino la rama soportada más alta que admita la aplicación. Para WordPress, comprueba la versión de PHP recomendada para su núcleo y la compatibilidad declarada por cada plugin y tema.
1. Inventario
- Versión y SAPI actuales: mod_php, FPM, LSAPI o CGI.
- Extensiones en uso (
php -m) y si existen en la versión de destino. Algunas desaparecen o pasan a PECL:mcrypten 7.2,imap,pspellyoci8en 8.4. - Límites propios de la web:
memory_limit,upload_max_filesize,post_max_size,max_execution_timeymax_input_vars. Los paneles pueden guardarlos por dominio o por versión; comprueba qué valores se heredan realmente al cambiar. En un servidor sin panel, los valores por defecto de la nueva versión pueden ser otros. - Código propio frente a código de terceros. Los plugins y temas actualizados suelen funcionar; el código propio y los plugins abandonados son donde aparecen los errores.
2. Copia local aislada
-
Prepara una copia privada del código y una base de datos de prueba saneada, con credenciales distintas de producción. Incluye medios de prueba representativos si los flujos los necesitan; omite cachés y datos personales innecesarios.
-
Levanta dos entornos con imágenes oficiales (
php:X.Y-apacheowordpress:phpX.Y-apache, másmariadbomysql): uno con la versión actual y otro con la de destino. -
Ponlos en una red Docker
--internal, sin salida a Internet, y publica los puertos solo en127.0.0.1. Desactiva el envío real de correo, las integraciones y las tareas automáticas; usa servicios simulados locales. No conectes la copia a la base de producción. -
En WordPress, crea una configuración de prueba:
- base de datos local;
WP_HOMEcon el dominio real, resuelto como alias de red hacia el contenedor;WP_DEBUG_LOG,FS_METHOD=direct,AUTOMATIC_UPDATER_DISABLED,DISABLE_WP_CRONyWP_HTTP_BLOCK_EXTERNAL.
Sin
FS_METHOD=direct, WordPress puede intentar actualizarse por FTP y dar errores que no tienen que ver con PHP. -
Da permisos de lectura al servidor web dentro del contenedor. Un 403 generalizado suele ser de permisos de la copia.
3. Análisis estático por diferencia
Pasa PHPCompatibility (o PHPCompatibilityWP) dos veces, con --runtime-set testVersion <destino> y con la versión actual, y quédate solo con lo que aparece en la de destino. Revisa aparte los problemas que ya existen: no descartes un hallazgo solo porque aparezca en ambos entornos. La comparación evita confundir regresiones con usos condicionales, como el uso condicional de mcrypt o mysql_ en plugins de copias de seguridad.
4. Prueba funcional en ambas versiones
- Recorre la portada, las páginas enlazadas desde ella, la búsqueda, el login (GET y POST), la API REST, el sitemap y una URL inexistente.
- Ejecuta el código de administración: con
wp-cli, lista los plugins activos y lanzaadmin_init. Haz lo mismo con las tareas programadas y los formularios propios. - Compara los códigos HTTP y el log de errores entre las dos versiones. Distingue regresiones nuevas de fallos previos. Un fallo previo de seguridad o en un flujo crítico también puede impedir el despliegue.
- Borra las copias al terminar, porque contienen datos.
5. Cambios que rompen código, por salto
| Salto | Qué revisar |
|---|---|
| 5.x → 7.0 | Desaparecen mysql_* y ereg*, el modificador /e de preg_replace y las etiquetas <% / <script language="php">. Muchos errores fatales pasan a ser Error capturables. Cambia la sintaxis uniforme de variables ($$a['b']). Los constructores con el nombre de la clase pasan a estar obsoletos |
| 7.0 → 7.4 | mcrypt desaparece en 7.2. each() y create_function() pasan a estar obsoletos. Las llaves para acceder a caracteres ($s{0}) y el cast (real) pasan a estar obsoletos en 7.4 |
| 7.4 → 8.0 | Cambia la comparación entre cadenas y números ("abc" == 0 es false). Muchos avisos se convierten en TypeError o ValueError. Desaparecen each(), create_function(), money_format() y track_errors. @ ya no oculta errores fatales. Los parámetros obligatorios después de opcionales pasan a estar obsoletos |
| 8.0 → 8.1 | Pasar null a parámetros no anulables de funciones internas pasa a estar obsoleto. Aparecen tipos de retorno "tentativos" en clases internas. Serializable sin __serialize también queda obsoleto |
| 8.1 → 8.2 | Las propiedades dinámicas pasan a estar obsoletas, igual que utf8_encode()/utf8_decode() y la interpolación ${var} |
| 8.2 → 8.3 | Pocos cambios incompatibles. Revisa las obsoletas de la guía de migración oficial |
| 8.3 → 8.4 | Los tipos anulables implícitos (Type $x = null) pasan a estar obsoletos. E_STRICT queda obsoleto. imap, pspell y oci8 salen del núcleo |
| 8.4 → 8.5 | Consulta la guía de migración oficial de php.net antes de saltar |
Los avisos de obsolescencia pueden afectar a aplicaciones que los convierten en excepciones; su eliminación futura no tiene una fecha uniforme. Saltos grandes (de 5.x a 8.x) conviene hacerlos por etapas en local (por ejemplo 5.6 → 7.4 → 8.3) para saber en qué paso aparece cada error.
6. Cambio en producción
- Con panel: cambia la versión de un dominio cada vez. Comprueba primero el alcance del selector y el procedimiento de reversión: puede afectar a varios dominios o necesitar reiniciar workers.
- cPanel: MultiPHP Manager.
- Plesk:
plesk bin site --update <dominio> -php_handler_id <handler>. - DirectAdmin: selector de PHP por dominio.
- CloudLinux: PHP Selector.
- Sin panel:
- Instala la nueva rama en paralelo (
phpX.Y-fpm), con un pool propio y las mismas extensiones. - Apunta el
SetHandlerofastcgi_passde la web al nuevo socket y recarga el servidor web. - Para volver atrás, restaura el socket anterior.
- Instala la nueva rama en paralelo (
- Antes y después de cada cambio: el estado de la web y las páginas clave, el log de errores del dominio y los 5xx. Vigila al menos 30 minutos.
- Orden: primero las webs de prueba y después las de producción.
- Reversión: define también cómo tratar escrituras y cambios de esquema. Si la versión anterior tiene una vulnerabilidad conocida, no restaures su exposición pública sin una medida de contención.
- Al terminar: deja la mitigación de seguridad vigente aplicada también en la nueva versión, y registra la versión de cada web y cómo revertir.
Referencias
Versiones (1)
| Versión | Descargas (semana) | Descargas (total) | Publicación |
|---|---|---|---|
0.1.0latest Primera publicación revisada con fuentes oficiales y verificación del runtime. | 0 | 0 | 21 de octubre de 2026 |