Usar WP-CLI en cPanel: Guía para gestionar WordPress por terminal

¿Te imaginas poder gestionar tu WordPress sin depender del navegador, sin que se te cuelgue la página y con una velocidad mucho mayor? Aunque parezca cosa de hackers, esto es totalmente posible gracias a WP-CLI, la herramienta de línea de comandos para WordPress. Si tu hosting usa cPanel, hoy te voy a enseñar paso a paso cómo usarla para tareas como actualizar plugins, limpiar la base de datos o cambiar la URL del sitio.

Este artículo es tu guía definitiva para dominar wp-cli cpanel. No necesitas ser un experto en programación, solo tener ganas de aprender y seguir las instrucciones al pie de la letra.

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

WP-CLI (WordPress Command Line Interface) es una herramienta que te permite gestionar tu sitio web a través de comandos de texto, en lugar de hacer clic en botones dentro del escritorio de WordPress.

Piensa en ello como la diferencia entre conducir un coche automático (usar el panel de administración) y conducir uno manual (usar la terminal). Al principio parece más complicado, pero una vez que le coges el truco, tienes un control total sobre el vehículo.

Estas son algunas de las ventajas de usar wordpress línea de comandos:

Velocidad: Las operaciones son mucho más rápidas porque no cargan toda la interfaz gráfica.
Automatización: Puedes ejecutar tareas repetitivas (como actualizar todos los plugins) con un solo comando.
Eficiencia: Ideal para tareas de mantenimiento que a veces fallan desde el navegador, como cambiar la URL del sitio o reparar la base de datos.
Acceso directo: Puedes gestionar archivos y la base de datos sin necesidad de usar phpMyAdmin o el administrador de archivos de cPanel.

Requisitos previos antes de empezar

Antes de lanzarnos a ejecutar comandos, necesitamos asegurarnos de que tenemos el entorno preparado. No te preocupes, es más sencillo de lo que parece.

1. Acceso a la terminal de cPanel

La mayoría de los hosting con cPanel ofrecen una herramienta llamada "Terminal" dentro del panel. Búscala en la sección "Avanzado" o "Herramientas".

Si no la ves, puede que tu proveedor la haya desactivado. En ese caso, tendrás que usar SSH (Secure Shell) desde tu ordenador con un programa como PuTTY (en Windows) o la propia terminal (en Mac/Linux). Para ello, necesitarás las credenciales SSH que normalmente encuentras en la sección "SSH Access" de cPanel.

[INFO] Si tu plan de hosting es compartido, es posible que la función SSH esté deshabilitada. Contacta con tu proveedor para activarla o consulta si tu plan la incluye.

2. Tener WordPress instalado

Lógicamente, necesitas tener WordPress instalado en el directorio que vas a gestionar. Normalmente, en cPanel, esto suele estar en la carpeta public_html o una subcarpeta de esta.

3. Conocer la ruta de tu instalación

Para ejecutar comandos, necesitas saber dónde está instalado WordPress. Por ejemplo:

Si tu sitio está en la raíz: /home/usuario/public_html
Si está en una subcarpeta: /home/usuario/public_html/miweb

Primeros pasos: Cómo acceder y verificar WP-CLI

Cuando abras la Terminal de cPanel, te encontrarás con una pantalla negra (o blanca) esperando tus órdenes. Lo primero que debes hacer es comprobar que WP-CLI está instalado.

Paso 1: Comprobar la instalación

Escribe el siguiente comando y presiona Enter:

wp --info

Si ves una salida con información sobre la versión de PHP, la ruta de WordPress y la versión de WP-CLI, ¡estás listo! Si te da un error de "comando no encontrado", tendrás que instalarlo.

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

No te asustes si no lo tienes. Instalarlo es un proceso de un minuto. Copia y pega estos comandos uno a uno:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
php wp-cli.phar --info
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

[WARNING] El comando sudo puede no funcionar en algunos hosting compartidos. Si te da error, omite ese paso y usa wp-cli.phar directamente (ej. php wp-cli.phar --info).

