Generalidades sobre WordPress wp-cli

La Interfaz de Línea de Comando de WordPress (wp-cli) es una herramienta de línea de comando de WordPress instalada en todos los servidores de DreamHost. wp-cli te permite correr comandos de WordPress desde tu terminal Shell para administrar tu sitio WordPress sin tener que iniciar sesión en el panel de WordPress.

Necesitarás iniciar sesión en tu servidor vía SSH para usar wp-cli. Mira los siguientes artículos para ver información de como crear un usuario Shell e iniciar sesión en tu servidor.

• Crear un usuario con acceso Shell (SSH)
• Generalidades de SSH

Después de iniciar sesión en tu servidor, asegúrate de estar en el directorio del sitio web. Allí es donde corerrás los comandos de este artículo.

General

• Ver todos los comandos de wp-cli
• Usar la ayuda para ver información de los comandos
• Versiones de wp-cli

Comandos Principales

• Plugins
• Temas
• Actualizar WordPress
• Usuarios

Solución de Problemas

• Caché
• Bases de Datos
• Permalinks

Cambios Personalizados

• Actualizar home y siteurl
• Importar y exportar un archivo WXR
• Search and Replace
• wp-config.php
• Actualizar la versión PHP de los usuarios wp-cli

[server]$ wp

Una lista de comandos disponibles se muestra.

Para obtener más información sobre un comando en especifico, corre la opción --help.

[server]$ wp plugin --help

Esto imprime una lista de subcomandos disponibles. Por ejemplo:

SUBCOMANDOS
  
    activate              Activa uno o más complementos.
    deactivate            Desactiva uno o más complementos.
    delete                Elimina los archivos de los complementos sin desactivar o desinstalar.
    get                   Obtiene detalles sobre un complemento instalado.
    install               Instala uno o más complementos.
    is-active             Mira si el complemento dado está activo.
    is-installed          Mira si el complemento dado está instalado.
    list                  Obtiene una lista de complementos.
    path                  Obtiene el camino a un complemento o el directorio del complemento.
    search                Busca el directorio del complemento WordPress.org.
    status                Revela el estado de uno o todos los complementos.
    toggle                Alterna el estado de activación del complemento.
    uninstall             Desinstala uno o más complementos.
    update                Actualiza uno o más complementos.
    verify-checksums      Verifica los archivos del complemento contra la suma de comprobación de WordPress.org.  

Luego puedes agregar uno de estos subcomandos al comando principal para realizar una acción. Así es como instalarías un complemento llamado hello-dolly:

[server]$ wp plugin install hello-dolly
  Installing Hello Dolly (1.6)
  Downloading install package from https://downloads.wordpress.org/plugin/hello-dolly.1.6.zip...
  Unpacking the package...
  Installing the plugin...
  Plugin installed successfully.  

Crear usuarios

[server]$ wp user list

[server]$ wp user create newusername admin@example.com --role=administrator

Cambiar una contraseña

[server]$ wp user update 3 --user_pass=NEW_PASSWORD

Eliminar un usuario

[server]$ wp user delete 13 --reassign=7

Puedes usar los comandos import y export para administrar los datos de tu sitio con un archivo WXR. Mira el siguiente artículo para más detalles.

• Importar y exportar un archivo WXR

Busca y reemplaza texto en tu base de datos. Asegúrate de usar la banderilla --dry-run la primera vez para ver que va a cambiar.

[server]$ wp search-replace http://example.com https://example.com/blog --dry-run

Aparece una lista de campos que se actualizarán en tu terminal. Si deseas actualizar todos los resultados que se muestran, corre el comando nuevamente sin la banderilla --dry-run.

[server]$ wp search-replace http://example.com https://example.com/blog

1. Ve la versión actual de PHP y su ubicación corriendo el siguiente comando:

   [server]$ wp cli info
   OS:     Linux 3.14.52-vs2.3.6.15-1 #1 SMP Wed Nov 2 10:45:38 UTC 2016 x86_64
   Shell:  /bin/bash
   PHP binary:     /usr/bin/php
   PHP version:    7.4.14
   php.ini used:   /etc/php74/php.ini
   MySQL binary:   /usr/bin/mysql
   MySQL version:  mysql  Ver 15.1 Distrib 10.3.27-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2
   SQL modes:
   WP-CLI root dir:        /usr/local/wp
   WP-CLI vendor dir:      /usr/local/wp/vendor
   WP_CLI phar path:
   WP-CLI packages dir:
   WP-CLI global config:   /usr/local/wp/config.yml
   WP-CLI project config:
   WP-CLI version: 2.5.0-alpha

2. Para cambiar la versión que PHP wp-cli usa, agrega la siguiente línea a tu .bash_profile. Cambia la versión como necesites. Este ejemplo usa PHP 8.0.

   export WP_CLI_PHP=/usr/local/php80/bin/php wp

3. Actualiza el .bash_profile:

   [server]$ . ~/.bash_profile

4. Finalmente, selecciona para confirmar si wp-cli está usando ésta nueva versión.

   [server]$ wp cli info
   OS:     Linux 4.14.117-grsec-grsec+ #1 SMP Fri May 10 17:15:47 PDT 2019 x86_64
   Shell:  /bin/bash
   PHP binary:     /usr/local/php80/bin/php
   PHP version:    8.0.2
   php.ini used:   /etc/php80/php.ini
   MySQL binary:   /usr/bin/mysql
   MySQL version:  mysql  Ver 14.14 Distrib 5.7.33, for Linux (x86_64) using  EditLine wrapper
   SQL modes:
   WP-CLI root dir:        /usr/local/wp
   WP-CLI vendor dir:      /usr/local/wp/vendor
   WP_CLI phar path:
   WP-CLI packages dir:
   WP-CLI global config:   /usr/local/wp/config.yml
   WP-CLI project config:
   WP-CLI version: 2.5.0-alpha