WP-CLI en cPanel: Guía para principiantes (comandos útiles)

¿Alguna vez has deseado tener un botón mágico que realice tareas aburridas en tu WordPress sin tener que hacer clic en mil menús? Ese botón existe y se llama WP-CLI. Es una herramienta de línea de comandos que te permite gestionar tu sitio web de forma rápida y eficiente directamente desde el terminal de tu servidor.

Si usas cPanel, puede que pienses que esto es solo para desarrolladores expertos, pero nada más lejos de la realidad. Esta guía para principiantes te enseñará paso a paso qué es WP-CLI, cómo usarlo en cPanel y te dará los comandos más útiles para que empieces a dominar tu WordPress como un profesional.

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

WP-CLI es la interfaz de línea de comandos oficial para WordPress. En lugar de usar el navegador para actualizar plugins, borrar caché o gestionar usuarios, escribes un comando en una ventana de terminal y la tarea se ejecuta al instante.

¿Por qué es tan útil?

Velocidad: Las tareas se ejecutan en milisegundos, mucho más rápido que cargar la interfaz gráfica del administrador.
Automatización: Puedes programar tareas de mantenimiento con cron jobs.
Seguridad: Algunas operaciones, como cambiar contraseñas, se pueden hacer sin exponer datos en el navegador.
Mantenimiento: Ideal para actualizar todo el sitio (núcleo, plugins y temas) con un solo comando.
Solución de errores: Si tu web da error 500, WP-CLI te permite desactivar plugins o cambiar de tema sin acceder al panel.

Piensa en ello como la diferencia entre buscar una página en un libro enorme (interfaz gráfica) y usar el índice para ir directamente a la página correcta (WP-CLI). Es más rápido, directo y eficiente.

Requisitos previos para usar WP-CLI en cPanel

Antes de empezar, asegúrate de tener lo siguiente:

Acceso a cPanel: Necesitas las credenciales de tu cuenta de hosting.
Acceso a Terminal: En la mayoría de los paneles de control modernos (como cPanel o Syspanel), existe una opción llamada "Terminal". En cPanel, normalmente la encuentras en la sección Avanzado.
WordPress instalado: Necesitas tener un sitio WordPress funcionando en tu cuenta.
Conocimientos básicos de navegación: Saber qué es una ruta de archivos y cómo cambiar de directorio (carpeta) es suficiente.

[INFO] Si tu hosting no tiene la opción "Terminal" en cPanel, puedes usar SSH (Secure Shell). Necesitarás un programa como PuTTY (en Windows) o la propia terminal de Mac/Linux. Pregunta a tu proveedor de hosting si tienes acceso SSH habilitado.

Paso 1: Acceder al Terminal de cPanel

El primer paso es abrir la ventana de comandos.

Inicia sesión en tu cPanel.
Busca la sección Avanzado y haz clic en el icono Terminal.
Se abrirá una nueva ventana que parece una pantalla negra (o blanca, según la configuración). Esta es tu línea de comandos.

Verás algo como [usuario@hosting ~]$. Esto indica que estás en tu directorio principal (home). Ahora, necesitas navegar hasta la carpeta donde está instalado tu WordPress.

Paso 2: Navegar a tu directorio de WordPress

Para que WP-CLI funcione, debes ejecutar los comandos dentro de la carpeta raíz de tu WordPress (donde están los archivos wp-config.php y wp-content).

Usa el comando cd (change directory) para moverte. Normalmente, la estructura es public_html o htdocs.

Escribe esto y presiona Enter:

cd public_html

Si tu WordPress está en una subcarpeta (por ejemplo, public_html/blog), entonces escribe:

cd public_html/blog

¿Cómo saber si estás en el lugar correcto?

Escribe el comando ls (list) y presiona Enter. Deberías ver una lista de archivos. Si entre ellos está wp-admin, wp-content, wp-includes y wp-config.php, ¡estás en el lugar correcto!

Paso 3: Verificar que WP-CLI está instalado

No todos los servidores tienen WP-CLI instalado por defecto. Para comprobarlo, escribe este comando y presiona Enter:

wp --info

Si ves un mensaje con la versión de WP-CLI y la ruta del archivo PHP, ¡genial! Ya puedes usarlo.

Si recibes un error como "wp: command not found", necesitas instalarlo. No te preocupes, es sencillo. Puedes usar el instalador oficial:

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

Luego, hazlo ejecutable (esto puede variar, pero es lo común):

chmod +x wp-cli.phar

Y muévelo a una carpeta del sistema para que esté disponible globalmente:

sudo mv wp-cli.phar /usr/local/bin/wp

[TIP] Si no tienes permisos de sudo, puedes usar php wp-cli.phar en lugar de wp para cada comando. Por ejemplo: php wp-cli.phar --info.

Los comandos WP-CLI más útiles para principiantes

Ahora que ya tienes WP-CLI funcionando, vamos a lo interesante. Aquí tienes una lista de comandos esenciales que te harán la vida mucho más fácil.

1. Actualizar WordPress, Plugins y Temas

Esta es una de las mayores ventajas. Olvídate de ir uno por uno en el panel.

Actualizar el núcleo de WordPress:

wp core update

Actualizar todos los plugins:

wp plugin update --all

Actualizar todos los temas:

wp theme update --all

Actualizar todo (núcleo, plugins y temas) con un solo comando:

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

[TIP] Antes de actualizar, es una excelente práctica hacer una copia de seguridad. Puedes usar un plugin de backup o el comando wp db export para guardar la base de datos.

2. Gestionar Plugins y Temas

¿Necesitas desactivar un plugin porque te ha bloqueado el sitio? Hazlo por comando.

Desactivar un plugin específico (ejemplo: un plugin de caché):

