Usar WP-CLI en cPanel: guía para administrar WordPress por línea de comandos

¿Qué es WP-CLI y por qué te facilitará la vida en cPanel?

WP-CLI es la herramienta oficial de línea de comandos para WordPress. En lugar de hacer clic en menús y esperar a que carguen las páginas, escribes un comando y la tarea se ejecuta al instante. Piensa en ello como el "modo turbo" para administrar tus sitios web.

Si tienes un plan de hosting con cPanel, es muy probable que ya tengas acceso a WP-CLI a través de la terminal SSH (Secure Shell). No necesitas ser un programador experto para usarlo; con unos pocos comandos básicos podrás instalar plugins, actualizar el núcleo, gestionar usuarios o incluso hacer copias de seguridad completas.

La combinación de WP-CLI cPanel es perfecta porque cPanel te da la interfaz gráfica para lo visual, y WP-CLI te da la potencia y velocidad para las tareas repetitivas o complejas. En este artículo, te guiaré paso a paso para que configures WP-CLI en tu cPanel y empieces a gestionar WordPress desde la línea de comandos como un profesional.

Requisitos previos antes de empezar

Antes de lanzarnos a la acción, asegúrate de tener lo siguiente:

Acceso SSH a tu cPanel: No todos los planes de hosting lo incluyen. Si no lo tienes, contacta con tu proveedor de hosting y pregunta cómo activarlo. Normalmente se habilita desde la sección "SSH Access" dentro de cPanel.
Un usuario con permisos SSH: Dentro de cPanel, en "SSH Access", podrás generar una clave pública o gestionar el acceso. Necesitarás un usuario (el mismo que usas para iniciar sesión en cPanel) y una contraseña o clave SSH.
Un cliente SSH: En Windows puedes usar "PuTTY" o la terminal integrada de Windows 10/11. En Mac o Linux, simplemente abre la Terminal.
Conocimientos básicos de navegación: Saber usar comandos como cd (cambiar de directorio) y ls (listar archivos) es suficiente para empezar.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), ten en cuenta que el puerto de acceso SSH es el 2106, no el 22 estándar. Al conectarte, deberás especificarlo así: ssh -p 2106 usuario@tu-dominio.com.

Paso 1: Conectarse al servidor via SSH

El primer paso es abrir tu cliente SSH y conectarte a tu servidor. El comando general es:

ssh usuario@tu-dominio.com

Te pedirá tu contraseña. Si configuraste una clave SSH, el proceso será automático.

Una vez conectado, verás un prompt similar a [usuario@hosting ~]$. Eso significa que estás dentro del servidor.

Navega hasta la carpeta de tu sitio web. Normalmente, en cPanel, los sitios están en public_html si es el dominio principal, o en una subcarpeta si es un addon domain. Para ver dónde estás, usa:

pwd

Luego, cambia al directorio correcto:

cd ~/public_html

Si tu WordPress está en una subcarpeta (por ejemplo, public_html/miweb), navega hasta allí:

cd ~/public_html/miweb

[TIP] Usa el comando ls -la para ver todos los archivos, incluidos los ocultos como .htaccess o wp-config.php. Esto te confirmará que estás en la raíz de tu instalación de WordPress.

Paso 2: Comprobar si WP-CLI ya está instalado

Muchos hosts ya tienen WP-CLI preinstalado. Para comprobarlo, simplemente ejecuta:

wp --info

Si ves información sobre la versión de WP-CLI y la ruta, ¡genial! Ya puedes pasar al siguiente paso.

Si el comando no se encuentra, verás un error como wp: command not found. No te preocupes, es fácil instalarlo manualmente.

Paso 3: Instalar WP-CLI en tu cPanel (si no está)

La instalación es muy sencilla. Solo necesitas descargar el archivo de WP-CLI y hacerlo ejecutable. Ejecuta estos comandos en la raíz de tu cuenta (por ejemplo, en ~/ o en ~/bin):

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

