← Volver a skills
[prompt]
php-version-upgradev0.1.0latest

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: mcrypt en 7.2, imap, pspell y oci8 en 8.4.
  • Límites propios de la web: memory_limit, upload_max_filesize, post_max_size, max_execution_time y max_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

  1. 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.

  2. Levanta dos entornos con imágenes oficiales (php:X.Y-apache o wordpress:phpX.Y-apache, más mariadb o mysql): uno con la versión actual y otro con la de destino.

  3. Ponlos en una red Docker --internal, sin salida a Internet, y publica los puertos solo en 127.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.

  4. En WordPress, crea una configuración de prueba:

    • base de datos local;
    • WP_HOME con el dominio real, resuelto como alias de red hacia el contenedor;
    • WP_DEBUG_LOG, FS_METHOD=direct, AUTOMATIC_UPDATER_DISABLED, DISABLE_WP_CRON y WP_HTTP_BLOCK_EXTERNAL.

    Sin FS_METHOD=direct, WordPress puede intentar actualizarse por FTP y dar errores que no tienen que ver con PHP.

  5. 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 lanza admin_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

SaltoQué revisar
5.x → 7.0Desaparecen 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.4mcrypt 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.0Cambia 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.1Pasar 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.2Las propiedades dinámicas pasan a estar obsoletas, igual que utf8_encode()/utf8_decode() y la interpolación ${var}
8.2 → 8.3Pocos cambios incompatibles. Revisa las obsoletas de la guía de migración oficial
8.3 → 8.4Los 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.5Consulta 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:
    1. Instala la nueva rama en paralelo (phpX.Y-fpm), con un pool propio y las mismas extensiones.
    2. Apunta el SetHandler o fastcgi_pass de la web al nuevo socket y recarga el servidor web.
    3. Para volver atrás, restaura el socket anterior.
  • 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ónDescargas (semana)Descargas (total)Publicación
0.1.0latest

Primera publicación revisada con fuentes oficiales y verificación del runtime.

0021 de octubre de 2026