WP-CLI en cPanel: gestionar WordPress desde la línea de comandos

El panel de administración de WordPress funciona bien para la mayoría de las tareas, pero hay situaciones donde es más lento o directamente imposible usarlo: actualizar 40 plugins a la vez, resetear la contraseña de administrador cuando no puedes acceder al correo, limpiar transients acumulados o migrar una base de datos. Para eso existe WP-CLI.

WP-CLI (WordPress Command Line Interface) te permite gestionar cualquier instalación de WordPress desde la terminal. Si tu hosting incluye acceso SSH (como en los planes de Elevocloud), puedes usar WP-CLI para hacer en segundos lo que en el panel tardaría minutos o simplemente no se podría.

Cómo verificar si WP-CLI está disponible en tu hosting

Conectate vía SSH a tu servidor y ejecutá:

wp --version

Si ves algo como WP-CLI 2.x.x, está instalado y listo. Si el comando no existe, puedes instalarlo manualmente:

cd ~
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
mv wp-cli.phar ~/bin/wp

En cPanel con CloudLinux, WP-CLI generalmente está disponible por defecto en los planes con SSH habilitado.

Comandos esenciales de WP-CLI para el día a día

Información básica del sitio

# Versión de WordPress instalada
wp core version

# Estado general de WordPress (versión, URL, descripción)
wp core is-installed && echo "WordPress instalado"

# Información del sitio
wp option get siteurl
wp option get blogname

Actualizar WordPress, plugins y temas

# Actualizar WordPress core
wp core update

# Ver todos los plugins y su estado de actualización
wp plugin list

# Actualizar todos los plugins a la vez
wp plugin update --all

# Actualizar un plugin específico
wp plugin update woocommerce

# Ver todos los temas disponibles
wp theme list

# Actualizar todos los temas
wp theme update --all

Esta es una de las operaciones más útiles de WP-CLI: actualizar todos los plugins de una instalación con un solo comando, algo que en el panel de administración requiere seleccionar y ejecutar de a uno o en lotes.

Gestión de usuarios

# Listar usuarios
wp user list

# Resetear contraseña de administrador (útil cuando no puedes acceder)
wp user update admin --user_pass=NuevaContraseñaSegura123!

# Crear un usuario administrador nuevo
wp user create nuevo_admin correo@ejemplo.com --role=administrator --user_pass=contraseña

# Ver los roles disponibles
wp role list

Base de datos

# Exportar la base de datos completa a un archivo SQL
wp db export backup-$(date +%Y-%m-%d).sql

# Importar un archivo SQL (para restaurar o migrar)
wp db import backup-2026-07-08.sql

# Optimizar las tablas de la base de datos
wp db optimize

# Buscar y reemplazar URL (útil en migraciones)
wp search-replace 'https://sitio-viejo.cl' 'https://sitio-nuevo.cl'

# Buscar y reemplazar con preview (sin aplicar cambios)
wp search-replace 'texto-viejo' 'texto-nuevo' --dry-run

El comando search-replace es especialmente valioso en migraciones de dominio o cuando cambiás de HTTP a HTTPS y las URLs están hardcodeadas en la base de datos.

Caché y rendimiento

# Limpiar todos los transients de WordPress
wp transient delete --all

# Limpiar la caché de objetos (si hay Redis u otro backend)
wp cache flush

# Ver transients almacenados
wp transient list

Los transients acumulados pueden causar problemas de rendimiento en la base de datos de WordPress. Limpiarlos periódicamente con wp transient delete --all es parte del mantenimiento preventivo.

Plugins: activar, desactivar, instalar

# Desactivar un plugin específico (útil para diagnosticar conflictos)
wp plugin deactivate nombre-del-plugin

# Desactivar TODOS los plugins (cuando el sitio está caído y necesitas diagnosticar)
wp plugin deactivate --all

# Reactivar todos los plugins
wp plugin activate --all

# Instalar un plugin desde el repositorio oficial
wp plugin install woocommerce --activate

# Eliminar un plugin
wp plugin delete nombre-del-plugin

wp plugin deactivate --all es un comando de emergencia extremadamente útil: cuando un plugin crashea el sitio y no puedes entrar al panel de administración, desde SSH puedes desactivar todos los plugins y acceder para identificar el problema.

Medios y archivos

# Regenerar todos los thumbnails (sin confirmación)
wp media regenerate --yes

# Regenerar thumbnails de una imagen específica (por ID)
wp media regenerate 123

Mantenimiento

Nota: wp maintenance-mode requiere un plugin que registre esos comandos (por ejemplo, Easy Maintenance Mode). Sin ese plugin, los comandos devuelven un error.

# Activar modo mantenimiento
wp maintenance-mode activate

# Desactivar modo mantenimiento
wp maintenance-mode deactivate

# Chequear si el modo mantenimiento está activo
wp maintenance-mode status

Trabajar con múltiples sitios WordPress

Si tienes varias instalaciones de WordPress en el mismo hosting, puedes ejecutar WP-CLI en cada una navegando a la carpeta correcta:

# Para un sitio en public_html
cd ~/public_html && wp plugin update --all

# Para un sitio en un subdirectorio
cd ~/public_html/tienda && wp db optimize

# Especificando el path directamente
wp --path=/home/usuario/public_html/blog plugin list

Automatización con WP-CLI y cron

Puedes combinar WP-CLI con cron jobs de cPanel para automatizar tareas de mantenimiento:

# Limpiar transients todos los lunes a las 3:00 AM
0 3 * * 1 wp --path=/home/usuario/public_html transient delete --all

# Exportar backup de la base de datos diariamente
0 2 * * * wp --path=/home/usuario/public_html db export /home/usuario/backups/db-$(date +\%Y-\%m-\%d).sql

Para configurar estos crons en cPanel, andá a Cron Jobs y agregá los comandos con la ruta completa a WP-CLI si es necesario.

WP-CLI y plugins de seguridad

Algunos plugins de seguridad (como Wordfence o iThemes Security) pueden bloquear comandos de WP-CLI si detectan patrones inusuales. Si un comando falla con un error de acceso, desactivá temporalmente el plugin de seguridad, ejecutá el comando y reactivalo.

wp plugin deactivate wordfence
wp user update admin --user_pass=NuevaClave
wp plugin activate wordfence

Conclusión

WP-CLI convierte operaciones que en el panel de administración toman minutos en comandos de una línea. Para desarrolladores, administradores de sitios con múltiples instalaciones o situaciones de emergencia donde el panel no carga, es una herramienta indispensable.

Si tu plan de hosting incluye SSH (disponible en los planes de Elevocloud), WP-CLI ya está probablemente disponible. El comando wp --version es el primer paso para verificarlo.

El acceso SSH con WP-CLI está incluido en los planes de Elevocloud. Si necesitas ayuda para conectarte vía SSH o ejecutar algún comando específico, el soporte puede orientarte.