Cómo actualizar plugins de WordPress sin romper la web
Cuando actualizas un plugin, WordPress descarga la versión nueva, pone la web en mantenimiento, guarda una copia temporal de la carpeta antigua, la sustituye y vuelve a abrir. Si la instalación falla, restaura la copia (desde WordPress 6.3). Si la actualización es automática y la portada da un error fatal de PHP, también vuelve atrás (desde WordPress 6.6). No comprueba que la web siga funcionando: un formulario que ya no envía, un pago que falla o una página descuadrada no los detecta, y tampoco deshace los cambios que el plugin haya hecho en la base de datos.
Qué ocurre desde que pulsas «Actualizar ahora»
Los pasos están en las clases WP_Upgrader y Plugin_Upgrader del núcleo. Los hemos seguido en un WordPress 7.1.5 en español, mirando el disco en cada paso de la actualización de un plugin activo:
- Si el plugin está activo, WordPress crea el archivo
.maintenanceen la raíz de la instalación, la carpeta donde estáwp-admin. Es el modo de mantenimiento. - Descarga el zip de la versión nueva desde
downloads.wordpress.org. - Lo descomprime en
wp-content/upgrade/, dentro de una carpeta con el nombre del zip y un sufijo aleatorio. En nuestra prueba,classic-editor.1.7.0-sOl07lx0GLBY85qf. - Mueve la carpeta actual del plugin a
wp-content/upgrade-temp-backup/plugins/. Durante un momento el plugin no existe enwp-content/plugins. - Mueve la carpeta nueva a
wp-content/pluginsy vacíawp-content/upgrade. - Borra
.maintenancey, al terminar la petición, la copia temporal.
Si actualizas desde la lista de plugins o desde Escritorio > Actualizaciones, el plugin sigue activo todo el tiempo y la primera visita tras el mantenimiento ya carga el código nuevo. Las actualizaciones automáticas tampoco lo desactivan. Solo un camino más antiguo del código, el de la actualización individual en pantalla propia, lo desactiva antes de empezar y lo reactiva al terminar.
El archivo .maintenance y la web «atascada»
El archivo contiene una sola línea con la hora de inicio:
<?php $upgrading = 1795202894; ?>
Mientras existe, cualquier visita recibe una respuesta 503 con este texto: «No disponible temporalmente por mantenimiento programado. Vuelve a comprobarlo en unos minutos.».
La web se queda atascada cuando el proceso muere antes de borrar el archivo, por ejemplo porque se agota el tiempo de ejecución de PHP. WordPress ignora el archivo cuando la hora que contiene tiene más de diez minutos, así que el bloqueo caduca solo. Para salir antes, borra .maintenance por FTP o desde el gestor de archivos, o usa WP-CLI:
wp maintenance-mode deactivate
Después repite la actualización: según la documentación de WordPress, puede haberse quedado a medias.
La marcha atrás que ya trae WordPress
| Mecanismo | Desde | Cuándo actúa | Qué deja pasar |
|---|---|---|---|
| Restauración de la copia temporal | WordPress 6.3 | La instalación devuelve un error: no se pueden copiar los archivos o se agota el tiempo | Todo lo que ocurra con el plugin ya instalado |
| Marcha atrás de las actualizaciones automáticas | WordPress 6.6 | Tras una actualización automática de un plugin activo, la portada devuelve un error fatal de PHP | Errores fuera de la portada y cualquier fallo que no sea un error fatal |
La copia temporal del paso 4 llegó con WordPress 6.3. Antes, una actualización que fallaba con la carpeta antigua ya borrada te dejaba sin plugin. Lo hemos comprobado forzando un fallo al final de la instalación: el plugin volvió a la versión 1.5 que tenía y la copia temporal desapareció.
La segunda red es de WordPress 6.6 y solo vale para las actualizaciones automáticas. Después de instalar la versión nueva de un plugin activo, y con el mantenimiento todavía puesto, WordPress se pide a sí mismo la portada y busca un error fatal de PHP en la respuesta. Si lo encuentra, o si esa petición falla, restaura la versión anterior, avisa por correo, sigue con las demás actualizaciones y lo vuelve a intentar en la siguiente comprobación.
La comprobación mira una sola URL, la portada, así que un error fatal que solo aparece en el carrito o en el escritorio no cuenta. Tampoco cuenta nada que no sea un error fatal: un aviso de PHP, un error de JavaScript, un formulario que no envía, una pasarela de pago que rechaza los cobros o un diseño roto pasan por buenos. Y cuando actualizas a mano con el botón, esa comprobación no se hace.
Actualizaciones automáticas
Desde WordPress 5.5, la lista de plugins tiene una columna «Actualizaciones automáticas» con el enlace «Activar las actualizaciones automáticas» en cada fila. Vienen desactivadas y se eligen plugin a plugin.
WordPress busca versiones nuevas dos veces al día con tareas de WP-Cron, y en esa misma pasada instala las que tengas en automático. WP-Cron solo se ejecuta cuando alguien carga una página, de modo que en una web con pocas visitas la hora real es imprevisible.
Dos constantes de wp-config.php y un filtro mandan sobre lo que marques en el escritorio, según la documentación de administración avanzada:
AUTOMATIC_UPDATER_DISABLEDcon valortrueapaga todas las actualizaciones automáticas: núcleo, plugins, temas y traducciones.WP_AUTO_UPDATE_COREafecta solo al núcleo y admitetrue,falseo'minor'. No cambia nada en los plugins.- El filtro
auto_update_pluginfuerza o impide la actualización automática de los plugins, marques lo que marques en la columna, que no refleja ese cambio.
// En un plugin propio o en mu-plugins: todos los plugins en automático.
add_filter( 'auto_update_plugin', '__return_true' );
Después de cada tanda llega un correo a la dirección de administración (Ajustes > Generales) con el asunto «[Nombre del sitio] Algunos plugins se han actualizado automáticamente» o «[Nombre del sitio] Ha fallado la actualización de algunos plugins». Si nadie lee ese buzón, nadie se entera de una marcha atrás.
Por qué se rompe una web al actualizar
La primera causa es la versión de PHP. Si el plugin declara una versión mínima superior a la del servidor, WordPress no deja instalar la actualización y avisa: «Esta actualización no funciona con tu versión de PHP.». Se le escapa el plugin que usa funciones de un PHP más nuevo sin declararlo, y ese acaba en un error fatal, el que WordPress enseña como «Ha habido un error crítico en esta web».
La segunda es otro plugin o el tema. Una extensión que llama a funciones de un plugin principal falla cuando este las cambia o las retira en una versión mayor. Con los temas que sobrescriben plantillas de un plugin ocurre lo mismo, y ahí el fallo puede ser solo visual.
La tercera es la base de datos, que no vuelve atrás al restaurar los archivos. Muchos plugins modifican sus tablas u opciones la primera vez que se carga la versión nueva. Si después restauras los archivos antiguos, el código viejo se encuentra con datos en el formato nuevo. Ninguna de las dos redes de WordPress toca la base de datos: de ahí solo se vuelve con una copia anterior a la actualización.
Queda la actualización cortada a medias. Entre el paso 4 y el 5 la carpeta del plugin no existe o está incompleta. La restauración de 6.3 se ejecuta al cerrar la petición y cubre los errores de instalación y los tiempos agotados. Si el servidor mata el proceso sin dejarle terminar, puede quedar un plugin a medio copiar.
Cómo actualizar con red
- Haz una copia completa, de archivos y de base de datos: hacen falta las dos partes para recuperar una web. Una copia que nunca has restaurado puede estar incompleta sin que lo sepas, así que restáurala al menos una vez en otro sitio y mira que la web arranca. Para la base de datos sirve
wp db export antes-de-actualizar.sql. - Lee el registro de cambios cuando cambia el primer número de la versión, que es donde suelen retirarse funciones y migrarse datos. Busca avisos sobre la versión mínima de PHP, la base de datos y la compatibilidad con extensiones.
- Prueba antes en una copia de la web, con los mismos plugins, el mismo tema y la misma versión de PHP. Con una corrección menor puedes saltártelo; con un salto de versión mayor en una tienda, no.
- Actualiza de uno en uno. Si actualizas diez a la vez y algo falla, hay diez sospechosos.
- Mira la web después de cada uno: la portada, una página interior, un envío real del formulario y, en una tienda, el carrito y el pago. Hazlo en una ventana privada, sin sesión iniciada, para ver lo mismo que un visitante. Mide también el tiempo de respuesta y compáralo con el de antes: el servidor es el punto flojo de la mayoría de las webs con WordPress.
- Revisa el registro de errores: el de PHP de tu servidor o, si activas
WP_DEBUG_LOG, el archivowp-content/debug.log. Ahí aparece el error fatal de una URL que no has visitado.
Cómo volver a la versión anterior
Con WP-CLI es una línea. Las dos órdenes hacen lo mismo: update --version es por dentro una instalación forzada de esa versión.
wp plugin update nombre-del-plugin --version=1.2.3
wp plugin install nombre-del-plugin --version=1.2.3 --force
Sin acceso a la terminal, abre la ficha del plugin en WordPress.org, entra en «Vista avanzada» y baja hasta «Versiones anteriores»: eliges la versión, descargas el zip y lo subes desde Plugins > Añadir plugin > Subir plugin. WordPress detecta que ya está instalado y te ofrece «Reemplazar el actual con el subido».
Volver de versión solo cambia los archivos. Si la actualización modificó la base de datos, restaura también la copia del paso 1 y cuenta con perder lo que haya entrado desde entonces: pedidos, comentarios, envíos de formularios. Cuanto antes lo decidas, menos se pierde.
Cuándo no hay que esperar
Dejar pasar unos días antes de instalar una versión que solo trae funciones es razonable. Con una corrección de seguridad el cálculo cambia: desde que se publica, el parche es público y cualquiera puede compararlo con la versión anterior para ver qué arreglaba. Después solo hay que buscar webs que sigan sin actualizar.
El criterio que proponemos: si el registro de cambios menciona una corrección de seguridad, se aplica el mismo día con la copia hecha, aunque no dé tiempo a probarla antes en una copia de la web. Una web rota por una actualización se recupera con la copia. Una web comprometida obliga a limpiar, cambiar contraseñas y revisar qué se han llevado. Si no puedes actualizar, desactiva el plugin hasta que puedas, siempre que la web funcione sin él.
En los casos graves, WordPress.org puede marcar la actualización de un plugin para que se instale sola aunque no lo tengas en automático. La documentación los llama envíos de seguridad forzados, y devolver false en auto_update_plugin también los bloquea.
Si llevas muchas webs
El procedimiento de arriba funciona con una web o con cinco. Con cuarenta y actualizaciones cada semana no salen las cuentas, y lo primero que se abandona es la comprobación de después, justo la que WordPress no hace.
Hay tres piezas que automatizar, encadenadas:
- La copia previa, de archivos y base de datos, lanzada por la propia actualización y no por un calendario aparte. Una copia de anoche pierde los pedidos de hoy.
- La comprobación posterior, que vaya más allá de la portada: el código de respuesta de varias URL de cada web (incluidos el carrito y una página con formulario), un texto que debe seguir apareciendo en cada una y las líneas nuevas del registro de errores.
- La marcha atrás, que se dispare sola cuando falla la comprobación y que restaure la base de datos además de los archivos si el plugin la ha modificado.
Con eso montado tiene sentido escalonar: actualizar primero unas pocas webs, esperar unas horas y seguir con el resto si no ha saltado nada.
Fuentes
- Make WordPress Core: Controlling Plugin and Theme auto-updates UI in WordPress 5.5, New in 6.3: Rollback for failed manual plugin and theme updates, Merge Proposal: Rollback Auto-Update y WordPress 6.6 Field Guide.
- Código de WordPress: class-wp-upgrader.php, class-plugin-upgrader.php, class-wp-automatic-updater.php, load.php y update.php.
- Documentación de WordPress: Upgrading WordPress, Backups, Debugging in WordPress, FAQ Troubleshooting y Cron.
- WP-CLI: wp plugin update, wp plugin install, wp maintenance-mode, wp db export y el código de Plugin_Command.php.
- Textos en español: translate.wordpress.org.