WP-CLI en cPanel: Comandos esenciales para WordPress

¿Te imaginas poder gestionar tu WordPress desde la terminal, sin necesidad de entrar al panel de administración cada vez que quieras actualizar un plugin, cambiar una contraseña o limpiar la caché? Pues eso es exactamente lo que te permite WP-CLI, y lo mejor de todo es que puedes usarlo directamente desde cPanel. Si alguna vez has sentido curiosidad por la línea de comandos pero te ha dado un poco de respeto, este artículo es para ti. Vamos a desmitificar el proceso y te voy a enseñar, paso a paso y con un lenguaje muy sencillo, cómo sacarle todo el partido a wp-cli cpanel.

A lo largo de esta guía, no solo aprenderás a conectarte a tu servidor, sino que dominarás los comandos wp-cli más útiles para el día a día. Olvídate de los clics infinitos en el escritorio de WordPress; con un par de comandos bien escritos, podrás hacer tareas complejas en segundos. Así que, si estás listo para dar un salto en tu eficiencia como administrador web, sigue leyendo. Te prometo que al final de este artículo te sentirás mucho más seguro navegando por la terminal wordpress cpanel.

¿Qué es exactamente WP-CLI y por qué debería importarte?

Antes de meternos de lleno en la práctica, es fundamental que entendamos qué es esta herramienta. WP-CLI es la interfaz de línea de comandos oficial para WordPress. Piénsalo como un "control remoto" de texto que te permite comunicarte directamente con tu sitio web, sin pasar por el navegador. En lugar de hacer clic en "Actualizar" en el panel, escribes un comando y el servidor lo ejecuta al instante.

¿Por qué es tan potente? Principalmente por tres razones:

Velocidad: Las operaciones son mucho más rápidas porque no se carga toda la interfaz gráfica.
Automatización: Puedes crear scripts (pequeños programas) para realizar tareas repetitivas en varios sitios a la vez.
Acceso a funciones avanzadas: Hay comandos que te permiten hacer cosas que ni siquiera están disponibles en el panel de administración estándar.

En resumen, usar wp-cli cpanel es como pasar de conducir un coche con cambio automático a uno manual: al principio requiere un poco de práctica, pero una vez que le coges el truco, tienes un control total sobre el vehículo.

Primeros pasos: Accediendo a la terminal desde cPanel

El primer obstáculo que muchos encuentran es cómo llegar a la terminal. La buena noticia es que la mayoría de los paneles de control modernos, incluido cPanel, ofrecen una opción llamada "Terminal" o "SSH Access". Aquí tienes el proceso típico:

Inicia sesión en tu cPanel: Ve a tudominio.com/cpanel e introduce tus credenciales.
Busca la sección "Avanzado" o "Seguridad": Dependiendo de la versión de cPanel, puede estar en un lugar u otro. Normalmente verás un icono llamado "Terminal" o "Acceso SSH".
Activa el acceso SSH (si es necesario): Si es tu primera vez, es posible que tengas que generar una clave SSH o simplemente activar un interruptor. Si tu hosting es compartido, a veces esta opción está deshabilitada, pero la mayoría de los planes la incluyen.
Abre la Terminal: Una vez dentro, verás una ventana negra con un prompt que parpadea. ¡Felicidades, estás en la línea de comandos de tu servidor!

[TIP] Si no encuentras la opción de Terminal, contacta con tu proveedor de hosting. La mayoría de los planes de calidad la incluyen sin coste adicional. No te conformes con un hosting que no te da esta libertad.

Ahora que ya estás dentro, es hora de navegar hasta la carpeta de tu instalación de WordPress. Normalmente, se encuentra en public_html o en una subcarpeta. Puedes usar el comando ls (listar) para ver los archivos y cd (cambiar directorio) para moverte.

cd public_html
ls -la

Verás archivos como wp-admin, wp-content y wp-config.php. Si los ves, ¡estás en el lugar correcto! Es aquí donde ejecutaremos todos los comandos wp-cli.

Los comandos wp-cli imprescindibles que debes conocer

Ahora viene la parte emocionante. Voy a dividir los comandos en categorías para que sea más fácil de digerir. Te aseguro que con estos, podrás gestionar el 90% de las tareas comunes.

1. Gestión básica del sitio

Estos son los comandos que usarás más a menudo para comprobar el estado de tu web.