Paso 3: Navegar a tu carpeta de WordPress

Ahora, usa el comando cd (change directory) para moverte a la carpeta donde está tu WordPress:

cd public_html

Si tu web está en una subcarpeta, añádela:

cd public_html/miweb

A partir de este momento, todos los comandos que ejecutes se aplicarán a esta instalación de WordPress.

Los 10 comandos de WP-CLI que debes conocer (Guía práctica)

Ahora viene lo bueno. Vamos a ver los comandos más útiles para gestionar wordpress terminal. Los dividiremos por categorías para que sea más fácil de recordar.

1. Gestión de núcleo (Core)

wp core version: Te muestra la versión de WordPress que tienes instalada.
wp core update: Actualiza WordPress a la última versión.
wp core update-db: Actualiza la base de datos después de una actualización del núcleo.
wp core check-update: Comprueba si hay actualizaciones disponibles.

2. Gestión de Plugins

wp plugin list: Te muestra una tabla con todos tus plugins, su estado (activo/inactivo) y la versión.
wp plugin update --all: Actualiza todos los plugins a la vez. ¡Un gran ahorro de tiempo!
wp plugin activate nombre-del-plugin: Activa un plugin específico. Sustituye "nombre-del-plugin" por el slug real del plugin.
wp plugin deactivate nombre-del-plugin: Desactiva un plugin.
wp plugin delete nombre-del-plugin: Elimina un plugin del servidor.

3. Gestión de Temas

wp theme list: Muestra todos los temas instalados.
wp theme activate nombre-del-tema: Activa un tema.
wp theme update --all: Actualiza todos los temas.

4. Gestión de la Base de Datos

Esta es una de las funciones más potentes y útiles de wp-cli cpanel.

wp db optimize: Optimiza todas las tablas de la base de datos. Es como hacer una limpieza profunda.
wp db repair: Repara las tablas corruptas de la base de datos.
wp db check: Verifica el estado de la base de datos.
wp db export backup.sql: Crea una copia de seguridad de tu base de datos en un archivo llamado "backup.sql".
wp db import backup.sql: Importa una copia de seguridad desde un archivo .sql.

5. Mantenimiento y Seguridad

wp maintenance-mode activate: Activa el modo de mantenimiento (aparecerá una pantalla de "en breve" para los visitantes).
wp maintenance-mode deactivate: Desactiva el modo de mantenimiento.
wp option update blog_public 0: Desactiva la indexación por parte de los buscadores (útil para sitios en desarrollo).
wp option update blog_public 1: Activa la indexación de nuevo.

6. Tareas de SEO y Contenido

Aunque no lo creas, también puedes gestionar contenido para SEO desde la terminal.

wp post list --post_type=post: Lista todas tus entradas.
wp post create --post_title="Mi nuevo post" --post_status=publish: Crea una nueva entrada y la publica.
wp search-replace 'http://urlvieja.com' 'http://urlnueva.com' --all-tables: ¡IMPORTANTE! Este comando es la salvación para cambiar la URL de tu sitio sin romper nada. Reemplaza todas las apariciones de una URL antigua por una nueva en toda la base de datos.

[WARNING] El comando wp search-replace debe usarse con muchísimo cuidado. Te recomiendo hacer una copia de seguridad (wp db export) antes de ejecutarlo.

Ejemplos prácticos: Resolviendo problemas comunes

Vamos a poner esto en práctica con situaciones que te pueden pasar a diario.

Caso 1: Mi web se ha infectado y no puedo acceder al panel

Accede a la terminal y desactiva todos los plugins sospechosos:

cd public_html
wp plugin deactivate --all

Esto desactivará todo. Luego, puedes ir reactivándolos uno a uno para ver cuál era el problemático.

Caso 2: Quiero cambiar mi dominio de `miviejaweb.com` a `minuevaweb.com`

Este es el procedimiento clásico. Primero, haz una copia de seguridad:

wp db export backup-antes-cambio.sql

