Cómo actualizar WordPress con WP-CLI: comandos y guía completa
Para actualizar WordPress, basta con acceder a wp-admin y seguir sus instrucciones. Sin embargo, si gestionamos una gran cantidad de instalaciones, puede ser tedioso actualizar todas de esta forma.
WP-CLI permite realizar esto con comandos y sin necesidad de acceder vía web a wp-admin. Es especialmente útil cuando gestionas múltiples instalaciones de WordPress en el mismo servidor — con un script de shell puedes actualizar todas en minutos.
Para usar WP-CLI necesitas acceso SSH al servidor. Consulta la guía cómo acceder por SSH a tu hosting de Nicalia.
Referencia rápida de comandos
| Comando | Qué hace |
|---|---|
wp core check-update |
Muestra si hay una actualización disponible del core de WordPress |
wp core update |
Actualiza los archivos del core de WordPress a la última versión |
wp core update-db |
Actualiza la base de datos a la estructura de la nueva versión |
wp plugin update --all |
Actualiza todos los plugins instalados |
wp theme update --all |
Actualiza todos los temas instalados |
wp core version |
Muestra la versión de WordPress actualmente instalada |
Guía paso a paso: actualizar el core de WordPress
Paso 1 — Acceder por SSH y navegar a la instalación
Accede mediante SSH a tu cuenta y dirígete a la ruta donde está instalado WordPress. Por ejemplo, si está en la raíz del dominio principal:
cd public_html/
Paso 2 — Verificar si hay actualizaciones disponibles (opcional)
Antes de actualizar puedes comprobar qué versión está disponible:
wp core check-update
Si hay una actualización disponible, mostrará la versión actual y la disponible. Si WordPress ya está actualizado, mostrará Success: WordPress is at the latest version.
Paso 3 — Actualizar los archivos de WordPress
Ejecuta el siguiente comando para actualizar los archivos del core:
wp core update
WP-CLI descargará la nueva versión, reemplazará los archivos del core y mostrará un mensaje de éxito al terminar.
Paso 4 — Actualizar la base de datos
Por último, actualiza la base de datos para que tome los cambios de la última versión:
wp core update-db
Este paso solo es necesario si la actualización lo requiere. Si no estás seguro, es mejor que lo ejecutes — si la base de datos ya está actualizada, el comando lo indicará sin hacer ningún cambio.
Actualizar plugins y temas con WP-CLI
Además del core, WP-CLI permite actualizar plugins y temas en el mismo proceso:
Actualizar todos los plugins
wp plugin update --all
Para actualizar un plugin concreto:
wp plugin update nombre-del-plugin
Actualizar todos los temas
wp theme update --all
Ver qué plugins tienen actualizaciones pendientes
wp plugin list --update=available
Actualizar todo de una vez (core + plugins + temas)
Para actualizar todo en una sola sesión SSH:
wp core update && wp core update-db && wp plugin update --all && wp theme update --all
ℹ️ Antes de ejecutar actualizaciones masivas en producción, se recomienda tener una copia de seguridad reciente. Puedes crear un backup de la base de datos con WP-CLI: wp db export.
Errores frecuentes al actualizar WordPress con WP-CLI
«Error: This WordPress version is not available in the API»
La versión específica que intentas instalar con --version=X.X.X no está disponible o el número de versión es incorrecto. Verifica el número de versión en wordpress.org/download/releases.
La actualización falla a mitad del proceso
Puede ser por falta de espacio en disco, un timeout de la conexión SSH o un problema de permisos. Verifica el espacio disponible con df -h y los permisos de la carpeta de WordPress. Si el proceso se interrumpe, ejecuta de nuevo wp core update — WP-CLI reanudará desde donde se interrumpió.
Tras actualizar, la web muestra un error o pantalla en blanco
Un plugin o tema puede ser incompatible con la nueva versión de WordPress. Activa el modo debug (wp config set WP_DEBUG true) para ver el error exacto. Si el problema viene de un plugin, desactívalo con wp plugin deactivate nombre-del-plugin. Consulta también la guía cómo habilitar el modo Debug en WordPress.
«Warning: The –all flag is not supported when updating specific items»
Estás combinando --all con un nombre de plugin o tema específico. Son excluyentes — usa uno o el otro: wp plugin update --all para todos o wp plugin update nombre-plugin para uno concreto.
Preguntas frecuentes
¿Cómo actualizar WordPress con WP-CLI?
Conecta por SSH, navega a la carpeta de WordPress (cd public_html/) y ejecuta: (1) wp core update para actualizar los archivos; (2) wp core update-db para actualizar la base de datos.
¿Es necesario ejecutar wp core update-db después de actualizar?
No siempre — solo cuando la actualización incluye cambios en la estructura de la base de datos. Sin embargo, es seguro ejecutarlo siempre: si la base de datos ya está actualizada, el comando lo indicará sin hacer ningún cambio. Es mejor ejecutarlo de forma preventiva.
¿Puedo actualizar solo a una versión específica de WordPress con WP-CLI?
Sí. Usa el parámetro --version: wp core update --version=6.4.3. Para forzar la actualización aunque WordPress ya esté en esa versión: wp core update --version=6.4.3 --force.
¿WP-CLI puede actualizar plugins y temas además del core?
Sí. Para actualizar todos los plugins: wp plugin update --all. Para todos los temas: wp theme update --all. Para ver qué plugins tienen actualizaciones pendientes: wp plugin list --update=available.
¿Puedo programar actualizaciones automáticas de WordPress con WP-CLI?
Sí. Puedes crear un script de shell con los comandos de actualización y programarlo como tarea cron en el servidor. Consulta la guía cómo desactivar WP-Cron y configurar tareas del servidor para más información sobre tareas programadas.
