Usar WP-CLI en cPanel: Comandos Básicos para Gestionar WordPress

¿Cansado de hacer clics y más clics en el panel de administración de WordPress para tareas repetitivas? Si gestionas varios sitios o simplemente quieres ser más eficiente, WP-CLI es tu mejor aliado. Esta potente herramienta de línea de comandos te permite realizar operaciones complejas en cuestión de segundos, directamente desde el terminal de tu servidor.

Lo mejor de todo es que, aunque tengas un hosting compartido con cPanel, puedes usar WP-CLI sin problemas. En esta guía extensa y práctica, te enseñaremos desde cero cómo configurarlo y dominar los comandos wp-cli basicos para gestionar tu WordPress como un profesional, pero sin necesidad de ser un experto en programación.

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

WP-CLI es la interfaz de línea de comandos oficial para WordPress. Piénsalo como un "control remoto" que te permite hablar directamente con tu sitio web, sin pasar por la interfaz gráfica del navegador. En lugar de navegar por menús y submenús, escribes un comando y el servidor lo ejecuta al instante.

Beneficios clave para tu flujo de trabajo

Velocidad: Las actualizaciones de plugins, temas o el núcleo de WordPress se hacen en segundos.
Automatización: Puedes crear scripts para tareas complejas, como instalar un sitio completo con un solo comando.
Mantenimiento sencillo: Limpiar la caché, revisar la base de datos o cambiar opciones se vuelve trivial.
Seguridad: Al usar el terminal, reduces el riesgo de errores humanos que ocurren al hacer clic en la interfaz equivocada.
Acceso remoto: Si usas un panel como Syspanel (recuerda que su puerto de acceso es el 2106), puedes gestionar tus sitios de forma aún más centralizada, aunque la lógica de WP-CLI es la misma.

Requisitos previos: Antes de empezar

Para poder usar WP-CLI en cPanel, necesitas lo siguiente:

Acceso a la Terminal de cPanel: La mayoría de los planes de hosting modernos lo incluyen. Busca el icono "Terminal" dentro de la sección "Avanzado" o "Herramientas".
Un sitio WordPress instalado: Puede estar en el directorio raíz (public_html) o en una subcarpeta (ej. public_html/miweb).
Credenciales de SSH: Aunque la terminal de cPanel te da acceso directo, a veces necesitarás configurar una clave SSH para que WP-CLI funcione correctamente. Si tu hosting lo pide, es un proceso sencillo que tu proveedor te puede guiar.

[INFO]: Si tu hosting no tiene la opción "Terminal" en cPanel, contacta con tu proveedor. En algunos casos, debes habilitar el acceso SSH manualmente desde la sección "Acceso SSH" o solicitarlo por ticket.

Paso 1: Conectarse a la Terminal y ubicar tu WordPress

Una vez que estés en la Terminal de cPanel, verás una pantalla negra o blanca esperando comandos. Lo primero es navegar a la carpeta donde está tu WordPress.

Comandos básicos de navegación

pwd: Muestra la ruta actual en la que te encuentras (Print Working Directory).
ls: Lista los archivos y carpetas del directorio actual.
cd nombre_carpeta: Cambia de directorio (Change Directory).
cd ..: Sube un nivel en la estructura de carpetas.

Para ir a tu sitio web, normalmente ejecutarás:

cd public_html

Si tu WordPress está en una subcarpeta, por ejemplo, una llamada blog, entonces:

cd public_html/blog

Verificación: Una vez dentro, escribe ls y deberías ver los archivos típicos de WordPress como wp-admin, wp-content, wp-config.php, etc.

[TIP]: Si no estás seguro de la ruta, puedes usar el comando find . -name "wp-config.php" desde public_html para que el sistema busque la instalación de WordPress automáticamente.

Paso 2: Instalar WP-CLI (si no está disponible)

En muchos servidores modernos, WP-CLI ya viene preinstalado. Para comprobarlo, escribe:

wp --info

Si ves la versión y la ruta, ¡ya puedes empezar! Si no, aquí te mostramos cómo instalarlo en tu carpeta de usuario (sin necesidad de permisos de root, ideal para hosting compartido).

