WP-CLI

Última actualización 11 de septiembre de 2024

WP-CLI (WordPress Command Line Interface) es una potente herramienta para gestionar una instalación de WordPress directamente desde la línea de comandos o el terminal. En lugar de utilizar el panel de control estándar de WordPress, puedes ejecutar comandos para realizar tareas como actualizar plugins, gestionar temas y configurar ajustes, todo desde tu terminal.

Utilizar WP-CLI tiene una serie de ventajas, entre ellas:

Rapidez: Realizar tareas utilizando la línea de comandos suele ser más rápido que navegar por la interfaz de administración de WordPress, especialmente para tareas repetitivas.
Automatización: WP-CLI puede integrarse en scripts para automatizar flujos de trabajo.
Gestión remota: WP-CLI te permite gestionar sitios de WordPress de forma remota.
Flexibilidad: La capacidad de ejecutar comandos y scripts proporciona un mayor control y personalización.

Acceso a WP-CLI en Kinsta

WP-CLI v2 está instalado por defecto en todos nuestros servidores. Para acceder a WP-CLI, debes conectarte a tu servidor con SSH y navegar a la raíz de documentos de tu sitio. Kinsta proporciona acceso SSH con todos nuestros planes de Alojamiento Administrado de WordPress.

1. Conéctate a tu servidor con SSH

El método más sencillo para conectarse mediante SSH es utilizar un nombre de usuario y una contraseña. Los pasos para conectarse varían en función de tu sistema operativo.

Windows

Los usuarios de Windows necesitan un cliente de terminal para conectarse con SSH. Recomendamos descargar el cliente gratuito PuTTY utilizando el instalador .msi.

Inicia PuTTY e introduce la Dirección IP de tu Host y el número de Puerto único (ambos se encuentran en MyKinsta > Sitios > nombre del sitio > Información > SFTP/SSH). A continuación, haz clic en Abrir.
Si es la primera vez que te conectas, lo más probable es que veas una solicitud de clave rsa2. Haz clic en Sí, y así confiarás en el host en el futuro.
En la pantalla del terminal, introduce tu nombre de usuario de Kinsta (que se encuentra en MyKinsta > Sitios > nombre del sitio > Info > SFTP/SSH) y pulsa Intro.
Introduce tu contraseña Kinsta (que se encuentra en MyKinsta > Sitios > nombre del sitio > Info > SFTP/SSH) y vuelve a pulsar Intro.

Ya estás conectado vía SSH a tu sitio de WordPress.

Mac/Linux

Abre un nuevo terminal desde Aplicaciones > Utilidades > Terminal.
En MyKinsta, navega a Sitios > nombre del sitio > Info > SFTP/SSH, y en el comando de terminal SSH haz clic en Copiar al portapapeles.
Pega el comando de terminal SSH en el terminal y pulsa Intro.
Introduce tu contraseña de Kinsta (que se encuentra en MyKinsta > Sitios > nombre del sitio > Info > SFTP/SSH) y vuelve a pulsar Intro.

Ahora estás conectado vía SSH a tu sitio de WordPress.

2. Navega a la raíz del documento de tu sitio

Para ejecutar comandos WP-CLI, primero debes navegar a la raíz de documentos de tu sitio; aquí es donde se encuentran tus archivos de WordPress (como wp-config.php, wp-content, wp-admin, y wp-includes). Para navegar a la raíz de documentos de tu sitio en Kinsta, introduce el siguiente comando:

cd public

Ahora puedes utilizar comandos WP-CLI en tu instalación de WordPress alojada en Kinsta. Para obtener una lista completa de los comandos WP-CLI disponibles, consulta la documentación para desarrolladores de WordPress.

Comandos WP-CLI útiles

La siguiente es una lista de comandos WP-CLI que pueden resultarte útiles. Para obtener una lista completa de los comandos WP-CLI disponibles, incluidos los parámetros y opciones globales, consulta la documentación para desarrolladores de WordPress.

Opciones útiles

La siguiente es una lista de opciones útiles que puedes añadir al final de tus comandos:

--skip-themes: Esto impide que se carguen los temas de WordPress cuando ejecutas un comando WP-CLI. Esto es útil si hay un problema en uno de los temas que causa conflictos con los comandos WP-CLI.
--skip-plugins: Evita que se carguen los plugins de WordPress cuando ejecutes un comando WP-CLI. Esto es útil si hay un problema en uno de los plugins que causa conflictos con los comandos WP-CLI.
--all: Esto aplica un comando a todos los elementos relevantes. Por ejemplo, si quieres actualizar todos los plugins o usuarios.
--dry-run: Se puede utilizar para simular la ejecución de un comando sin realizar ningún cambio real. Te muestra lo que ocurriría si se ejecutara el comando, pero no realizará ninguna de las acciones. Por ejemplo, si ejecutas un buscar y reemplazar, actualizas todos los plugins o eliminas entradas en lote.
--format=<format>: Especifica el formato de salida al exportar datos. Por ejemplo, cuando ejecutes wp plugin list o wp user list puede que quieras que salga en formato table, json o csv.

Plugins

Ver una lista de plugins

Visualiza una lista de los plugins instalados con el siguiente comando:

wp plugin list

Activar un plugin

