WordPress
Uso de WP-CLI en tu sitio WordPress
KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…
KPanel incluye una consola WP-CLI que ejecuta comandos contra tu sitio WordPress desde el navegador, sin necesidad de un cliente SSH ni credenciales de acceso al servidor. Esta guía cubre dónde encontrarla, exactamente qué comandos están permitidos y por qué, los atajos integrados en la pantalla, y qué hacer cuando necesitas algo que la consola no ejecutará.
Abrir la consola
- Inicia sesión en KPanel y haz clic en Websites (Sitios web) en la barra lateral izquierda.
- Haz clic en tu sitio WordPress.
- Abre la pestaña WordPress, luego la sección Console (Consola).
La entrada ya comienza con un prefijo fijo wp, así que solo escribes lo que viene después. plugin list, no wp plugin list. Presiona Enter o haz clic en Run (Ejecutar).
Console es una de las secciones que aparecen en planes administrados. En otros planes, la franja de pestañas termina con un enlace +8 en Managed en su lugar. Cada acción descrita aquí que no sea un comando bruto tiene un botón equivalente en otro lugar de KPanel, por lo que nada está fuera del alcance: la consola es una forma más rápida de llegar al mismo motor.
Los comandos se ejecutan como el usuario del sistema de tu sitio, dentro del directorio de tu sitio. No pueden ver ni tocar ningún otro sitio.
Qué ejecutará y qué no ejecutará la consola
La consola utiliza una lista de permitidos. Solo se aceptan los prefijos de comando a continuación, y cualquier otra cosa se rechaza antes de llegar al servidor con un mensaje que nombra el comando que rechazó.
| Área | Permitido |
|---|---|
| Core | core version, core check-update, core update, core is-installed, core verify-checksums |
| Plugins | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Themes | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Users | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Database | db size, db tables, db optimize, db repair, db check |
| Cache and transients | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Rewrite rules | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Config | config get, config list, config has, config shuffle-salts |
| Maintenance mode | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Read only inspection | option get, option list, post list, post get, comment list, comment get |
| Media and language | media regenerate, language core install, language core update |
| Search and replace | search-replace |
Las exclusiones deliberadas importan más que las inclusiones:
evalyshellestán bloqueados. PHP arbitrario y shell arbitrario convertirían la consola en equivalente a un prompt de root en una pestaña del navegador.db import,db export,db drop,db queryydb resetestán bloqueados. Importar y reiniciar destruyen una base de datos sin paso de confirmación;db queryes un prompt SQL sin restricciones. Usa phpMyAdmin en su lugar: Acceso a tu base de datos con phpMyAdmin.config setyconfig deleteestán bloqueados. Una mala escritura enwp-config.phpdesconecta el sitio. Lee los valores aquí, cámbialos a través del gestor de archivos.option updateyoption deleteestán bloqueados. Editar opciones sin ver es una forma común de romper un sitio más allá de la recuperación.
La consola no hace copia de seguridad para ti en ningún comando. Solo los botones en la sección Quick Actions lo hacen. Antes de search-replace, core update, plugin update, theme update, db optimize o db repair, haz una copia de seguridad tú mismo desde la pestaña Backups de tu sitio. Ver Realizar una copia de seguridad.
Trabajar en la consola
La pantalla hace más que aceptar un comando a la vez.
Botones preestablecidos. Los atajos agrupados se sitúan encima del prompt: Performance (vaciar caché, limpiar transitorios, vaciar reescrituras, verificar autoload), Database (optimizar, verificar, reparar, tamaño), Diagnostics (versión de WP, verificar actualizaciones, verificar núcleo, eventos cron), Content (listar plugins, temas, usuarios, ejecutar cron ahora), Security (usuarios administrador, sumas de comprobación de plugins, reiniciar salts, wp-config) y Maintenance (modo mantenimiento activado y desactivado, regenerar miniaturas, estado). Un clic ejecuta el comando.
Historial. Presiona las flechas arriba y abajo en el prompt para moverte a través de tus últimos 50 comandos en este sitio.
Fragmentos. Haz clic en el icono de marcador junto a un comando para guardarlo con un nombre, de modo que una invocación larga que usas cada mes sea un clic la próxima vez.
Tarjeta de entorno. Encima del prompt, una tarjeta muestra la versión de PHP de tu sitio, la versión de WordPress, el límite de memoria, la memoria actualmente utilizada, el máximo de carga y el límite de tiempo de ejecución, con un botón Copy for support (Copiar para soporte) que coloca todo eso más tu lista de plugins activos en el portapapeles. Pégalo en un ticket de soporte y habrás ahorrado un viaje de ida y vuelta.
Copiar salida. Cada bloque de resultado tiene botones de copiar y limpiar.
La salida se transmite de vuelta mientras se ejecuta el comando, por lo que una operación larga muestra progreso en lugar de quedarse en silencio.
Comandos que vale la pena conocer
Diagnóstico
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums compara tus archivos de núcleo y plugins con las copias publicadas oficialmente e informa cualquier cosa modificada. Es la comprobación inicial más rápida en un sitio que sospechas ha sido manipulado.
option list --autoload=yes enumera cada opción que WordPress carga en cada solicitud. Una tabla de autoload bloated es una de las causas más comunes de un sitio que es lento sin razón visible.
Mantenimiento
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Usuarios
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Cualquier cosa escrita aquí se registra en el registro de actividad de tu cuenta, incluidas las contraseñas. Cambia una contraseña que estableciste de esta manera una vez que hayas iniciado sesión. El detalle completo sobre recuperación de cuenta está en Restablecer una contraseña de administrador de WordPress perdida.
Buscar y reemplazar
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Siempre haz una ejecución en seco primero. El tutorial completo, incluido por qué un reemplazo SQL sin procesar corrompe una base de datos de WordPress, está en Ejecutar una búsqueda y reemplazo.
¿Consola o acciones rápidas?
Ambas ejecutan el mismo WP-CLI debajo. Elige sobre esta base:
| Tarea | Ruta mejor |
|---|---|
| Vaciar caché, actualizar plugins, regenerar medios | Quick Actions, un clic y hace copia de seguridad primero |
| Buscar y reemplazar con una vista previa por tabla | Quick Actions, la tarjeta Search & Replace |
| Cualquier cosa que necesite una bandera específica | Consola |
| Enumerar, inspeccionar, diagnosticar | Consola |
| Ejecutar un evento cron vencido | Consola |
Editar wp-config.php o importar una base de datos | Ninguno. Usa el gestor de archivos o phpMyAdmin |
Cuando necesitas más que la lista de permitidos
Para WP-CLI sin restricciones, conecta sobre SSH y ejecuta wp directamente desde el directorio de tu sitio. SSH utiliza solo autenticación por clave, así que añade tu clave pública primero desde la pestaña Files (Archivos) de tu sitio, luego SSH Keys (Claves SSH). Los detalles de conexión, incluido el host exacto, puerto y nombre de usuario, se muestran en esa misma pantalla. Ver Añadir claves SSH y Conectar sobre SFTP.
Solución de problemas
"'x y' is not in the allowed command list." El comando no está en la lista de permitidos. Comprueba la tabla anterior para el equivalente permitido más cercano, o usa SSH.
"No results returned. Check that WP-CLI is available." El comando se ejecutó pero no imprimió nada. Normalmente es comportamiento correcto para una consulta sin coincidencias.
El comando agota el tiempo. Los comandos de consola están limitados a 60 segundos. Las operaciones largas como la regeneración de una gran biblioteca de medios deben ejecutarse desde Quick Actions, que utiliza un límite más largo, o sobre SSH.
Nada se ejecuta y los botones están deshabilitados. Tu rol de cuenta Kapsule es de solo lectura para este sitio. Pide a un propietario de cuenta que lo aumente.