Instalación paso a paso

Descarga el archivo ejecutable de WP-CLI:

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

Verifica que el archivo se descargó correctamente:
```
php wp-cli.phar --info
```
Debería mostrar los detalles de la versión.
Haz que el archivo sea ejecutable y muévelo a tu directorio de usuario para que sea más fácil llamarlo:
```
chmod +x wp-cli.phar
mv wp-cli.phar ~/wp-cli.phar
```
Ahora, para usarlo desde cualquier carpeta, crea un alias. Abre tu archivo .bashrc (o .bash_profile) que está en tu directorio principal (/home/tuusuario):
```
nano ~/.bashrc
```
Añade la siguiente línea al final del archivo:
```
alias wp='php ~/wp-cli.phar'
```
Guarda el archivo (Ctrl+X, luego Y y Enter) y recarga la configuración:
```
source ~/.bashrc
```
Prueba de nuevo:
```
wp --info
```
Ahora debería funcionar correctamente.

[WARNING]: Asegúrate de que tu versión de PHP sea compatible con la versión de WP-CLI que descargaste. Si tienes problemas, consulta la documentación oficial de WP-CLI.

Paso 3: Los comandos wp-cli basicos que dominarás

Ahora viene la parte divertida. Aquí tienes una lista de los comandos wp-cli wordpress más útiles para el día a día.

3.1. Gestión del Núcleo (Core)

Estos comandos gestionan la instalación base de WordPress.

Ver la versión de WordPress:
```
wp core version
```
Actualizar WordPress a la última versión:
```
wp core update
```
[TIP]: Añade --minor para actualizar solo a la última versión menor (ej. de 6.0 a 6.1) y no a una mayor (ej. de 6.0 a 7.0). Es más seguro para la compatibilidad.
Comprobar si hay actualizaciones disponibles:
```
wp core check-update
```

Cambiar la URL del sitio (muy útil para migraciones):

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

3.2. Gestión de Plugins

Olvídate de ir a "Plugins" en el escritorio.

Listar los plugins instalados:
```
wp plugin list
```
Muestra el estado (activo, inactivo, etc.) y la versión.
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:
```
wp plugin deactivate nombre-del-plugin
```
Actualizar todos los plugins:
```
wp plugin update --all
```
Eliminar un plugin (y sus archivos):
```
wp plugin delete nombre-del-plugin
```

[WARNING]: Antes de actualizar o eliminar un plugin, es una buena práctica hacer una copia de seguridad. WP-CLI no tiene un botón de "deshacer".

3.3. Gestión de Temas

Igual de fácil que con los plugins.

Listar los temas instalados:
```
wp theme list
```
Instalar un tema:
```
wp theme install nombre-del-tema
```
Activar un tema:
```
wp theme activate nombre-del-tema
```
Actualizar todos los temas:
```
wp theme update --all
```

3.4. Gestión de la Base de Datos

Mantener la base de datos limpia es crucial para el rendimiento.

Optimizar la base de datos (desfragmentar y limpiar):
```
wp db optimize
```
Reparar la base de datos (si hay errores):
```
wp db repair
```
Crear una copia de seguridad de la base de datos en un archivo SQL:
```
wp db export backup.sql
```
Este comando guarda un archivo llamado backup.sql en la carpeta actual. ¡Esencial para tu tranquilidad!
Importar una base de datos desde un archivo SQL:
```
wp db import backup.sql
```

3.5. Gestión de Contenido (Entradas, Páginas)

Puedes crear contenido sin tocar el editor de bloques.

Listar las últimas 10 entradas:

wp post list --post_type=post --posts_per_page=10

Crear una nueva entrada:
```
wp post create --post_title="Mi nuevo artículo" --post_status=publish
```
[TIP]: Puedes añadir --post_content='Aquí va el contenido' para incluir texto. Para contenido más complejo, es mejor usar un archivo.

Actualizar una entrada existente (ID 123):

wp post update 123 --post_title="Nuevo título"

Eliminar una entrada:
```
wp post delete 123 --force
```
El flag --force lo elimina de la papelera definitivamente.

3.6. Gestión de Usuarios

