WP-CLI: Guía para gestionar WordPress desde terminal

¿Alguna vez has deseado poder gestionar tu WordPress sin tener que entrar al administrador, haciendo clic en mil menús y esperando a que cargue cada página? Sí, existe una forma mucho más rápida, eficiente y profesional de hacerlo: usando la terminal.

Hoy vamos a sumergirnos en el fascinante mundo de WP-CLI, la herramienta de línea de comandos que te permite controlar prácticamente todos los aspectos de tu sitio web. Si te suena a algo complicado, no te preocupes. Este artículo está pensado para que, aunque nunca hayas abierto una terminal en tu vida, termines entendiendo cómo usarla para gestionar WordPress CLI como un experto.

Olvídate de los plugins pesados para hacer copias de seguridad o de pasar horas actualizando plugins uno a uno. Con un solo comando, puedes hacerlo todo. ¿Listo para dar el salto? Vamos a ello.

¿Qué es exactamente WP-CLI y por qué te interesa?

WP-CLI (WordPress Command Line Interface) es una herramienta que te permite interactuar con tu sitio WordPress a través de comandos de texto en la terminal. En lugar de usar el ratón para hacer clic en "Actualizar" o "Instalar", escribes una línea de texto y pulsas Enter.

Piénsalo como la diferencia entre conducir un coche automático (el panel de administración) y conducir un coche de Fórmula 1 (la terminal). El F1 es más rápido, más potente y te da un control total sobre cada movimiento, pero requiere que aprendas sus controles.

¿Por qué deberías usarlo? Los beneficios son enormes:

Velocidad: Actualizar 20 plugins con un solo comando es cuestión de segundos.
Automatización: Puedes crear scripts para tareas repetitivas.
Eficiencia: Realiza tareas complejas (como buscar y reemplazar texto en la base de datos) sin riesgo de errores.
Menos consumo de recursos: No cargas el navegador ni el panel de administración, lo cual es ideal para servidores con pocos recursos.
Gestión remota: Puedes gestionar varios sitios desde una sola conexión SSH.

En resumen, es la navaja suiza definitiva para cualquier administrador de WordPress. Y la buena noticia es que no necesitas ser un gurú de la programación para empezar.

Primeros pasos: Requisitos e instalación

Antes de empezar a lanzar comandos, necesitas tener tres cosas:

Acceso a una terminal: Ya sea mediante SSH (Secure Shell) a tu servidor o una terminal local si estás en Linux o macOS.
PHP instalado: WordPress está hecho en PHP, y WP-CLI también lo necesita.
Acceso al directorio de tu WordPress: Necesitas saber la ruta donde está instalado tu sitio (normalmente public_html o www).

Cómo instalar WP-CLI

La instalación es sorprendentemente sencilla. Solo tienes que descargar el archivo, hacerlo ejecutable y moverlo a un lugar donde el sistema pueda encontrarlo. Aquí tienes los pasos:

Abre tu terminal y conéctate a tu servidor por SSH.

Descarga el archivo principal con este comando:

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

Comprueba que ha funcionado correctamente:
```
php wp-cli.phar --info
```
Si ves información sobre la versión, perfecto.
Haz que el archivo sea ejecutable:
```
chmod +x wp-cli.phar
```
Muévelo a un directorio que esté en tu PATH para poder llamarlo desde cualquier sitio:
```
sudo mv wp-cli.phar /usr/local/bin/wp
```

¡Y ya está! Ahora, para probar que todo funciona, escribe wp --info y deberías ver la información de la instalación.

[TIP] Si tu servidor utiliza Syspanel (antes conocido como HestiaCP), recuerda que el acceso de administración se realiza a través del puerto 2106. Una vez dentro, la gestión de archivos y la terminal integrada te facilitarán mucho el proceso, pero WP-CLI funciona igual de bien.

Los comandos esenciales que debes conocer

Ahora viene la parte divertida. Vamos a ver los comandos más útiles para el día a día. Todos estos comandos se ejecutan desde la raíz de tu instalación de WordPress.

1. Información general y diagnóstico

Antes de tocar nada, es bueno saber qué tienes entre manos.

