WP-CLI en cPanel: Guía de comandos básicos para administrar WordPress por SSH

¿Qué es WP-CLI y por qué deberías usarlo en cPanel?

Si administras un sitio web con WordPress, probablemente estés acostumbrado a hacer todo desde el escritorio de administración (wp-admin). Sin embargo, hay una forma mucho más rápida y poderosa de gestionar tu sitio: WP-CLI.

WP-CLI es la interfaz de línea de comandos oficial de WordPress. Te permite realizar casi cualquier tarea (instalar plugins, actualizar el núcleo, gestionar usuarios, limpiar caché, etc.) escribiendo comandos en la terminal SSH de tu servidor. Es como tener un "turbo" para tu gestión diaria.

Para usuarios de cPanel, el acceso a SSH es un privilegio que muchos hosting ofrecen en planes avanzados. Si tu proveedor te lo permite, dominar los comandos wp-cli te ahorrará horas de clics y te dará un control absoluto sobre tu instalación.

En esta guía, aprenderás a usar wp-cli cpanel desde cero, con los comandos básicos más útiles y prácticos. No necesitas ser un programador; solo seguir los pasos con calma.

Requisitos previos: Antes de empezar

Para seguir este tutorial, necesitas lo siguiente:

Acceso SSH a tu cuenta de cPanel: Esto se activa desde la sección "Acceso SSH" en tu panel de control. Si no lo ves, contacta a tu proveedor de hosting.
Un cliente SSH: En Windows puedes usar PuTTY o la terminal integrada de Windows 10/11. En Mac o Linux, puedes usar la terminal nativa.
WordPress instalado: El script de WP-CLI se conecta a tu instalación existente.
Conocimientos básicos de navegación: Saber usar comandos como cd, ls y pwd.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso SSH se configura desde el panel. Recuerda que el puerto de acceso para Syspanel es el 2106. No lo confundas con el puerto 22 estándar.

Paso 1: Conectarse al servidor por SSH

Abre tu cliente SSH e ingresa los datos de tu cuenta. Normalmente, el comando es:

ssh usuario@tudominio.com -p 22

Si usas Syspanel, el puerto cambia:

ssh usuario@tudominio.com -p 2106

Te pedirá tu contraseña. Una vez dentro, verás una pantalla negra (o blanca) con un prompt como [usuario@host ~]$. Eso significa que ya estás en el servidor.

Paso 2: Ubicar la carpeta de WordPress

El primer paso es navegar al directorio donde está instalado WordPress. En cPanel, suele estar en public_html o en una subcarpeta como public_html/blog o public_html/wp.

Usa el comando pwd (print working directory) para ver dónde estás y ls (list) para ver los archivos.

pwd
ls

Navega a la carpeta correcta:

cd public_html

Si tu WordPress está en una subcarpeta:

cd public_html/mi-sitio

[TIP] Si no estás seguro de qué carpeta es, busca un archivo llamado wp-config.php. Ese archivo solo existe en la raíz de WordPress.

Una vez dentro, verifica que estás en el lugar correcto:

ls -la | grep wp-config.php

Si ves el archivo, estás listo.

Paso 3: Verificar que WP-CLI esté instalado

La mayoría de los hosting modernos ya tienen WP-CLI preinstalado. Para comprobarlo, escribe:

wp --info

Si el comando no se encuentra (error "command not found"), puedes instalarlo manualmente. Pero primero, prueba esto:

which wp

Si no existe, descarga el binario oficial:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Luego, hazlo ejecutable y muévelo a una carpeta del sistema:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

[WARNING] Si no tienes permisos de sudo, contacta a tu proveedor. Algunos hosting no permiten instalar programas globales. En ese caso, puedes ejecutar WP-CLI con php wp-cli.phar en lugar de wp. Por ejemplo: php wp-cli.phar --info.

Paso 4: Comandos básicos de WP-CLI para cPanel

Ahora sí, vamos a lo interesante. Estos son los comandos wp-cli que usarás el 90% del tiempo.

4.1. Ver el estado de WordPress

wp core version

Te mostrará la versión de WordPress instalada. Si quieres más detalles:

wp core status

4.2. Actualizar WordPress

Este es uno de los mayores beneficios. Actualiza el núcleo, plugins y temas en segundos:

wp core update
wp plugin update --all
wp theme update --all

[INFO] Si quieres actualizar solo un plugin específico: wp plugin update nombre-del-plugin. Para temas: wp theme update nombre-del-tema.

4.3. Gestionar plugins

Ver todos los plugins instalados (activos e inactivos):

wp plugin list

Ver solo los activos:

wp plugin list --status=active

Activar un plugin:

wp plugin activate nombre-del-plugin

Desactivar un plugin (útil si tienes un error de pantalla blanca):

wp plugin deactivate nombre-del-plugin

4.4. Gestionar temas

Listar temas:

wp theme list

Activar un tema:

wp theme activate nombre-del-tema

4.5. Gestionar usuarios

Crear un nuevo usuario administrador:

wp user create nuevo-usuario correo@ejemplo.com --role=administrator --user_pass=tucontraseña

Cambiar la contraseña de un usuario existente:

wp user update nombre-usuario --user_pass=nueva-contraseña

Listar todos los usuarios:

wp user list

4.6. Buscar y reemplazar texto en la base de datos

