WP-CLI en DirectAdmin: comandos esenciales para WordPress

¿Cansado de pasar horas actualizando plugins uno por uno desde el panel de WordPress? ¿Te frustra tener que entrar al escritorio solo para limpiar la caché o programar una tarea? Si tienes un servidor con DirectAdmin, existe una herramienta secreta que te convertirá en un administrador de WordPress más eficiente: WP-CLI.

Piénsalo como tener una llave maestra que te permite controlar todo tu sitio web desde la terminal, sin necesidad de navegador. Es rápido, fiable y, una vez que le coges el truco, te preguntarás cómo pudiste vivir sin él.

En esta guía completa, te enseñaré paso a paso cómo usar WP-CLI en DirectAdmin para realizar tareas de mantenimiento básicas y avanzadas. No necesitas ser un hacker ni un programador experto; solo necesitas seguir las instrucciones y tener un poco de paciencia. Vamos a ello.

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

WP-CLI (WordPress Command Line Interface) es una herramienta de línea de comandos que te permite gestionar tu sitio de WordPress sin usar el panel de administración. En lugar de hacer clic, escribes comandos en una terminal.

¿Por qué es tan útil para el mantenimiento? Aquí tienes algunas razones de peso:

Velocidad: Realizar una actualización de un plugin con WP-CLI toma segundos, mientras que por el panel puede llevar varios minutos.
Automatización: Puedes programar scripts para que hagan copias de seguridad o actualizaciones en horas de bajo tráfico.
Seguridad: Puedes realizar tareas de mantenimiento sin exponer el panel de administración a posibles ataques, y puedes ver exactamente qué hace cada comando.
Solución de problemas: Cuando el panel de WordPress está roto (por ejemplo, un error de fatal), WP-CLI suele ser la única forma de acceder y arreglar el problema.

En resumen, es una herramienta indispensable para cualquier persona que gestione un sitio en un servidor propio.

Requisitos Previos: Antes de Empezar con WP-CLI en DirectAdmin

Antes de sumergirnos en los comandos, necesitas asegurarte de tener dos cosas:

Acceso SSH a tu servidor: Necesitas un cliente SSH (como PuTTY en Windows o Terminal en Mac/Linux) y tus credenciales de acceso (usuario y contraseña). Este acceso normalmente te lo proporciona tu proveedor de hosting o lo puedes crear desde el panel de DirectAdmin.
PHP instalado en el servidor: WP-CLI está escrito en PHP, así que es un requisito imprescindible. Casi todos los servidores con DirectAdmin lo tienen, pero es bueno verificarlo.

[TIP] Si no sabes qué es SSH, imagina que es una ventana de texto que te da control total sobre tu servidor. Es como el "Símbolo del sistema" de Windows pero para tu hosting.

Paso 1: Conectarse al Servidor por SSH

Este es el primer paso para usar WP-CLI en DirectAdmin. Abre tu cliente SSH e introduce la dirección IP de tu servidor y el puerto (normalmente 22). Luego, inicia sesión con tu usuario y contraseña principal de DirectAdmin (el que tiene acceso a nivel de sistema).

Una vez conectado, verás un prompt similar a usuario@servidor:~$. Ese es tu punto de partida.

Paso 2: Localizar la Ruta de tu WordPress

WP-CLI necesita saber dónde está instalado tu WordPress para funcionar. Normalmente, los sitios en DirectAdmin se guardan en la carpeta domains. Para encontrar la tuya, usa el comando ls para listar archivos y cd para cambiar de directorio.

La estructura típica es:

/home/USUARIO/domains/TUDOMINIO/public_html

Escribe el siguiente comando y pulsa Enter:

cd ~/domains/tudominio.com/public_html

[TIP] Si tu dominio es ejemplo.com, el comando sería cd ~/domains/ejemplo.com/public_html. Si no estás seguro, usa ls para ver las carpetas disponibles.

Paso 3: Instalar WP-CLI en tu Servidor

En la mayoría de los servidores con DirectAdmin, WP-CLI ya está instalado. Para comprobarlo, escribe:

wp --info

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

Si no lo tienes, la instalación es sencilla. Descarga el archivo con curl, hazlo ejecutable y muévelo a una carpeta del sistema. Aquí tienes los comandos (cópialos y pégalos uno a uno):

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