Para activar un plugin, utiliza el siguiente comando, sustituyendo $plugin por el nombre del plugin en wp plugin list.

wp plugin activate $plugin

Desactivar un plugin

Para desactivar un plugin, utiliza el siguiente comando, sustituyendo $plugin por el nombre del plugin en wp plugin list.

wp plugin deactivate $plugin

Actualizar un plugin específico

Para actualizar un plugin, utiliza el siguiente comando, sustituyendo $plugin por el nombre del plugin en wp plugin list.

wp plugin update $plugin

Actualizar todos los plugins

wp plugin update --all

Revertir un plugin

Si actualizas un plugin que rompe algo en tu sitio, puedes revertirlo instalando una versión específica con el siguiente comando, sustituyendo $plugin por el nombre del plugin de wp plugin list y $version por el número de versión requerido.

wp plugin update $plugin --version=$version

URLs

Establecer la URL de inicio

Para establecer la URL de tu página de inicio, utiliza el siguiente comando, sustituyendo $URL por la URL requerida.

wp option update home '$URL'

Establecer la URL del sitio

Para establecer la URL del sitio, utiliza el siguiente comando, sustituyendo $URL por la URL deseada.

wp option update siteurl '$URL'

Usuarios

Listar todos los usuarios de WordPress

Visualiza una lista de todos los usuarios de WordPress con el siguiente comando:

wp user list

Crear un nuevo usuario

Para crear un nuevo usuario, utiliza el siguiente comando, sustituyendo $username y $emailaddress por las credenciales del usuario, y $role por el rol que quieras asignar al nuevo usuario, por ejemplo, administrador.

wp user create $username $emailaddress -–role=$role

Restablecer la contraseña de un usuario

Para restablecer la contraseña de un usuario, utiliza el siguiente comando, sustituyendo $username por el nombre de usuario requerido en wp user list.

wp user reset-password $username

Actualizar los datos de un usuario

Para actualizar un usuario, utiliza el siguiente comando, sustituyendo $user por el nombre de usuario requerido en wp user list, $field por el campo que quieras actualizar y $value por los nuevos datos que quieras introducir.

wp user update $user -—$field=$value

Caché

Para utilizar los comandos de borrar caché que se indican a continuación, el plugin Kinsta Must Use (MU) debe estar instalado en el sitio.

Borrar todo el caché

Para borrar todo el caché, incluyendo el caché del sitio, el caché edge, el caché CDN y el caché Redis, utiliza el siguiente comando:

wp kinsta cache purge --all

Borrar el caché de página completa y el caché edge

Para borrar el caché de página completa y el caché edge, utiliza el siguiente comando:

wp kinsta cache purge

Borrar caché de sitio sin borrar caché edge

Para borrar sólo el caché del sitio, utiliza el comando siguiente:

wp kinsta cache purge --site

Borrar el caché CDN

Para borrar sólo el caché CDN, utiliza el siguiente comando:

wp kinsta cache purge --cdn

Borrar caché Redis

Para borrar sólo el caché de Redis, utiliza el siguiente comando:

wp kinsta cache purge --object

Vaciar caché de objetos

Vacía el caché de objetos de tu sitio con el siguiente comando:

wp cache flush

Esto puede provocar un ligero aumento temporal de los tiempos de carga mientras se reconstruye el caché.

Buscar y reemplazar

Cuando ejecutes cualquier buscar y reemplazar en tu sitio de WordPress, te recomendamos que hagas una copia de seguridad y utilices la opción --dry-run para ver qué se va a reemplazar antes de ejecutar el comando.

Sustituir dominio antiguo por dominio nuevo

Para sustituir una URL antigua por una nueva, utiliza el siguiente comando, sustituyendo $old-domain por la URL que quieres sustituir y $new-domain por la URL con la que quieres reemplazarla:

wp search-replace '$old-domain' '$new-domain' --skip-columns=guid

--skip-columns=guid se recomienda para evitar alterar accidentalmente las URL almacenadas como identificadores únicos en la columna guid de la base de datos, lo que podría romper las URL de las entradas. Este comando también se puede utilizar para sustituir dominios de direcciones de correo electrónico.

Sustituir HTTP por HTTPS

Para actualizar tus URL de HTTP a HTTPS, utiliza el siguiente comando:

wp search-replace 'http://' 'https://' --skip-columns=guid

--skip-columns=guid se recomienda para evitar alterar accidentalmente las URL almacenadas como identificadores únicos en la columna guid de la base de datos, lo que podría provocar problemas con los archivos adjuntos multimedia.

Solución de problemas

Si tienes problemas al ejecutar comandos en WP-CLI, puede deberse a que un tema o plugin experimente un error fatal. Puedes añadir lo siguiente a tu comando WP-CLI para omitir la carga de temas y plugins:

--skip-themes --skip-plugins

Por ejemplo, para obtener una lista de usuarios y omitir los temas y plugins, puedes ejecutar lo siguiente:

wp user list --skip-themes --skip-plugins

Si quieres omitir plugins específicos, puedes utilizar lo siguiente, sustituyendo $plugin por el nombre del plugin y utilizando una coma para separar cada plugin:

--skip-plugins=$plugin,$plugin

Por ejemplo:

wp user list --skip-plugins=wordpress-seo,wordfence