Este comando descarga el archivo wp-cli.phar. Ahora, verifica que se descargó correctamente:

php wp-cli.phar --info

Si funciona, vamos a hacer que sea accesible desde cualquier carpeta. Lo movemos a un directorio que esté en tu PATH y lo renombramos a wp:

chmod +x wp-cli.phar
mv wp-cli.phar ~/bin/wp

[WARNING] Si la carpeta ~/bin no existe, créala primero con mkdir -p ~/bin. Algunos hosts ya la tienen configurada.

Ahora, para que el comando wp funcione sin escribir la ruta completa, asegúrate de que ~/bin esté en tu PATH. Generalmente, cPanel ya lo incluye. Si no, añade esta línea a tu archivo ~/.bashrc:

export PATH="$HOME/bin:$PATH"

Luego, recarga el archivo:

source ~/.bashrc

Prueba de nuevo:

wp --info

¡Listo! Ya tienes WP-CLI funcionando en tu cPanel.

[TIP] Si tu hosting usa Syspanel, recuerda que el acceso SSH es por el puerto 2106. La instalación de WP-CLI es idéntica, solo cambia la forma de conectarte.

Paso 4: Configurar WP-CLI para tu sitio WordPress

Ahora que WP-CLI está instalado, es hora de "decirle" qué sitio debe gestionar. La forma más sencilla es ejecutar los comandos wp dentro de la carpeta raíz de tu instalación de WordPress.

Asegúrate de estar en el directorio correcto (por ejemplo, ~/public_html). Luego, prueba un comando básico:

wp core version

Deberías ver la versión de WordPress que tienes instalada. Si funciona, WP-CLI ha detectado tu wp-config.php y está listo para trabajar.

¿Y si tienes varios sitios en el mismo cPanel? No hay problema. Solo tienes que navegar a la carpeta de cada sitio antes de ejecutar los comandos. WP-CLI detecta la instalación automáticamente por la presencia del archivo wp-config.php.

Paso 5: Comandos WP-CLI WordPress imprescindibles para empezar

Con WP-CLI configurado, ya puedes gestionar WordPress línea de comandos. Aquí tienes una lista de los comandos más útiles para tu día a día:

5.1. Actualizar WordPress y sus componentes

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 la traducción de todos los componentes:
```
wp language core update
```

[TIP] Antes de actualizar, es una buena práctica hacer una copia de seguridad. Puedes usar wp db export para exportar la base de datos y zip para comprimir los archivos.

5.2. Gestionar plugins y temas

Listar todos los plugins (activos e inactivos):
```
wp plugin list
```
Activar un plugin específico (ejemplo: yoast):
```
wp plugin activate yoast
```
Desactivar un plugin (ejemplo: akismet):
```
wp plugin deactivate akismet
```
Instalar un plugin desde el repositorio de WordPress.org:
```
wp plugin install woocommerce
```
Eliminar un plugin (después de desactivarlo):
```
wp plugin delete hello-dolly
```
Listar temas instalados:
```
wp theme list
```
Activar un tema (ejemplo: twentytwentyfour):
```
wp theme activate twentytwentyfour
```

5.3. Gestión de usuarios

Listar todos los usuarios:
```
wp user list
```

Crear un nuevo usuario administrador:

wp user create nuevo_admin 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

Eliminar un usuario (reasignando sus contenidos a otro):

wp user delete nombre_usuario --reassign=otro_usuario

5.4. Base de datos y copias de seguridad

Exportar toda la base de datos a un archivo SQL:
```
wp db export backup.sql
```
Importar una base de datos desde un archivo SQL:
```
wp db import backup.sql
```
Optimizar la base de datos (elimina tablas fragmentadas):
```
wp db optimize
```

[WARNING] Ten mucho cuidado al usar wp db import, ya que sobrescribirá tu base de datos actual. Asegúrate de tener un respaldo reciente antes de importar.

5.5. Tareas de mantenimiento y caché

