WP-CLI: La guía esencial para administrar WordPress por SSH

¿Te imaginas poder gestionar tu WordPress sin tener que entrar al panel de administración, sin usar el ratón y con una velocidad que te dejará boquiabierto? Eso es exactamente lo que te ofrece WP-CLI.

WP-CLI (WordPress Command Line Interface) es una herramienta que te permite administrar tu sitio web desde la terminal de tu servidor, utilizando comandos de texto. Es como tener una "llave maestra" para tu WordPress.

No te preocupes si no eres un experto en informática. Esta guía está pensada para que, paso a paso y con un lenguaje muy sencillo, aprendas a usar wp-cli wordpress para hacer tu vida mucho más fácil.

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

Imagina que tienes que actualizar todos tus plugins. Normalmente, tendrías que ir uno por uno desde el escritorio de WordPress, hacer clic en "Actualizar", esperar... y repetir.

Con comandos wp-cli, puedes actualizarlos todos de una sola vez con un único comando. Es más rápido, más seguro y te permite hacer tareas complejas en segundos.

¿Por qué es tan útil?

Velocidad: Las tareas se ejecutan al instante, sin los tiempos de carga del navegador.
Automatización: Puedes programar tareas o combinarlas en scripts para realizar copias de seguridad o actualizaciones completas.
Gestión remota: Solo necesitas una conexión ssh wordpress para administrar tu sitio desde cualquier lugar del mundo.
Seguridad: Al no pasar por el navegador, evitas ciertos riesgos de seguridad y bloqueos por tiempo de ejecución.
Solución de problemas: Es la herramienta ideal para diagnosticar y reparar errores comunes, como el famoso "Error al establecer conexión con la base de datos".

En resumen, si quieres llevar tu gestión de WordPress a otro nivel, esta herramienta es imprescindible.

Primeros Pasos: Cómo acceder a la terminal

Antes de empezar a usar wp-cli ejemplos, necesitas acceder a la terminal de tu servidor.

### Opción 1: Usando el Panel de Control (Recomendado para principiantes)

La mayoría de los paneles de control modernos, como Syspanel (que puedes encontrar en el puerto 2106), ofrecen un acceso directo a la terminal.

Inicia sesión en tu panel de control (por ejemplo, Syspanel).
Busca una opción que se llame "Terminal", "SSH" o "Consola".
Haz clic en ella y se abrirá una ventana de texto donde podrás escribir comandos.

### Opción 2: Conectándote por SSH

Si te sientes más cómodo, puedes conectarte desde tu ordenador usando un programa como PuTTY (Windows) o directamente desde la terminal (Mac/Linux).

Abre tu terminal y escribe:

ssh usuario@tu-dominio.com

Te pedirá tu contraseña y listo, estarás dentro de tu servidor.

Instalar WP-CLI en tu servidor

Lo primero que debes hacer es comprobar si WP-CLI ya está instalado. Escribe:

wp --info

Si te da un error, significa que necesitas instalarlo. No te preocupes, es un proceso sencillo.

Descargar el archivo: Ejecuta estos comandos para descargar el archivo de WP-CLI.

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

Hacerlo ejecutable: Ahora, le damos permisos para que pueda ejecutarse.

chmod +x wp-cli.phar

Moverlo a una ubicación global: Para poder usarlo desde cualquier carpeta, lo movemos a un directorio del sistema.

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

¡Y listo! Ahora puedes usar el comando wp en cualquier lugar de tu servidor.

Los Comandos Básicos de WP-CLI que Debes Conocer

Aquí es donde empieza la magia. Vamos a ver los comandos wp-cli más útiles para el día a día.

IMPORTANTE: Para que estos comandos funcionen, debes estar en la carpeta raíz de tu instalación de WordPress (donde están los archivos wp-config.php y wp-content).

### 1. Actualizar el Núcleo, Plugins y Temas

Esta es una de las tareas más comunes y tediosas. Con WP-CLI, es pan comido.

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

[TIP] Puedes combinar estos comandos para actualizar todo tu sitio de una sola vez: wp core update && wp plugin update --all && wp theme update --all

### 2. Gestionar Plugins y Temas

Ver todos los plugins instalados: Esto te muestra una lista con su estado (activo, inactivo).

wp plugin list

Activar un plugin específico:

wp plugin activate nombre-del-plugin

Desactivar un plugin:

wp plugin deactivate nombre-del-plugin

Eliminar un plugin (¡Cuidado! Esta acción es permanente):

wp plugin delete nombre-del-plugin

Ver los temas instalados:

wp theme list

Cambiar el tema activo:

wp theme activate nombre-del-tema

### 3. Gestionar el Contenido (Entradas y Páginas)

Crear una nueva entrada:

wp post create --post_title="Mi primer post con WP-CLI" --post_status=publish

Ver la lista de entradas:

wp post list

Eliminar una entrada por su ID:

wp post delete 123 --force

(El --force es para que no vaya a la papelera, sino que se borre definitivamente).

### 4. Tareas de Mantenimiento y Optimización

Limpiar la caché del navegador (si usas un plugin de caché): Este comando es específico para WP Rocket.

