WP-CLI en cPanel: Guía para administrar WordPress

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

Si alguna vez has administrado un sitio WordPress, sabes que tareas como actualizar plugins, cambiar la URL del sitio o limpiar la caché pueden llevar varios clics en el panel de administración. Ahora imagina poder hacer todo eso y mucho más con un solo comando de texto, directamente desde la terminal. Eso es exactamente lo que ofrece WP-CLI (WordPress Command Line Interface).

WP-CLI es una herramienta de línea de comandos que te permite gestionar tu sitio WordPress sin necesidad de entrar al navegador. Es como tener un asistente personal que ejecuta tareas complejas de forma rápida y segura. Y lo mejor de todo: puedes usarlo perfectamente en cPanel, el panel de control más común en el hosting compartido.

En esta guía completa, aprenderás paso a paso cómo usar WP-CLI en cPanel para administrar WordPress como un profesional. No necesitas ser un experto en programación; solo seguir las instrucciones y entender la lógica básica de los comandos.

Beneficios de usar WP-CLI en cPanel

Velocidad: Ejecutas tareas en segundos en lugar de minutos.
Automatización: Puedes crear scripts para tareas repetitivas.
Seguridad: Algunas operaciones son más seguras desde la terminal.
Acceso remoto: Puedes gestionar tu sitio desde cualquier lugar con SSH.
Menos recursos: No carga la interfaz gráfica, por lo que es más ligero.

Requisitos para usar WP-CLI en cPanel

Antes de lanzarnos a los comandos, asegúrate de cumplir con estos requisitos básicos:

Acceso a cPanel: Necesitas las credenciales de tu cuenta de hosting.
Acceso SSH: La mayoría de los planes de hosting con cPanel incluyen acceso SSH (Shell). Si no lo tienes, contacta a tu proveedor para activarlo.
WordPress instalado: Obviamente, necesitas un sitio WordPress en tu cuenta.
Conocimientos básicos de terminal: No necesitas ser un gurú, pero sí saber navegar entre carpetas y ejecutar comandos simples.

[INFO] Si tu hosting no tiene SSH activado, algunos comandos de WP-CLI también se pueden ejecutar desde el "Terminal" que ofrecen ciertos paneles de control, pero la experiencia completa es vía SSH.

Cómo conectarte a tu servidor por SSH desde cPanel

Inicia sesión en tu cPanel.
Busca la sección "Avanzado" o "Seguridad" y haz clic en "Acceso SSH".
Si no está activado, actívalo. Verás las instrucciones para conectarte.
Abre una terminal en tu computadora (si usas Windows, puedes usar PowerShell o Git Bash; en Mac o Linux, la terminal nativa).
Usa el siguiente comando para conectarte (reemplaza usuario con tu nombre de usuario de cPanel y tudominio.com con tu dominio):

ssh usuario@tudominio.com

Ingresa tu contraseña cuando te la pida. ¡Ya estás dentro!

Primeros pasos: Instalación y verificación de WP-CLI

En muchos hosts con cPanel, WP-CLI ya viene preinstalado. Pero si no es tu caso, aquí te muestro cómo verificarlo e instalarlo.

Verificar si WP-CLI ya está disponible

Una vez conectado por SSH, escribe:

wp --info

Si ves información sobre la versión y el entorno, ¡genial! Ya puedes usarlo. Si te sale un error como "comando no encontrado", tendrás que instalarlo.

Instalación rápida de WP-CLI

Descarga el archivo principal:

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

Hazlo ejecutable:

chmod +x wp-cli.phar

Muévelo a un directorio que esté en tu PATH:

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

Verifica la instalación:

wp --info

[TIP] Si no tienes permisos de sudo, puedes guardar el archivo en tu carpeta de usuario y ejecutarlo como php wp-cli.phar. Pero lo ideal es tenerlo en el PATH para poder usar wp directamente.

Comandos básicos de WP-CLI para administrar WordPress

Ahora que tienes WP-CLI funcionando, vamos a lo interesante. Aquí tienes los comandos más útiles para el día a día.

Navegar a tu instalación de WordPress

Lo primero es ubicarte en la carpeta raíz de tu WordPress. Normalmente es public_html o una subcarpeta. Por ejemplo:

cd ~/public_html

Ver el estado del sitio

wp core version

Esto te dice la versión de WordPress instalada.

wp core check-update

Te muestra si hay actualizaciones disponibles.

Administrar plugins

Listar todos los plugins:

wp plugin list

Activar un plugin:

wp plugin activate nombre-del-plugin

Desactivar un plugin:

wp plugin deactivate nombre-del-plugin

Actualizar un plugin específico:

wp plugin update nombre-del-plugin

Actualizar todos los plugins:

wp plugin update --all

[WARNING] Antes de actualizar masivamente, siempre es recomendable hacer una copia de seguridad. Un plugin puede ser incompatible con tu tema o con otros plugins.

Administrar temas

Listar temas instalados:

wp theme list

Activar un tema:

wp theme activate nombre-del-tema

Actualizar todos los temas:

wp theme update --all

Actualizar WordPress con WP-CLI

Esta es una de las tareas más populares. Actualizar WordPress desde la terminal es mucho más rápido y evita que se agote el tiempo de ejecución del navegador.

Actualizar el núcleo de WordPress:

wp core update

Actualizar a una versión específica:

wp core update --version=6.4.2