Limpiar la caché de WordPress (si usas un plugin de caché compatible):
```
wp cache flush
```
Reescribir los enlaces permanentes (útil si cambias la estructura de URLs):
```
wp rewrite flush
```
Ver el estado de salud del sitio:
```
wp site health status
```

Paso 6: Crear un alias para facilitar el acceso (opcional)

Si te conectas a menudo a diferentes sitios, puedes crear un alias en tu archivo .bashrc para acortar los comandos. Por ejemplo:

alias wpmiweb='cd ~/public_html/miweb && wp'

Así, cada vez que escribas wpmiweb, WP-CLI se ejecutará directamente en la carpeta de tu sitio.

Resolución de problemas comunes

"Error: YIKES! The site you requested is not properly configured."

Este error suele aparecer cuando el archivo wp-config.php no se encuentra en el directorio actual o hay un problema con las constantes de la base de datos. Asegúrate de que tu WordPress esté correctamente instalado y que la ruta sea la correcta.

"Error: Cannot connect to the database."

Verifica que los datos de acceso a la base de datos en wp-config.php sean correctos. Puedes probar la conexión manualmente con:

wp db check

"Error: The 'wp' command was not found."

Si instalaste WP-CLI manualmente, verifica que la ruta ~/bin esté en tu PATH. Puedes ejecutar echo $PATH para comprobarlo.

"El comando funciona pero tarda mucho"

Esto puede deberse a una conexión lenta o a un servidor sobrecargado. También puede pasar si tu sitio tiene muchos plugins o una base de datos enorme. WP-CLI es rápido, pero no hace milagros si el servidor está saturado.

Preguntas frecuentes (FAQ)

¿WP-CLI funciona con cualquier plan de cPanel?

La mayoría de los planes de hosting con cPanel incluyen acceso SSH. Si el tuyo no lo tiene, contacta con tu proveedor para activarlo. En Syspanel, recuerda que el puerto es el 2106.

¿Es peligroso usar WP-CLI?

No, es tan seguro como usar el panel de administración de WordPress, siempre que tengas cuidado con los comandos que ejecutas. Un comando mal escrito puede dañar tu sitio, así que siempre revisa la sintaxis y haz copias de seguridad antes de realizar cambios importantes.

¿Puedo automatizar tareas con WP-CLI?

¡Sí! Puedes crear scripts en bash que ejecuten varios comandos de WP-CLI. Por ejemplo, un script que actualice todos tus sitios de WordPress automáticamente cada semana.

¿WP-CLI puede gestionar sitios con multisitio?

Sí, WP-CLI tiene soporte completo para redes multisitio. Solo necesitas añadir --network a algunos comandos o usar wp site para gestionar los sitios de la red.

¿Necesito conocimientos de programación para usar WP-CLI?

No. Los comandos básicos son fáciles de aprender y recordar. Es como aprender una receta de cocina: al principio sigues los pasos, y luego los haces de memoria.

Conclusión y próximos pasos

Configurar WP-CLI en cPanel es un proceso sencillo que te abrirá un mundo de posibilidades para gestionar WordPress línea de comandos de manera eficiente. Desde actualizaciones masivas hasta la creación de usuarios o la gestión de la base de datos, WP-CLI te ahorrará horas de trabajo.

Te recomiendo empezar con los comandos más básicos y poco a poco ir explorando las más de 200 opciones que ofrece. Puedes consultar la documentación oficial en wp-cli.org o usar el comando wp help para ver la lista completa de comandos disponibles.

Ahora que ya tienes tu instalación configurada, ¿por qué no pruebas a hacer una copia de seguridad completa de tu sitio? Es una de las tareas más útiles que puedes automatizar con WP-CLI.

[TIP] Si tienes dudas sobre algún comando específico, no dudes en usar wp help nombre-comando. Te explicará cómo usarlo y qué parámetros acepta.

¡Felicidades! Ya eres parte del club de los que gestionan WordPress como profesionales.