Generalidades
La Interfaz de Línea de Comandos de WordPress (wp-cli) es una herramienta de línea de comandos instalada en todos los servidores de DreamHost. Te permite ejecutar comandos de WordPress desde tu terminal Shell para gestionar tu sitio de WordPress sin necesidad de iniciar sesión en el panel de WordPress.
Requisitos previos
Este artículo asume que has creado un usuario de Shell y que puedes iniciar sesión en tu servidor a través de SSH.
Después de iniciar sesión en tu servidor, asegúrate de estar en el directorio de tu sitio web. Aquí es donde ejecutarás todos los comandos en este artículo.
Comandos generales
Estos son algunos comandos generales para comenzar.
Ver todos los comandos de wp-cli
[server]$ wp
Aparece una lista de todos los comandos disponibles.
Usar --help para ver la información del comando
Para obtener más información sobre un comando específico, usa la opción --help.
[server]$ wp plugin --help
Esto imprimirá una lista de subcomandos disponibles. Luego puedes agregar uno de estos subcomandos al comando principal para realizar una acción. Aquí se muestra cómo instalar un plugin llamado hello-dolly:
[server]$ wp plugin install hello-dolly
Versión de wp cli
| Acción | Comando |
|---|---|
|
Revisa la versión de wp-cli |
[server]$ wp cli version |
|
Revisa si hay actualizaciones |
[server]$ wp cli check-update |
| Actualiza wp-cli |
[server]$ wp cli update |
Comandos Top
Estos comandos son los más utilizados comúnmente.
Plugins
Obtener el nombre correcto del plugin
El nombre que uses al ingresar el PLUGIN_NAME debe ser el nombre exacto de la página web del plugin. Por ejemplo, si quisieras instalar W3 Total Cache, visitarías esta página:
Puedes ver que termina con w3-total-cache. Este es el nombre del plugin que deberías ingresar en los comandos a continuación.
| Acción | Comando |
|---|---|
|
Revisa los plugins instalados |
[server]$ wp plugin list |
|
Instala un plugin |
[server]$ wp plugin install PLUGIN_NAME |
| Activa un plugin |
[server]$ wp plugin activate PLUGIN_NAME |
|
Desactiva un plugin |
[server]$ wp plugin deactivate PLUGIN_NAME
[server]$ wp plugin toggle PLUGIN_NAME |
Temas
| Acción | Comando |
|---|---|
|
Revisa los temas instalados |
[server]$ wp theme list |
|
Instala un tema |
[server]$ wp theme install THEME_NAME |
|
Activa un tema diferente |
[server]$ wp theme activate THEME_NAME |
|
Actualiza un tema |
[server]$ wp theme update THEME_NAME |
Actualizar WordPress
| Acción | Comando |
|---|---|
| Revisa la versión de WordPress actual |
[server]$ wp core version |
| Revisa si hay actualizaciones de versión de WordPress |
[server]$ wp core check-update |
| Actualiza WordPress a una nueva versión |
[server]$ wp core update |
|
Fuerza la descarga de todos los archivos principales. Esto vuelve a descargar los archivos principales de WordPress y sobrescribe cualquier archivo principal que ya exista. |
[server]$ wp core download --force |
Crear usuarios
| Acción | Comando |
|---|---|
| Revisa la lista de todos los usuarios actuales |
[server]$ wp user list |
|
Crea un nuevo usuario mientras asignas su correo y rol. Se imprimirá una nueva contraseña en la terminal después de que el usuario sea creado. |
[server]$ wp user create newusername admin@example.com --role=administrator |
Cambiar una contraseña
| Acción | Comando |
|---|---|
| Corre wp user list3. Luego, deberás informar al usuario sobre el cambio de contraseña. |
[server]$ wp user update 3 --user_pass=NEW_PASSWORD |
Eliminar un usuario
| Acción | Comando |
|---|---|
| Corre wp user list` para obtener el número de ID del usuario que deseas eliminar y del usuario al que deseas reasignar sus publicaciones. Deberás reasignar las publicaciones a otro usuario para que no se eliminen permanentemente. Este ejemplo elimina a un usuario con un ID# de 13 y reasigna sus publicaciones al usuario 7. |
[server]$ wp user delete 13 --reassign=7 |
Comandos de solución de problemas
Caché
| Acción | Comando |
|---|---|
| Limpiar el caché del sitio |
[server]$ wp cache flush |
| Limpia el caché de wp-cli |
[server]$ wp cli cache clear |
Bases de datos
| Acción | Comando |
|---|---|
|
Revisa el estado de la base de datos |
[server]$ wp db check |
| Optimiza la base de datos |
[server]$ wp db optimize |
| Repara la base de datos |
[server]$ wp db repair |
| Busca texto en la base de datos. Esto busca la palabra hello. |
[server]$ wp db search hello |
| Actualiza la versión de la base de datos |
[server]$ wp core update-db |
Permalinks
| Acción | Comando |
|---|---|
| Limpia los permalinks. Esto es lo mismo que volver a guardarlas en el panel de control. |
[server]$ wp rewrite flush |
Cambios personalizados
Actualizar el home y siteurl
| Acción | Comando |
|---|---|
| Revisa el home y siteurl |
[server]$ wp option list | grep -E "^(siteurl|home)" |
| Actualiza la URL del home |
[server]$ wp option update home https://example.com |
| Actualiza el siteurl |
[server]$ wp option update siteurl https://example.com |
Importar y exportar un archivo WXR
Puedes usar los comandos import y export para gestionar los datos de tu sitio con un archivo WXR. Revisa este artículo para más detalles.
Buscar y reemplazar
Busca y reemplaza texto en tu base de datos. Asegúrate de usar la opción --dry-run la primera vez para ver qué cambios se realizarán.
[server]$ wp search-replace http://example.com https://example.com/blog --dry-run
Una lista de campos que serán actualizados se mostrará en tu terminal. Si deseas actualizar todos los resultados mostrados, ejecuta el comando nuevamente sin la opción --dry-run.
[server]$ wp search-replace http://example.com https://example.com/blog
wp-config.php
| Acción | Comando |
|---|---|
| Revisa todas las configuraciones del archivo wp-config.php |
[server]$ wp config list |
| Actualiza una configuración en tu archivo wp-config.php. Esto actualiza el valor de `DB_HOST`. |
[server]$ wp config set DB_HOST mysql.example.com |
Actualizar la versión de PHP que usa
- Para ver la versión actual de PHP y su ubicación, corre el siguiente comando:
[server]$ wp cli info
- Para cambiar la versión de PHP que utiliza wp-cli, agrega la siguiente línea a tu archivo .bash_profile. Cambia la versión según sea necesario. Este ejemplo usa PHP 8.2.
export WP_CLI_PHP=/usr/local/php82/bin/php wp
- Actualiza el .bash_profile:
[server]$ . ~/.bash_profile
- Revisa para confirmar que wp-cli está usando esta nueva versión.
[server]$ wp cli info PHP binary: /usr/local/php82/bin/php PHP version: 8.2
Ver también
- wp-cli.org – Official WP CLI website
- wp-cli commands
- Cómo iniciar sesión en tu sitio WordPress
- Visión general de WordPress