wp core version: Te muestra la versión de WordPress que tienes instalada. Es la forma más rápida de saber si estás desactualizado.
wp core check-update: Comprueba si hay una nueva versión de WordPress disponible.
wp core update: Actualiza WordPress a la última versión. ¡Así de simple! No más esperar a que el panel te lo recuerde.
wp core update-db: Después de una actualización, es crucial ejecutar este comando para actualizar la base de datos. A veces el panel no lo hace automáticamente y esto puede causar errores.

2. Gestión de plugins y temas

Esta es, probablemente, la mayor ventaja de usar wp-cli cpanel. Gestionar plugins desde la terminal es rapidísimo.

wp plugin list: Muestra una lista de todos tus plugins, su estado (activo/inactivo) y su versión. Es fantástico para auditar tu sitio.
wp plugin install [nombre-del-plugin]: Instala un plugin directamente desde el repositorio de WordPress. Por ejemplo, wp plugin install wordpress-seo instalaría Yoast SEO.
wp plugin activate [nombre-del-plugin] y wp plugin deactivate [nombre-del-plugin]: Activa o desactiva un plugin al instante. Esto es un salvavidas si has roto tu sitio con un plugin y no puedes acceder al panel.
wp plugin update --all: Actualiza todos tus plugins de una sola vez. Olvídate de hacer clic uno a uno.
wp plugin delete [nombre-del-plugin]: Elimina un plugin por completo, incluidos sus archivos.

Los comandos para temas son idénticos, solo cambia la palabra plugin por theme. Por ejemplo, wp theme list o wp theme update --all.

[WARNING] Antes de actualizar todo (--all), es una buena práctica hacer una copia de seguridad. Aunque es un proceso seguro, siempre es mejor prevenir. Puedes usar wp db export para exportar la base de datos rápidamente.

3. Gestión de usuarios

¿Necesitas crear un nuevo usuario administrador o cambiar la contraseña de uno existente? La terminal lo hace en un segundo.

wp user list: Lista todos los usuarios de tu sitio con sus roles.
wp user create [nombre-usuario] [email] --role=administrator: Crea un nuevo usuario. Por ejemplo: wp user create juan juan@email.com --role=administrator.
wp user update [nombre-usuario] --user_pass=[nueva-contraseña]: Cambia la contraseña de un usuario sin necesidad de enviarle un email de restablecimiento.
wp user delete [nombre-usuario]: Elimina un usuario.

4. Base de datos y optimización

La base de datos es el corazón de tu WordPress. Con WP-CLI puedes mantenerla limpia y optimizada.

wp db optimize: Optimiza todas las tablas de tu base de datos. Es como hacer una limpieza general.
wp db repair: Repara tablas dañadas. Útil si tienes errores de conexión.
wp db export [archivo.sql]: Crea una copia de seguridad de tu base de datos en un archivo .sql. Por ejemplo, wp db export backup-2024.sql.
wp db import [archivo.sql]: Importa una base de datos desde un archivo .sql. Ojo, esto sobrescribirá la base de datos actual.

5. Tareas avanzadas y de mantenimiento

Aquí es donde WP-CLI brilla con luz propia, permitiéndote hacer tareas que serían muy complicadas desde el panel.

wp cache flush: Limpia la caché de WordPress. No es lo mismo que la caché de un plugin como W3 Total Cache, pero es útil para opciones de transients.
wp option get [nombre-opcion] y wp option update [nombre-opcion] [nuevo-valor]: Te permite ver y cambiar cualquier valor en la tabla de opciones. Es muy potente para configurar cosas que no tienen interfaz gráfica.
wp search-replace '[texto-buscar]' '[texto-reemplazar]': Este es un comando mágico para migraciones. Te permite cambiar todas las URL antiguas por las nuevas en la base de datos. Por ejemplo, si cambias de dominio, puedes ejecutar wp search-replace 'http://old-site.com' 'http://new-site.com'. ¡CUIDADO! Este comando es peligroso si se usa mal, ya que modifica la base de datos de forma global. Asegúrate de hacer una copia de seguridad antes.
wp cron event list: Lista todos los eventos programados de WordPress. Te ayuda a depurar problemas con tareas automáticas.

Ejemplo práctico: Migrando un sitio con WP-CLI

Para que veas el poder real de la terminal wordpress cpanel, te voy a guiar en un escenario común: migrar un sitio de un dominio a otro.