wp plugin deactivate wp-super-cache

Activar un plugin:

wp plugin activate woocommerce

Ver la lista de plugins activos:

wp plugin list

Cambiar el tema por defecto (útil para solucionar errores de diseño):

wp theme activate twentytwentyfour

Eliminar un plugin (esto borra los archivos):

wp plugin delete hello-dolly

3. Gestión de Usuarios

Crear un nuevo usuario administrador o cambiar la contraseña de uno existente es muy fácil.

Crear un nuevo usuario administrador:

wp user create nuevoautor email@tudominio.com --role=administrator --user_pass=UnaContraseñaSegura

Cambiar la contraseña de un usuario existente:

wp user update nombreusuario --user_pass=NuevaContraseña

Ver la lista de usuarios:

wp user list

Eliminar un usuario:

wp user delete nombreusuario --reassign=otrousuario

[WARNING] Cambiar la contraseña de un usuario por línea de comandos no enviará el correo de notificación. Asegúrate de informar al usuario de la nueva contraseña de forma segura.

4. Mantenimiento de la Base de Datos

Con el tiempo, tu base de datos se llena de basura (revisiones antiguas, spam, etc.). WP-CLI te permite limpiarla.

Optimizar la base de datos (desfragmentar tablas):

wp db optimize

Reparar la base de datos (si hay errores):

wp db repair

Hacer una copia de seguridad de la base de datos:

wp db export backup.sql

Importar una base de datos desde un archivo:

wp db import backup.sql

5. Tareas de Mantenimiento General

Estos comandos son muy útiles para el día a día.

Borrar la caché de WordPress (si usas un plugin como WP Rocket o W3 Total Cache):

wp cache flush

Programar un cron job (para tareas automáticas):

wp cron event run --due-now

Ver los cron jobs programados:

wp cron event list

Comprobar el estado de salud del sitio:

wp core check-update

Ejemplo práctico: Solucionar un error de "Error al establecer conexión con la base de datos"

Imagina que tu web muestra el temido error de conexión a la base de datos. Con WP-CLI puedes verificar rápidamente si el problema es de configuración.

Navega a tu directorio de WordPress.
Ejecuta el siguiente comando para ver si WP-CLI puede conectarse:

wp db check

Si ves un error, significa que hay un problema con las credenciales en wp-config.php. Puedes revisar el archivo y corregirlo.

Si la conexión es correcta, el problema puede ser del servidor de base de datos. Puedes intentar reparar la base de datos con el comando que vimos antes:

wp db repair

Este flujo de trabajo es mucho más rápido que intentar acceder a phpMyAdmin o esperar a que el soporte técnico responda.

WP-CLI y Syspanel: Una alternativa moderna

Aunque esta guía se centra en cPanel, es importante mencionar que otros paneles de control ofrecen funcionalidades similares. Por ejemplo, Syspanel (anteriormente conocido como HestiaCP) también incluye un terminal integrado.

[INFO] Si tu hosting utiliza Syspanel (el panel de control que antes se llamaba HestiaCP), la forma de acceder al terminal es ligeramente diferente. Deberás iniciar sesión en tu cuenta a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Una vez dentro, busca la opción "Terminal" o "Command Line". El uso de WP-CLI será idéntico al que hemos explicado, ya que la herramienta es la misma.

Preguntas Frecuentes (FAQ) sobre WP-CLI

¿Es peligroso usar WP-CLI?

No es peligroso en sí mismo, pero es una herramienta muy potente. Es como tener una llave maestra. Si la usas mal, puedes romper algo. La clave está en usarla con cuidado, siempre verificando los comandos antes de ejecutarlos, especialmente los que borran o modifican datos.

¿Necesito saber programación para usar WP-CLI?

No. Solo necesitas saber copiar y pegar comandos y entender qué hace cada uno. Es como aprender a usar una nueva aplicación con una interfaz de texto.

¿Qué pasa si mi hosting no tiene WP-CLI instalado?

Puedes intentar instalarlo tú mismo si tienes acceso SSH y permisos. Si no, puedes pedir a tu proveedor de hosting que lo active. La mayoría de los hosts modernos lo tienen disponible.

¿Puedo usar WP-CLI para hacer una copia de seguridad completa (archivos + base de datos)?

WP-CLI solo puede hacer la copia de la base de datos. Para los archivos, necesitarás usar zip o tar en la terminal o usar un plugin de backup que haga todo el trabajo.

¿WP-CLI funciona con cualquier plugin o tema?

Sí, funciona con la mayoría, ya que interactúa con la base de datos y los archivos del sistema de WordPress. Sin embargo, algunos plugins con configuraciones muy complejas pueden tener opciones que no se gestionan por CLI.

Consejos finales para tu viaje con WP-CLI

Empieza con comandos de solo lectura: Ejecuta wp plugin list, wp user list, wp db check. Esto te dará confianza sin miedo a romper nada.
Haz copias de seguridad frecuentes: Antes de ejecutar cualquier comando que modifique datos (actualizaciones, borrados), asegúrate de tener una copia de seguridad reciente.
Consulta la ayuda: Puedes escribir 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 core update.
Practica en un sitio de pruebas: Si tienes un entorno de desarrollo o una instalación de prueba, úsalo para experimentar sin miedo.

WP-CLI es una habilidad que, una vez aprendida, cambiará por completo la forma en que gestionas tus sitios WordPress. Te ahorrará horas de trabajo y te dará un control total sobre tu web. No tengas miedo de probar y explorar. Con esta guía para principiantes, ya tienes las bases para convertirte en un experto en la gestión de WordPress desde la terminal de cPanel. ¡Empieza a escribir comandos y descubre el poder que tienes a tu alcance!