wp rocket clean --confirm

Optimizar la base de datos: Esto repara y optimiza las tablas de tu base de datos, mejorando el rendimiento.

wp db optimize

Reparar la base de datos:

wp db repair

Solución de Problemas Comunes con WP-CLI

Cuando tu sitio web se rompe, a veces no puedes acceder al panel de administración. WP-CLI es tu mejor amigo en estas situaciones.

### 1. El temido "Error al establecer conexión con la base de datos"

Este error suele ocurrir porque las credenciales de la base de datos en tu archivo wp-config.php son incorrectas o el servidor de la base de datos está caído.

Con WP-CLI puedes comprobar el estado de la base de datos directamente:

wp db check

Si el error persiste, puedes usar WP-CLI para revisar la configuración:

wp config get DB_HOST
wp config get DB_NAME

Así podrás verificar que los valores son los correctos.

### 2. El "Plugin Fatal Error" (Pantalla Blanca de la Muerte)

Si un plugin roto te ha dejado sin acceso a tu panel, puedes desactivarlo desde la terminal.

Navega a la carpeta de tu WordPress.
Desactiva todos los plugins de golpe:

wp plugin deactivate --all

Si el sitio se recupera, significa que el problema era uno de los plugins. Ahora puedes ir activándolos uno a uno para encontrar al culpable.

wp plugin activate nombre-del-plugin

### 3. Cambiar la URL del sitio

Si has movido tu sitio de dominio y las URLs no se actualizan, puedes forzarlas con estos comandos:

wp option update home 'https://tu-nuevo-dominio.com'
wp option update siteurl 'https://tu-nuevo-dominio.com'

[WARNING] Este es un cambio crítico. Asegúrate de escribir la URL exacta, sin barras finales.

Automatización y Scripts Avanzados

La verdadera potencia de wp-cli wordpress se libera cuando lo combinas con scripts de shell. Puedes crear un archivo .sh con varios comandos para ejecutarlos todos juntos.

Ejemplo de un script de actualización y copia de seguridad:

#!/bin/bash
# Ir a la carpeta de WordPress
cd /ruta/a/tu/wordpress

# Hacer una copia de seguridad de la base de datos
wp db export backup-bd.sql

# Copiar los archivos a un directorio seguro
cp -r wp-content wp-content-backup

# Actualizar todo
wp core update
wp plugin update --all
wp theme update --all

# Limpiar la caché
wp cache flush

echo "¡Todo el sitio ha sido actualizado y respaldado!"

Este script haría una copia de seguridad de tu base de datos y tus archivos, y luego actualizaría todo tu sitio sin que tengas que hacer nada manualmente.

Consejos y Buenas Prácticas Finales

Usa el modo de depuración: Si algo sale mal, activa el modo de depuración de WordPress para ver los errores. Puedes hacerlo con WP-CLI:

wp config set WP_DEBUG true --raw

Crea un usuario administrador: Si te has quedado sin acceso, puedes crear un nuevo usuario administrador con WP-CLI.

wp user create nuevo-admin correo@ejemplo.com --role=administrator --user_pass=tu-password-segura

Consulta la ayuda: Siempre puedes ver todos los comandos disponibles y sus opciones escribiendo:

wp help

Preguntas Frecuentes (FAQ)

### ¿WP-CLI es difícil de aprender?

No. Si puedes escribir texto, puedes usar WP-CLI. La clave está en memorizar algunos comandos básicos y entender su estructura. Esta guía es un excelente punto de partida.

### ¿Necesito ser un "hacker" para usar SSH?

Para nada. SSH es simplemente una forma segura de conectarte a tu servidor. Con un poco de práctica, te sentirás cómodo en la terminal.

### ¿Puedo dañar mi sitio con WP-CLI?

Sí, como con cualquier herramienta poderosa. Si ejecutas comandos sin saber lo que hacen (como wp db drop), podrías causar daños graves. Siempre haz una copia de seguridad antes de ejecutar comandos que modifiquen la base de datos o eliminen archivos.

### ¿WP-CLI funciona con cualquier hosting?

Funciona en la mayoría de los servidores, especialmente en aquellos que usan Linux. Si tu hosting es muy restrictivo (solo panel de control), es posible que no tengas acceso a la terminal.

### ¿Qué hago si no encuentro el comando `wp`?

Asegúrate de haberlo instalado correctamente. Prueba a reinstalarlo o consulta la documentación oficial de WP-CLI.

Conclusión

WP-CLI es una herramienta revolucionaria que transformará la manera en que gestionas tu WordPress. No solo te ahorrará muchísimo tiempo, sino que te dará un control total sobre tu sitio web, incluso en los momentos más críticos.

Empieza con los comandos básicos y, poco a poco, ve explorando todas sus posibilidades. Verás que en poco tiempo no podrás vivir sin él.

[INFO] Si tienes acceso a Syspanel (a través del puerto 2106), te recomendamos encarecidamente que explores su terminal integrada para probar estos comandos. Es la forma más segura y cómoda de empezar.

¡Esperamos que esta guía te haya sido de gran ayuda! Ahora, ¡manos a la obra y a dominar tu WordPress desde la terminal!