WP-CLI

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.