Accede a la terminal y navega hasta la carpeta de tu WordPress.
Haz una copia de seguridad de la base de datos con wp db export backup.sql.
Descarga todos los archivos de tu sitio a tu ordenador mediante FTP (esto es un paso manual, pero necesario).
Sube los archivos al nuevo servidor mediante FTP.
Importa la base de datos en el nuevo servidor con wp db import backup.sql.
Edita el archivo wp-config.php en el nuevo servidor para que apunte a la nueva base de datos (nombre, usuario y contraseña).
Ahora viene el truco: Ejecuta wp search-replace 'http://dominio-viejo.com' 'http://dominio-nuevo.com'. Esto actualizará todas las URLs en la base de datos.
Limpia la caché con wp cache flush.

¡Listo! Has migrado tu sitio en unos minutos y sin tocar el panel de administración. Esto es solo un ejemplo, pero te da una idea de lo que se puede lograr.

Resolviendo dudas comunes (FAQ)

Aquí te dejo algunas preguntas que suelen hacerme los usuarios cuando empiezan con wp-cli cpanel.

¿Es seguro usar WP-CLI?

Sí, es tan seguro como usar el panel de administración, siempre y cuando tengas cuidado. La clave está en no ejecutar comandos que no entiendas y en hacer copias de seguridad periódicas. La línea de comandos te da mucho poder, y con gran poder viene una gran responsabilidad.

¿Qué pasa si mi hosting no tiene acceso SSH?

Si tu plan de hosting no incluye acceso SSH, no podrás usar WP-CLI directamente. Te recomendaría cambiar a un proveedor que sí lo ofrezca, ya que es una señal de un hosting de calidad. Muchos planes económicos lo incluyen hoy en día.

¿Puedo usar WP-CLI para gestionar varios sitios a la vez?

¡Sí! Puedes crear un script que recorra todas las carpetas de tus sitios y ejecute comandos en cada una. Es una forma fantástica de mantener una red de sitios actualizada. Por ejemplo, un simple bucle en bash podría actualizar todos tus plugins en todos tus sitios.

¿Qué hago si me olvido de un comando?

Puedes usar wp help para ver todos los comandos disponibles, o wp help [comando] para ver la ayuda de un comando específico. Por ejemplo, wp help plugin install te mostrará todas las opciones para instalar plugins.

¿WP-CLI funciona con Syspanel?

Si estás usando Syspanel (anteriormente conocido como HestiaCP), te alegrará saber que WP-CLI es compatible. Para acceder a la terminal en Syspanel, deberás conectarte por SSH al puerto 2106 de tu servidor. La ruta de acceso a tus sitios suele ser ~/web/dominio.com/public_html. El resto de los comandos funcionan exactamente igual.

[INFO] Si tu host usa Syspanel, recuerda que el puerto SSH por defecto es el 2106, no el 22. Deberás especificarlo al conectarte con tu cliente SSH favorito (como PuTTY o la terminal de tu sistema operativo) usando la sintaxis ssh -p 2106 usuario@tudominio.com.

Consejos finales para dominar la terminal

Para terminar, quiero darte algunos consejos que te ayudarán en tu viaje con WP-CLI:

Empieza por lo básico: No intentes aprender todos los comandos de golpe. Domina los de gestión de plugins y actualizaciones primero.
Practica en un sitio de pruebas: Si tienes un sitio de desarrollo, úsalo para experimentar sin miedo. Es la mejor forma de aprender.
Lee la documentación oficial: En wp-cli.org tienes una referencia completa de todos los comandos. Es tu mejor amigo.
Crea alias: Puedes crear alias en tu shell para comandos largos. Por ejemplo, alias wp-update='wp core update && wp plugin update --all && wp theme update --all'. Esto te ahorrará tiempo.

En definitiva, aprender a usar wp-cli cpanel es una inversión de tiempo que te devolverá el doble o el triple en eficiencia. Te convertirás en un administrador de WordPress mucho más ágil y capaz. No tengas miedo de la línea de comandos; es una herramienta más, y una vez que le cojas el truco, te preguntarás cómo pudiste vivir sin ella. Así que abre tu terminal, escribe tu primer comando y empieza a explorar todo lo que WP-CLI tiene para ofrecerte. ¡Nos vemos en la línea de comandos!