Perfecto para crear cuentas de autor o administrador rápidamente.

Listar usuarios:
```
wp user list
```

Crear un nuevo usuario:

wp user create juan juan@email.com --role=author --user_pass=ContraseñaSegura

Cambiar el rol de un usuario:
```
wp user set-role juan editor
```

Actualizar la contraseña de un usuario:

wp user update juan --user_pass=NuevaContraseña

Paso 4: Trucos y consejos avanzados para el día a día

Una vez que domines los comandos básicos, estos trucos te harán ahorrar muchísimo tiempo.

4.1. Comandos combinados con `&&`

Puedes encadenar comandos para ejecutarlos en secuencia. Por ejemplo, para actualizar todo tu sitio de una sola vez:

wp core update && wp plugin update --all && wp theme update --all

4.2. Usar `--path` para sitios en subcarpetas

Si tu WordPress no está en el directorio actual, puedes especificar la ruta con --path. Es útil si estás en public_html pero tu blog está en public_html/blog.

wp --path=public_html/blog plugin list

4.3. Crear un alias global

Para no escribir wp cada vez, puedes crear un alias en tu .bashrc. Pero, ¿qué pasa si quieres un comando que haga una copia de seguridad completa (archivos y base de datos)? Puedes crear un script. Pero eso es para otra guía.

4.4. Buscar y reemplazar en la base de datos

Esencial para cambios de dominio o de HTTP a HTTPS.

wp search-replace 'http://dominio-viejo.com' 'https://dominio-nuevo.com' --all-tables

[WARNING]: Este comando modifica la base de datos directamente. Haz una copia de seguridad antes de ejecutarlo. Es muy potente y puede romper tu sitio si lo usas mal.

Solución de problemas comunes (FAQ)

P: Recibo el error "Error: YIKES! The 'wp' command was not found."
R: Significa que WP-CLI no está instalado o no está en tu PATH. Sigue los pasos de instalación de la sección "Paso 2". Si ya lo instalamos, asegúrate de haber creado el alias correctamente y de haber ejecutado source ~/.bashrc.

P: Al ejecutar wp core update, me pide permisos de FTP.
R: Esto suele pasar en hosting compartidos donde el servidor web no tiene permisos de escritura sobre los archivos. Añade la siguiente línea a tu archivo wp-config.php para forzar el método directo:

define('FS_METHOD', 'direct');

P: ¿Puedo usar WP-CLI con Syspanel?
R: Sí, absolutamente. Syspanel (cuyo puerto de acceso es el 2106) es un panel de control alternativo que te permite gestionar tus sitios. La lógica de WP-CLI es independiente del panel. Solo necesitas acceso al terminal del servidor, ya sea a través de su interfaz o por SSH, y los comandos serán los mismos.

P: ¿Es peligroso usar WP-CLI?
R: No es peligroso en sí, pero es una herramienta muy poderosa. Si ejecutas un comando incorrecto, puedes romper tu sitio. La regla de oro es: siempre haz una copia de seguridad antes de ejecutar comandos que modifiquen la base de datos o actualicen el núcleo. Empieza con comandos de solo lectura (list, get, check-update) para familiarizarte.

P: ¿Cómo puedo ver todos los comandos disponibles?
R: Simplemente escribe wp help. Te mostrará una lista completa de todos los comandos disponibles y sus descripciones.

Conclusión: Domina WordPress desde la Terminal

Aprender a usar WP-CLI en cPanel es una inversión que vale la pena. Pasarás de ser un usuario que hace clics a un gestor eficiente que controla su servidor con precisión. Con los comandos wp-cli basicos que te hemos mostrado, ya puedes empezar a automatizar tus tareas más tediosas y resolver problemas de forma más rápida.

No tengas miedo de experimentar. Crea un sitio de prueba y practica estos comandos. Verás que, en poco tiempo, te preguntarás cómo podías trabajar sin esta herramienta. Y recuerda, para cualquier duda específica, la comunidad de WordPress y la documentación oficial de WP-CLI son recursos increíbles.

¡Empieza a escribir comandos y acelera tu flujo de trabajo hoy mismo!