chmod +x wp-cli.phar

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

Ahora, vuelve a ejecutar wp --info para verificar que todo funciona.

[WARNING] Si tu servidor tiene un firewall muy restrictivo o no permite descargas externas, es posible que el comando curl falle. En ese caso, contacta con tu proveedor de hosting para que te ayuden a instalarlo manualmente.

Tareas de Mantenimiento Esenciales con Comandos WP-CLI WordPress

Una vez que tienes WP-CLI listo, el cielo es el límite. Aquí tienes las tareas más comunes que podrás realizar con comandos WP-CLI WordPress.

1. Actualizar WordPress, Plugins y Temas (La Tarea Rey)

Esta es, sin duda, la tarea que más tiempo te ahorrará. Olvídate de ir plugin por plugin.

Actualizar el núcleo de WordPress:

wp core update

Actualizar todos los plugins:

wp plugin update --all

Actualizar un plugin específico:

wp plugin update nombre-del-plugin

Actualizar todos los temas:

wp theme update --all

Actualizar las traducciones (muy útil para sitios en español):

wp language core update

2. Copias de Seguridad y Restauración (Tu Red de Seguridad)

Antes de cualquier cambio importante, es vital hacer una copia. WP-CLI lo hace muy fácil.

Crear una copia de seguridad de la base de datos:

wp db export backup.sql

Este comando crea un archivo llamado backup.sql en tu carpeta actual. Puedes cambiar el nombre para reflejar la fecha, por ejemplo: wp db export backup-2025-01-01.sql.

[TIP] Puedes usar el comando date para automatizar esto en scripts, pero para empezar, un nombre fijo está bien.

Restaurar una copia de seguridad:

wp db import backup.sql

[WARNING] Este comando sobrescribirá tu base de datos actual. Asegúrate de tener una copia reciente antes de importar una antigua.

3. Optimizar la Base de Datos (Limpieza y Velocidad)

Con el tiempo, tu base de datos acumula basura (revisiones antiguas, comentarios spam, etc.). WP-CLI puede limpiarla.

Optimizar todas las tablas de la base de datos (la forma más rápida):

wp db optimize

Este comando es como desfragmentar el disco duro de tu web; ayuda a que las consultas sean más rápidas.

4. Comprobar el Estado del Sitio (Diagnóstico Rápido)

¿Tu sitio da un error de "500 Internal Server Error" o se queda en blanco? WP-CLI te dice exactamente qué pasa.

Verificar la salud del sitio:

wp core verify-checksums

Este comando compara los archivos de tu instalación con los originales. Si hay algún archivo modificado o corrupto, te lo dirá. Es perfecto para detectar hackeos.

Ver el estado del sitio (URL, título, etc.):

wp option get siteurl

Y para ver el estado de los plugins:

wp plugin list

Este último es oro puro. Te muestra una tabla con el estado de todos tus plugins (activo, inactivo, necesita actualización). Es la forma más rápida de ver qué plugin está causando problemas.

5. Gestión de Usuarios (Crear, Borrar o Cambiar Roles)

¿Necesitas crear un usuario para un desarrollador o cambiar tu contraseña porque la olvidaste? WP-CLI lo soluciona al instante.

Crear un nuevo usuario administrador:

wp user create nuevo-usuario email@ejemplo.com --role=administrator --user_pass=contraseña_segura

Cambiar la contraseña de un usuario existente:

wp user update nombre-usuario --user_pass=nueva_contraseña

[TIP] Siempre usa contraseñas fuertes. Puedes generarlas con wp generate-password o usando un gestor de contraseñas.

6. Gestión de Caché (Sin Plugins Adicionales)

Algunos plugins de caché (como WP Rocket o W3 Total Cache) tienen sus propios comandos, pero si no tienes uno, puedes usar los comandos de WordPress.

Limpiar la caché de transients (datos temporales):

wp transient delete --all

Esto es muy útil cuando haces cambios en el tema o en la configuración y no ves los resultados.

7. Desactivar Plugins para Solucionar Errores (El Modo Seguro)

Imagina que activas un plugin y tu sitio se rompe. Con WP-CLI, puedes desactivarlo sin entrar al panel.