Luego, ejecuta el reemplazo:

wp search-replace 'https://miviejaweb.com' 'https://minuevaweb.com' --all-tables

¡Y listo! Tu base de datos estará actualizada con la nueva URL.

Caso 3: Actualizar todo el sitio de una vez

Para mantener tu web segura y rápida, es vital tener todo actualizado. Con un solo comando haces todo:

wp core update
wp plugin update --all
wp theme update --all
wp core update-db

Ejecuta estos comandos uno por uno. Es como darle un "chequeo médico" completo a tu WordPress.

Consejos y buenas prácticas para usar WP-CLI

Siempre haz copias de seguridad: Antes de ejecutar cualquier comando que modifique la base de datos o los archivos (como wp search-replace o wp plugin update), exporta una copia de seguridad de la BD. Es mejor prevenir que curar.
No uses --all-tables a la ligera: Úsalo solo cuando estés seguro de lo que haces. Puede ralentizar el servidor en sitios grandes.
Usa nombres de plugin/tema correctos: En la lista de wp plugin list, verás una columna llamada "name". Ese es el "slug" que debes usar en los comandos.
Practica en un entorno de pruebas: Si tienes un sitio de staging, úsalo para practicar antes de tocar tu web en producción.
Consulta la ayuda: Cualquier comando puede ser explorado. Por ejemplo, si quieres saber qué hace wp plugin, escribe wp plugin --help.

Preguntas Frecuentes (FAQ) sobre WP-CLI en cPanel

¿Es seguro usar WP-CLI?
Sí, es totalmente seguro si se usan los comandos correctos. De hecho, es la herramienta que usan los desarrolladores profesionales. El riesgo no está en la herramienta, sino en un mal uso (por ejemplo, borrar la base de datos sin querer). Por eso insistimos en las copias de seguridad.

¿Necesito ser un experto en programación?
No. Basta con saber copiar y pegar comandos y entender qué hace cada uno. Esta guía te da los básicos para empezar.

¿Puedo usar WP-CLI en cualquier hosting con cPanel?
En la mayoría de los casos, sí. Sin embargo, algunos hosting compartidos muy restrictivos pueden bloquear el acceso SSH o la ejecución de comandos. Si tu proveedor no lo permite, considera cambiar a un plan VPS o un hosting más flexible.

¿Qué pasa si mi web está en una subcarpeta?
Simplemente navega a esa carpeta con cd antes de ejecutar los comandos. Por ejemplo, cd public_html/blog.

¿Puedo automatizar tareas con WP-CLI?
Sí, puedes crear scripts (archivos .sh) que ejecuten varios comandos a la vez y programarlos con CRON desde cPanel. Esto es muy útil para hacer copias de seguridad automáticas.

Conclusión: Da el salto y domina tu WordPress

Aprender a usar wp-cli cpanel es una habilidad que te diferenciará del usuario común de WordPress. No solo te permitirá resolver problemas de forma más rápida, sino que también te dará un control total sobre tu sitio web.

Al principio, la línea de comandos puede parecer intimidante, pero te aseguro que con un poco de práctica te preguntarás cómo podías vivir sin ella. Empieza con comandos simples como wp core version o wp plugin list, y poco a poco ve incorporando otros más avanzados.

[TIP] No memorices todos los comandos. Es imposible. Lo que debes memorizar es la estructura: wp [objeto] [acción] [parámetros]. El resto, lo consultas en la ayuda (wp --help) o en esta guía.

Si tu hosting utiliza Syspanel (antes conocido como HestiaCP) en lugar de cPanel, no te preocupes. Aunque la interfaz es diferente, el acceso a la terminal se realiza de manera similar. Eso sí, recuerda que el puerto de acceso a Syspanel es el 2106, y una vez dentro, el uso de WP-CLI es idéntico al que te hemos mostrado.

Ahora, lánzate a la terminal, abre tu cPanel y empieza a explorar el poder de wordpress línea de comandos. Tu yo del futuro (y tu web) te lo agradecerán.