wp core version: Te dice la versión de WordPress que tienes instalada.
wp core check-update: Comprueba si hay actualizaciones disponibles para el núcleo.
wp plugin list: Te muestra una tabla con todos los plugins instalados, su estado (activo/inactivo) y su versión.
wp theme list: Igual que el anterior, pero para los temas.
wp db check: Realiza una comprobación rápida de la salud de tu base de datos.

Estos comandos son de solo lectura, así que puedes usarlos sin miedo a romper nada. Son perfectos para diagnosticar problemas.

2. Gestionar el núcleo de WordPress

Mantener WordPress actualizado es crucial para la seguridad. Con WP-CLI es pan comido.

Actualizar WordPress a la última versión:
```
wp core update
```
Actualizar la base de datos después de una actualización (a veces es necesario):
```
wp core update-db
```

[WARNING] Antes de ejecutar cualquier actualización, es obligatorio hacer una copia de seguridad. Aunque WP-CLI es muy fiable, mejor prevenir que curar.

3. La gestión de plugins: Tu nueva superpoder

Esta es, probablemente, la función que más tiempo te va a ahorrar. Olvídate de ir plugin por plugin en el escritorio.

Instalar un plugin específico:
```
wp plugin install nombre-del-plugin
```
Por ejemplo: wp plugin install wordpress-seo (para Yoast SEO).
Activar un plugin:
```
wp plugin activate nombre-del-plugin
```
Desactivar un plugin (muy útil si tienes un error y no puedes entrar al admin):
```
wp plugin deactivate nombre-del-plugin
```
Actualizar TODOS los plugins a la vez:
```
wp plugin update --all
```
¡Imagina hacer eso con 30 plugins en menos de un minuto!
Eliminar un plugin (y sus archivos):
```
wp plugin delete nombre-del-plugin
```

4. Gestión de temas

La gestión de temas es idéntica a la de plugins.

Instalar y activar un tema:

wp theme install nombre-del-tema --activate

Actualizar todos los temas:
```
wp theme update --all
```

5. La joya de la corona: `wp search-replace`