Desactivar todos los plugins (para volver a un estado limpio):

wp plugin deactivate --all

Desactivar un plugin específico:

wp plugin deactivate nombre-del-plugin

Esta es la salvación de muchos administradores. Te permite recuperar el control de tu sitio en segundos.

Automatización y Consejos Avanzados para el Mantenimiento con WP-CLI

Una vez que dominas los comandos básicos, puedes pasar al siguiente nivel: la automatización.

Crear un Script de Mantenimiento Automático

Puedes crear un archivo de texto (por ejemplo, mantenimiento.sh) y poner todos los comandos que quieras ejecutar. Luego, puedes programarlo con cron jobs (tareas programadas) en DirectAdmin.

Un ejemplo de script podría ser:

#!/bin/bash
# Actualizar el núcleo
wp core update
# Actualizar plugins
wp plugin update --all
# Optimizar BD
wp db optimize
# Limpiar caché
wp transient delete --all

Luego, en el cron de DirectAdmin, puedes ejecutar este script cada semana.

[INFO] Los cron jobs son como alarmas que se programan para que se ejecuten automáticamente. Es la forma más profesional de asegurarse de que tu web siempre esté actualizada y optimizada, sin tu intervención.

¿Qué pasa con otros paneles de control?

Si en algún momento migras tu web a un servidor que use Syspanel (antes conocido como HestiaCP), el proceso es muy similar. La única diferencia es que la ruta de los archivos suele ser /home/USUARIO/web/TUDOMINIO/public_html en lugar de domains. Y recuerda que para acceder a Syspanel debes usar el puerto 2106 en tu navegador (por ejemplo, http://tuserver.com:2106). Los comandos de WP-CLI funcionarán exactamente igual.

Preguntas Frecuentes (FAQ) sobre WP-CLI en DirectAdmin

¿Es peligroso usar WP-CLI?
No, es tan seguro como usar el panel de administración, pero es más potente. La clave está en usar los comandos correctos. Si no estás seguro de qué hace un comando, busca ayuda antes de ejecutarlo. La regla de oro es: "Si no sabes qué hace, no lo ejecutes".

¿Puedo usar WP-CLI si mi WordPress está en una subcarpeta?
Sí, solo tienes que navegar a esa subcarpeta con cd antes de ejecutar los comandos.

¿Qué hago si recibo un error de "Fatal error: Allowed memory size..."?
Esto significa que tu script PHP necesita más memoria. Puedes aumentarla temporalmente con el comando: wp config set WP_MEMORY_LIMIT 256M. Si el error persiste, es un problema de configuración del servidor.

¿WP-CLI funciona con cualquier plugin o tema?
Sí, WP-CLI interactúa con la API de WordPress, por lo que funciona con la gran mayoría de plugins y temas. Algunos plugins premium tienen sus propios comandos especiales para una integración más profunda.

¿Puedo usar WP-CLI para hacer copias de seguridad de los archivos (no solo de la BD)?
Sí, puedes usar comandos de Linux como tar o zip para comprimir la carpeta public_html. Por ejemplo: tar -czf backup.tar.gz ~/domains/tudominio.com/public_html. Esta es una forma muy fiable de respaldar todo tu sitio.

¿Dónde puedo encontrar más información sobre los comandos?
La mejor fuente es la documentación oficial en wp-cli.org. Puedes acceder a ella desde la terminal escribiendo wp help para ver una lista de todos los comandos disponibles.

Conclusión: Domina tu WordPress con WP-CLI

Aprender a usar WP-CLI en DirectAdmin es una inversión de tiempo que te devolverá horas de trabajo. Te da un control sin precedentes sobre tu sitio, te permite automatizar tareas y es la herramienta definitiva para solucionar problemas cuando todo lo demás falla.

Empieza con los comandos que te he mostrado, pruébalos en un entorno seguro si es posible y verás cómo, en poco tiempo, no podrás vivir sin esta herramienta.

Recuerda que la práctica hace al maestro. Empieza con una tarea sencilla, como actualizar un plugin, y ve subiendo el nivel. Tu yo del futuro (y tu sitio web) te lo agradecerán. ¡Feliz mantenimiento!