Actualizar la base de datos después del núcleo (si es necesario):

wp core update-db

[INFO] Siempre ejecuta wp core update-db después de actualizar el núcleo. Esto asegura que la base de datos esté al día con la nueva versión.

Administración avanzada con WP-CLI

Una vez que domines lo básico, puedes hacer cosas más potentes.

Cambiar la URL del sitio

Cuando migras un sitio de dominio o de local a producción, cambiar la URL es esencial.

wp option update home 'https://nuevodominio.com'
wp option update siteurl 'https://nuevodominio.com'

Crear un usuario administrador

¿Olvidaste tu contraseña o necesitas un nuevo usuario admin?

wp user create nuevo_usuario correo@ejemplo.com --role=administrator --user_pass=ContraseñaSegura

Cambiar la contraseña de un usuario existente

wp user update nombre_usuario --user_pass=NuevaContraseña

Buscar y reemplazar en la base de datos

Esto es oro puro para migraciones. Reemplaza URLs viejas por nuevas.

wp search-replace 'http://oldurl.com' 'https://newurl.com' --all-tables

[WARNING] Usa wp search-replace con muchísimo cuidado. Un error puede romper tu base de datos. Siempre haz una copia de seguridad antes.

Optimizar la base de datos

wp db optimize

Reparar la base de datos

wp db repair

Limpiar la caché de WordPress

Si usas un plugin de caché, WP-CLI puede ayudarte.

wp cache flush

Gestión de CRON

Ver los eventos programados:

wp cron event list

Ejecutar todos los eventos programados pendientes:

wp cron event run --due-now

Solución de problemas comunes con WP-CLI

A veces las cosas no salen a la primera. Aquí tienes algunos problemas típicos y cómo resolverlos.

Error de permisos de archivos

Si ves errores de "Permission denied", asegúrate de que los archivos de WordPress pertenezcan a tu usuario.

chown -R usuario:grupo ~/public_html

Memoria insuficiente

Para tareas pesadas, puedes aumentar el límite de memoria:

wp config set WP_MEMORY_LIMIT 256M

No puedo conectar a la base de datos

Verifica tus credenciales en wp-config.php. A veces el problema es que los comandos se ejecutan desde la carpeta incorrecta. Asegúrate de estar en la raíz de WordPress.

Automatización con scripts de WP-CLI

Una de las mayores ventajas de WP-CLI es que puedes crear scripts para automatizar tareas. Por ejemplo, un script que haga una copia de seguridad, actualice todo y envíe un correo.

Ejemplo de script básico:

#!/bin/bash
cd ~/public_html
wp db export backup.sql
wp core update
wp plugin update --all
wp theme update --all
wp cache flush
echo "Todo actualizado y con backup"

Guarda esto como actualizar.sh, dale permisos de ejecución (chmod +x actualizar.sh) y ejecútalo cuando quieras.

[TIP] Puedes programar este script con un cron job desde cPanel para que se ejecute automáticamente cada semana.

Preguntas frecuentes (FAQ)

¿WP-CLI funciona en cualquier hosting con cPanel?

La mayoría de los hosts que ofrecen cPanel también tienen SSH habilitado, lo que permite usar WP-CLI. Si tu proveedor no lo ofrece, considera cambiarte a uno que sí (por ejemplo, los que usan Syspanel en lugar de cPanel). En Syspanel, el acceso por terminal está en el puerto 2106, y la experiencia es similar.

¿Es peligroso usar WP-CLI?

No es peligroso si sabes lo que haces. El riesgo está en ejecutar comandos sin entender su efecto. Siempre haz copias de seguridad y prueba en un entorno de desarrollo si es posible.

¿Puedo usar WP-CLI si mi WordPress está en una subcarpeta?

Sí. Solo navega a esa subcarpeta antes de ejecutar los comandos. Por ejemplo, cd ~/public_html/miweb.

¿Qué pasa si no tengo acceso SSH?

Algunos hosts permiten usar la terminal integrada en el panel de control. Si no tienes ni eso, no podrás usar WP-CLI directamente. Considera migrar a un hosting más flexible.

¿WP-CLI actualiza plugins y temas automáticamente?

No por defecto. Pero puedes configurarlo para que lo haga con scripts o usando el comando wp plugin update --all manualmente.

¿Necesito conocimientos de programación?

No, solo saber copiar y pegar comandos y entender qué hace cada uno. Con esta guía y un poco de práctica, estarás listo.

Conclusión y próximos pasos

WP-CLI es una herramienta que transforma la manera en que administras WordPress. Con wp-cli cpanel puedes hacer actualizaciones, gestionar usuarios, optimizar bases de datos y mucho más, todo desde una simple terminal. No solo ahorras tiempo, sino que también reduces el riesgo de errores manuales.

Empieza probando los comandos más básicos en un sitio de prueba o en una copia de seguridad. A medida que ganes confianza, explora funciones avanzadas como la automatización con scripts y la gestión de multisitios.

[TIP] Guarda esta guía como referencia. Cada vez que necesites hacer una tarea en WordPress, piensa primero: "¿Cómo puedo hacer esto con WP-CLI?" La respuesta casi siempre te ahorrará varios clics.

Ahora ya tienes el conocimiento para administrar WordPress como un profesional desde cPanel. ¡Ponte manos a la obra y verás lo sencillo y poderoso que es!