WP-CLI: Cómo Gestionar WordPress por Consola

Que es WP-CLI

WP-CLI es la interfaz de linea de comandos para WordPress. Permite realizar tareas administrativas desde una terminal sin abrir el navegador: consultar y actualizar WordPress, instalar o desactivar plugins y temas, crear usuarios, exportar e importar bases de datos, ejecutar busquedas y sustituciones seguras, y gestionar cache, cron y opciones.

Es especialmente util para administrar varias webs o recuperar una instalacion cuyo panel no responde.

Requisitos

Necesitas acceso SSH, permiso para ejecutar PHP desde consola, WP-CLI instalado por el proveedor o en tu cuenta, y acceso a la carpeta de WordPress. La version de PHP de la consola puede ser distinta de la que utiliza la web; compruebala siempre con wp --info.

Comprobar si WP-CLI esta instalado

Conecta por SSH y ejecuta:

wp --info
wp cli version

Si el comando no existe, consulta si tu hosting ofrece WP-CLI o si puedes instalarlo en tu espacio de usuario descargando el archivo PHAR oficial (wp-cli.phar) y ejecutandolo con php wp-cli.phar. En hosting compartido puede no existir sudo, asi que no intentes modificar rutas globales sin permiso.

Ejecutar WP-CLI en la carpeta correcta

Entra en la carpeta que contiene wp-config.php:

cd /ruta/de/wordpress
wp core is-installed
wp option get home

Si ejecutas el comando desde otra carpeta, utiliza wp --path=/ruta/de/wordpress core version.

Comandos basicos de diagnostico

wp core version
wp option get home
wp option get siteurl
wp plugin list
wp theme list
wp user list
wp cron event list
wp core verify-checksums

verify-checksums compara los archivos del nucleo con las sumas oficiales, pero no revisa plugins, temas ni archivos subidos.

Actualizar WordPress

Antes de actualizar, crea una copia de archivos y base de datos (ver backup y restauracion de WordPress) y comprueba la compatibilidad.

wp core check-update
wp core update
wp core update-db
wp core version
wp core verify-checksums

Gestionar plugins y temas

wp plugin install nombre-plugin --activate
wp plugin activate nombre-plugin
wp plugin deactivate nombre-plugin
wp plugin deactivate --all
wp plugin update --all --dry-run
wp plugin update --all
wp plugin delete nombre-plugin

Eliminar archivos no siempre ejecuta la rutina de desinstalacion del plugin. Para temas: wp theme list, wp theme install nombre-tema, wp theme activate nombre-tema y wp theme update --all. Mantén al menos un tema predeterminado disponible para diagnostico.

Gestionar usuarios

wp user create nuevoadmin correo@tudominio.com \
  --role=administrator \
  --user_pass='ContrasenaLargaYUnica'

wp user update nombreusuario --user_pass='NuevaContrasenaLarga'
wp user set-role nombreusuario editor
wp user delete nombreusuario --reassign=ID_OTRO_USUARIO

Evita escribir contrasenas sensibles en comandos si el historial de la terminal puede quedar accesible.

Exportar e importar la base de datos

wp db export copia-wordpress.sql
wp db import copia-wordpress.sql
wp db check
wp db optimize

Guarda las copias fuera de la carpeta publica y limita sus permisos: un archivo SQL puede contener usuarios, correos y hashes.

Cambiar una URL con busqueda y sustitucion

WP-CLI trata correctamente los datos serializados de WordPress (ver tambien como cambiar la URL de WordPress). Primero simula el cambio:

wp search-replace \
  'https://dominio-antiguo.com' \
  'https://dominio-nuevo.com' \
  --all-tables-with-prefix \
  --dry-run

Si el informe es correcto, repite sin --dry-run. Crea una copia antes de ejecutar y no anadas --all-tables sin comprender que podria modificar tablas ajenas a WordPress.

Gestionar opciones, cache y WP-Cron

wp option get blogname
wp option update blogname 'Nuevo titulo'
wp cache flush
wp rewrite flush
wp cron event list
wp cron event run --due-now

No cambies opciones desconocidas: muchas contienen arrays serializados o configuracion critica. Vaciar la cache de WP-CLI no siempre limpia la cache de pagina del servidor, plugin o CDN.

Trabajar con una web que falla

Si un plugin o tema provoca un error al cargar WordPress:

wp plugin list --skip-plugins --skip-themes
wp plugin deactivate nombre-plugin --skip-plugins --skip-themes

Consulta como desactivar plugins de WordPress sin acceso al admin para mas metodos. Ten en cuenta que los MU-plugins pueden seguir cargandose aunque uses --skip-plugins.

Ejecutar como el usuario correcto

En un servidor propio, no ejecutes WP-CLI como root sobre una web cuyos archivos pertenecen a otro usuario, salvo que comprendas las consecuencias: puedes crear archivos con propietario incorrecto y provocar fallos de actualizacion o seguridad.

Automatizar tareas

#!/bin/bash
set -euo pipefail

cd /ruta/de/wordpress

wp db export "/ruta/segura/copia-$(date +%F-%H%M).sql"
wp core check-update
wp plugin update --all
wp theme update --all
wp core update
wp core update-db

Antes de automatizar, prueba cada comando por separado, guarda registros, gestiona errores y notificaciones, y evita actualizaciones automaticas sin pruebas en webs criticas.

Parametros globales utiles

wp --path=/ruta/wordpress plugin list
wp --url=https://sitio.red.com option get home
wp --skip-plugins --skip-themes core version

Problemas frecuentes

”This does not seem to be a WordPress installation”

No estas en la carpeta correcta o falta wp-config.php. Utiliza --path.

PHP de consola incompatible

Comprueba php -v y wp --info, y selecciona el binario PHP adecuado si el servidor dispone de varias versiones.

Error de permisos

Ejecuta con el usuario propietario de la web y revisa propiedad y permisos. No soluciones el problema con 777.

WP-CLI carga un plugin con error

Anade --skip-plugins --skip-themes y desactiva el componente responsable.

Preguntas frecuentes

WP-CLI esta disponible en todos los hostings?

No. Depende del servicio y del acceso SSH. Consulta las funciones de tu plan.

Es mas seguro que entrar en WordPress?

No automaticamente. SSH debe estar protegido y los comandos tienen mucho alcance. Utiliza claves, usuarios limitados y copias.

WP-CLI funciona con Multisite?

Si. Muchos comandos admiten --network o --url; revisa la documentacion de cada comando (ver activar y configurar WordPress Multisite).

Conclusion

WP-CLI permite administrar WordPress de forma rapida y reproducible para tareas de mantenimiento o recuperacion. Empieza con comandos de consulta, utiliza --dry-run cuando exista, crea copias antes de modificar la base de datos y ejecuta siempre como el usuario correcto.