Este comando es oro puro. Te permite cambiar URLs (por ejemplo, de http:// a https:// o de un dominio a otro).

wp search-replace 'http://dominio-viejo.com' 'https://dominio-nuevo.com' --all-tables

[WARNING] Este comando modifica la base de datos. Haz una copia de seguridad antes de ejecutarlo. También es recomendable usar --dry-run primero para ver qué se va a cambiar sin aplicarlo:

wp search-replace 'http://dominio-viejo.com' 'https://dominio-nuevo.com' --all-tables --dry-run

4.7. Vaciar la caché

Si usas un plugin de caché como WP Rocket o W3 Total Cache, puedes limpiarla desde aquí:

wp cache flush

Si usas un plugin específico, revisa su documentación. Por ejemplo, para WP Rocket:

wp rocket clean --confirm

4.8. Exportar e importar la base de datos

Exportar la base de datos a un archivo SQL:

wp db export backup.sql

Importar una base de datos:

wp db import backup.sql

[TIP] Añade la fecha al nombre del archivo para llevar un control: wp db export backup-20240115.sql.

4.9. Optimizar la base de datos

wp db optimize

Este comando analiza y optimiza todas las tablas, lo que puede mejorar el rendimiento.

4.10. Ver la información de la instalación

wp db size

Te muestra el tamaño de la base de datos. Útil para monitorear el crecimiento.

Paso 5: Comandos de utilidad diaria

Aquí tienes otros comandos que te harán la vida más fácil:

5.1. Cambiar la URL del sitio

Si necesitas cambiar la URL de WordPress (por ejemplo, al mover el sitio):

wp option update home 'https://nueva-url.com'
wp option update siteurl 'https://nueva-url.com'

5.2. Programar tareas (cron)

WordPress tiene su propio sistema de cron. Puedes ver las tareas programadas:

wp cron event list

Ejecutar todas las tareas pendientes:

wp cron event run --due-now

5.3. Gestionar menús

Listar los menús:

wp menu list

Crear un menú:

wp menu create "Mi Menú Principal"

5.4. Gestionar entradas y páginas

Listar las últimas 10 entradas:

wp post list --post_type=post --numberposts=10

Crear una nueva entrada:

wp post create --post_title="Título del post" --post_content="Contenido aquí" --post_status=publish

Paso 6: Consejos de seguridad y buenas prácticas

Usar WP-CLI desde SSH es muy poderoso, pero también requiere responsabilidad.

Siempre haz una copia de seguridad antes de ejecutar comandos que modifiquen la base de datos o los archivos. Puedes usar wp db export para la base de datos y un backup del sistema de archivos desde cPanel.
Nunca ejecutes comandos desconocidos sin entender qué hacen. Si tienes dudas, busca en la documentación oficial de WP-CLI.
Usa contraseñas seguras para los usuarios que crees. No uses la misma contraseña para todo.
Mantén WP-CLI actualizado. Si lo instalaste manualmente, puedes actualizarlo con wp cli update.

[WARNING] No uses wp core update en un sitio en producción sin antes probarlo en un entorno de staging. Aunque es seguro en general, siempre hay un pequeño riesgo de incompatibilidad con temas o plugins.

Solución de problemas comunes (FAQ)

¿Qué hago si el comando `wp` no funciona?

Primero, verifica que estás en la carpeta correcta de WordPress. Luego, prueba con php wp-cli.phar si lo descargaste manualmente. Si sigue sin funcionar, revisa los permisos de la carpeta y del archivo.

¿Puedo usar WP-CLI en Syspanel?

Sí, Syspanel (el antiguo HestiaCP) soporta WP-CLI sin problemas. Solo asegúrate de conectarte por el puerto 2106 y de tener los permisos adecuados.

¿Es seguro ejecutar WP-CLI en producción?

Sí, si sabes lo que haces. Los comandos básicos como wp plugin list o wp core version son de solo lectura y no presentan riesgo. Los comandos de escritura (como wp db optimize o wp search-replace) deben usarse con precaución y siempre con copia de seguridad.

¿Puedo automatizar tareas con WP-CLI?

¡Por supuesto! Puedes crear scripts en Bash que combinen varios comandos. Por ejemplo, un script que actualice todo y haga un backup:

#!/bin/bash
wp db export backup-$(date +%Y%m%d).sql
wp core update
wp plugin update --all
wp theme update --all
wp cache flush

Guárdalo como actualizar.sh y ejecútalo con bash actualizar.sh.

¿Dónde encuentro la lista completa de comandos?

La documentación oficial es tu mejor amiga: wp help te mostrará todos los comandos disponibles. También puedes consultar wp help <comando> para ver la ayuda de un comando específico.

Conclusión

WP-CLI es una herramienta imprescindible para cualquier persona que administre WordPress en un hosting con cPanel. Aunque al principio la línea de comandos puede parecer intimidante, verás que en pocos días te sentirás cómodo y notarás una enorme mejora en tu flujo de trabajo.

Empieza con los comandos de solo lectura, luego prueba los de gestión de plugins y temas, y poco a poco te atreverás con los más avanzados. La clave es la práctica y la precaución.

[TIP] Crea una "chuleta" con tus comandos favoritos y tenla a mano. Con el tiempo, los memorizarás y podrás hacer tareas complejas en segundos.

Ahora ya sabes cómo usar wp-cli cpanel y los comandos wp-cli más básicos. Si tienes un sitio con ssh wordpress cpanel, esta guía te servirá como punto de partida sólido. ¡Atrévete a explorar y verás lo poderoso que es!