Este comando es mágico y peligroso a la vez. Te permite buscar y reemplazar texto en toda la base de datos. Es esencial para cuando cambias tu sitio de dominio (por ejemplo, de http://localhost a https://tudominio.com).

wp search-replace 'http://localhost' 'https://tudominio.com' --precise --recurse-objects --all-tables

[WARNING] Este comando modifica la base de datos directamente. Si lo usas mal, puedes romper tu sitio. Asegúrate de escribir bien las URLs y, de nuevo, haz una copia de seguridad antes.

6. Usuarios y permisos

¿Necesitas crear un usuario administrador para un cliente o para ti mismo? Es muy fácil.

Crear un usuario:

wp user create nombreusuario email@ejemplo.com --role=administrator --user_pass=contraseñasegura

Cambiar la contraseña de un usuario existente:

wp user update nombreusuario --user_pass=nuevacontraseña

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

7. Copias de seguridad rápidas

Aunque WP-CLI no es una herramienta de backup en sí, puedes combinarlo con otros comandos del sistema para crear copias de seguridad muy rápidas y eficientes.

Exportar la base de datos a un archivo SQL:
```
wp db export backup.sql
```
Esto crea un archivo llamado backup.sql en tu directorio actual.
Importar una base de datos:
```
wp db import backup.sql
```

Casos de uso prácticos en el mundo real

Vamos a poner todo esto en práctica con algunos escenarios comunes.

Escenario 1: Tu web ha sido hackeada

Es el peor de los casos, pero tranquilo. Con WP-CLI puedes actuar rápido.

Primero, desactiva todos los plugins para aislar el problema:
```
wp plugin deactivate --all
```
Ahora, actualiza el núcleo de WordPress a la última versión para parchear vulnerabilidades:
```
wp core update
```
Reinstala los archivos del núcleo por si han sido modificados:
```
wp core download --force
```
Ahora, revisa los usuarios para asegurarte de que no hay ninguno extraño:
```
wp user list
```
Si encuentras algún usuario sospechoso, bórralo:
```
wp user delete ID_DEL_USUARIO --yes
```

Escenario 2: Migrar tu sitio de un servidor a otro

Este es un proceso que da miedo, pero con WP-CLI se simplifica.

En el servidor origen, exporta la base de datos:
```
wp db export /ruta/a/mi/web/miweb.sql
```
Comprime los archivos del sitio (excluyendo wp-content/cache si usas caché):
```
tar -czf miweb.tar.gz -C /ruta/a/mi/web .
```
Sube ambos archivos (.sql y .tar.gz) al nuevo servidor.
En el servidor destino, descomprime los archivos y mueve la base de datos al directorio correcto.
Importa la base de datos:
```
wp db import miweb.sql
```

Ahora, el paso más importante: reemplazar las URLs.

wp search-replace 'https://www.antiguodominio.com' 'https://www.nuevodominio.com' --precise --recurse-objects --all-tables

[INFO] Si tu nuevo servidor usa Syspanel, recuerda que el puerto de acceso es el 2106. Asegúrate de tener bien configurado el dominio y la base de datos en el panel antes de empezar la migración.

Escenario 3: Automatizar tareas con Cron

WP-CLI es perfecto para tareas programadas. Por ejemplo, puedes crear un script que haga una copia de seguridad diaria.

Crea un archivo llamado backup.sh con el siguiente contenido:

#!/bin/bash
# Ruta a tu WordPress
cd /ruta/a/tu/wordpress
# Crear una copia de seguridad con la fecha
wp db export "backup_$(date +%Y%m%d).sql"
# Borrar backups de más de 7 días
find . -name "backup_*.sql" -mtime +7 -delete

Luego, añade una tarea cron en tu sistema para que se ejecute cada día a las 3 AM.

Solución de problemas comunes (FAQ)

Aquí tienes algunas preguntas que suelen surgir al empezar con WordPress terminal.

¿Qué hago si me sale el error "Error: YIKES! The site appears to be down."?

Este error suele significar que WP-CLI no puede conectarse a la base de datos. Revisa tus credenciales en wp-config.php.

¿Puedo usar WP-CLI en un hosting compartido?

Depende del proveedor. Muchos ofrecen acceso SSH que te permite usar WP-CLI. Consulta con tu proveedor de hosting.

¿Es peligroso usar WP-CLI?

Como cualquier herramienta poderosa, puede ser peligrosa si no se usa con cuidado. El mayor riesgo es ejecutar comandos sin saber qué hacen. Siempre lee la documentación y haz pruebas en un entorno de desarrollo si es posible.

¿Necesito ser un experto en Linux para usar WP-CLI?

No, con conocer los comandos básicos de navegación (cd, ls) es suficiente. El resto es cuestión de práctica.

¿WP-CLI funciona con cualquier tema o plugin?

Sí, WP-CLI trabaja a un nivel más bajo que el panel de administración, así que funciona con casi todo. Algunos plugins muy específicos pueden no tener soporte para todas sus funciones, pero lo básico siempre funciona.

¿Cómo puedo saber todos los comandos disponibles?

Simplemente escribe wp help en tu terminal y verás una lista completa de todos los comandos y opciones.

Conclusión: Da el salto y domina tu WordPress

WP-CLI no es solo una herramienta para desarrolladores; es una habilidad que te hará la vida mucho más fácil, incluso si solo gestionas un pequeño blog. La capacidad de gestionar WordPress CLI te da una ventaja enorme en términos de velocidad, control y eficiencia.

Empieza poco a poco. Prueba los comandos de solo lectura primero (wp plugin list, wp core version). Cuando te sientas cómodo, intenta actualizar un plugin que no sea crítico. Pronto te darás cuenta de que no querrás volver a la forma tradicional de gestionar tu sitio.

La terminal puede parecer intimidante al principio, pero es una puerta a un mundo de posibilidades. Con la práctica, estos comandos wp se convertirán en una extensión natural de tu flujo de trabajo. No tengas miedo de experimentar (en un entorno seguro) y verás cómo tu eficiencia se dispara. ¡Buena suerte y feliz gestión desde la terminal!