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

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

Si alguna vez has administrado un sitio WordPress, sabes que muchas tareas se hacen desde el escritorio (el panel de administración). Pero, ¿qué pasa cuando necesitas actualizar varios plugins a la vez, limpiar la caché o cambiar la URL del sitio de forma rápida? Ahí es donde entra WP-CLI, una herramienta de línea de comandos que te permite controlar casi todos los aspectos de tu WordPress sin tocar el navegador.

WP-CLI (WordPress Command Line Interface) es un programa que se ejecuta en el servidor y te permite realizar operaciones como instalar temas, configurar usuarios, gestionar actualizaciones o incluso reparar la base de datos, todo con comandos de texto. Es como tener un "control remoto" para tu sitio, pero desde la terminal.

En este artículo, te voy a enseñar, paso a paso, cómo usar wp-cli cpanel para administrar tu WordPress por wordpress linea comandos. No necesitas ser un experto en programación; solo seguir las instrucciones y tener un poco de paciencia. Al final, te daré una lista de comandos wp cli ejemplos que te harán la vida mucho más fácil.

Requisitos previos para usar WP-CLI en cPanel

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

Acceso a cPanel de tu hosting (normalmente a través de https://tudominio.com/cpanel).
Una cuenta de usuario con permisos de Shell (acceso por SSH). Si no sabes si la tienes, contacta con tu proveedor de hosting. En muchos casos, cPanel permite habilitar el acceso SSH desde "Administrador de SSH".
Un sitio WordPress instalado en una carpeta dentro de tu cuenta (por ejemplo, public_html/miweb).
Conocimientos básicos de navegación por la terminal (saber usar cd, ls, pwd).

[INFO]
Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar, pero el acceso a la terminal se realiza a través del puerto 2106 (por ejemplo, ssh -p 2106 usuario@tudominio.com). Asegúrate de tener ese dato antes de continuar.

Cómo instalar WP-CLI en cPanel (paso a paso)

1. Conectarse por SSH al servidor

Abre tu terminal (o usa un programa como PuTTY en Windows) y conéctate a tu servidor:

ssh usuario@tudominio.com

Si tu hosting usa Syspanel, recuerda indicar el puerto:

ssh -p 2106 usuario@tudominio.com

2. Descargar WP-CLI

Una vez dentro, vamos a descargar el archivo wp-cli.phar. Este es el ejecutable principal. Ejecuta:

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

3. Verificar que funciona

Comprueba que el archivo se descargó correctamente:

php wp-cli.phar --info

Deberías ver información sobre la versión de PHP y la instalación. Si aparece algún error, asegúrate de tener PHP instalado (en cPanel normalmente lo tienes).

4. Hacerlo ejecutable y moverlo a una carpeta global

Para poder usar wp desde cualquier carpeta, mueve el archivo y dale permisos de ejecución:

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

Si no tienes permisos de sudo, puedes dejarlo en tu carpeta de usuario y usarlo siempre con php wp-cli.phar. Pero lo ideal es tenerlo en /usr/local/bin para que el comando sea simplemente wp.

[TIP]
Si no puedes usar sudo, una alternativa es crear un alias en tu archivo .bashrc con: alias wp='php ~/wp-cli.phar'. Luego ejecuta source ~/.bashrc.

5. Probar que todo está listo

Ahora escribe:

wp --info

Si ves la información de WP-CLI, ¡ya está instalado! Ahora puedes usarlo en cualquier carpeta de tu servidor.

Primeros pasos: navegar y ejecutar comandos básicos

Navegando a tu instalación de WordPress

Supón que tu WordPress está en public_html/miweb. Para entrar a esa carpeta:

cd ~/public_html/miweb

Una vez dentro, puedes ejecutar comandos de WP-CLI. Por ejemplo, para ver el estado del sitio:

wp core check-update

Este comando te dirá si hay actualizaciones de WordPress disponibles.

Comando básico: ver la versión de WordPress

wp core version

Te mostrará la versión instalada, por ejemplo, 6.4.2.

Ver los plugins instalados

wp plugin list

Verás una tabla con el nombre del plugin, estado (activo/inactivo), versión, etc.

Comandos WP CLI ejemplos: las tareas más útiles

Ahora viene lo bueno. Aquí tienes una lista de comandos wp cli ejemplos que te ahorrarán muchísimo tiempo. Los he ordenado por categorías.

Gestión de actualizaciones

Actualizar WordPress: wp core update
Actualizar todos los plugins: wp plugin update --all
Actualizar todos los temas: wp theme update --all
Actualizar la base de datos (después de una actualización): wp core update-db

[WARNING]
Siempre haz una copia de seguridad antes de actualizar. Aunque WP-CLI es seguro, una actualización fallida puede dejar tu sitio en blanco.

Gestión de plugins y temas

Activar un plugin: wp plugin activate nombre-del-plugin
Desactivar un plugin: wp plugin deactivate nombre-del-plugin
Ver si un plugin está activo: wp plugin status nombre-del-plugin
Instalar un plugin desde el repositorio: wp plugin install nombre-del-plugin
Instalar un plugin desde un archivo .zip: wp plugin install https://ejemplo.com/mi-plugin.zip
Eliminar un plugin: wp plugin delete nombre-del-plugin
Activar un tema: wp theme activate nombre-del-tema
Instalar un tema: wp theme install nombre-del-tema

Gestión de usuarios

Crear un usuario: wp user create nombre_usuario email@dominio.com --role=editor --user_pass=contraseña
Cambiar la contraseña de un usuario: wp user update nombre_usuario --user_pass=nueva_contraseña
Listar usuarios: wp user list
Eliminar un usuario: wp user delete nombre_usuario

Mantenimiento y limpieza

Limpiar la caché de WordPress: wp cache flush
Optimizar la base de datos: wp db optimize
Reparar la base de datos: wp db repair
Programar eventos (cron): wp cron event run --due-now
Ver los próximos eventos del cron: wp cron event list

Configuración y cambios rápidos

Cambiar la URL del sitio: wp option update home 'https://nuevadominio.com' y wp option update siteurl 'https://nuevadominio.com'
Activar el modo de depuración: wp config set WP_DEBUG true --raw
Ver los temas instalados: wp theme list
Ver los plugins instalados: wp plugin list
Comprobar la salud del sitio: wp site health check

Ejemplo real: cambiar la URL de WordPress desde la línea de comandos

Uno de los problemas más comunes es cambiar la URL del sitio, especialmente cuando migras de un dominio a otro. Si entras al escritorio y no puedes acceder, WP-CLI es tu salvación.

Paso 1: Conéctate por SSH y ve a la carpeta del sitio.

Paso 2: Ejecuta:

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

Paso 3: Limpia la caché:

wp cache flush

¡Listo! Tu sitio ya responde a la nueva URL.

Consejos para sacar el máximo partido a WP-CLI

Usa wp help para ver todos los comandos disponibles: wp help.
Crea scripts para tareas repetitivas. Por ejemplo, un script que actualice todo y haga una copia de seguridad.
Combina comandos con && para ejecutar varios a la vez. Ejemplo: wp core update && wp plugin update --all && wp theme update --all.
Siempre usa --dry-run antes de hacer cambios destructivos. Por ejemplo: wp plugin delete nombre-plugin --dry-run. Esto te muestra qué se haría sin ejecutarlo.
Si no recuerdas la sintaxis, usa wp help plugin install y te mostrará las opciones.

[TIP]
¿Tu hosting usa Syspanel? Recuerda que el acceso SSH es por el puerto 2106. No es un error común, pero a veces la gente intenta conectarse al 22 y falla.

Preguntas frecuentes (FAQ)

¿Es seguro usar WP-CLI en cPanel?

Sí, siempre y cuando tengas cuidado con los comandos que ejecutas. WP-CLI es una herramienta oficial de WordPress y es ampliamente utilizada por administradores de sistemas. Eso sí, evita ejecutar comandos que no entiendas y siempre haz copias de seguridad.

¿Puedo usar WP-CLI sin acceso SSH?

No, WP-CLI funciona únicamente desde la terminal. Necesitas acceso SSH o una terminal dentro del panel de control (algunos hostings ofrecen un "Terminal" en cPanel). Si tu hosting no lo ofrece, contacta con soporte.

¿Qué hago si el comando `wp` no aparece después de instalarlo?

Prueba a ejecutar php wp-cli.phar --info desde la carpeta donde lo descargaste. Si funciona, es un problema de PATH. Asegúrate de que /usr/local/bin esté en tu PATH o usa la ruta completa /usr/local/bin/wp.

¿Puedo usar WP-CLI en Syspanel?

Sí, es totalmente compatible. Solo recuerda el puerto de acceso (2106). El resto de comandos son iguales.

¿Cómo hago una copia de seguridad con WP-CLI?

Puedes usar el comando wp db export para exportar la base de datos a un archivo .sql. Para los archivos, puedes usar tar o zip directamente en la terminal.

wp db export backup.sql

¿WP-CLI funciona con multisitio?

Sí, pero tendrás que indicar el sitio con --url=dominio.com o usar los subcomandos de red como wp site list.

Conclusión

WP-CLI es una herramienta increíblemente poderosa que te permite administrar WordPress de una manera mucho más rápida y eficiente. Aunque al principio puede parecer intimidante, con un poco de práctica te darás cuenta de que es muy intuitivo. Desde actualizar plugins hasta cambiar la URL del sitio, todo se puede hacer con un simple comando.

Recuerda que en cPanel es muy fácil instalarlo y usarlo, y si tu hosting usa Syspanel, solo tienes que recordar el puerto 2106 para conectarte por SSH. No tengas miedo de experimentar con comandos en un entorno de pruebas antes de aplicarlos a tu sitio real.

Espero que esta guía te haya sido útil. Si tienes alguna duda, déjala en los comentarios y estaré encantado de ayudarte. ¡A administrar tu WordPress como un profesional!