WP-CLI

Buscar y reemplazar en la base de datos

Es una práctica habitual crear una web en un servidor local o de desarrollo una práctica y luego moverlo a otro servidor al terminar. La parte de copiar los archivos y migrar la base de datos son pasos relativamente sencillos. Ahora bien, la parte tediosa es que suelen quedar “restos” en este proceso, como el tener que reemplazar las URLs antiguas (de la instalación local o de desarrollo) almacenadas en los registros de la base de datos. Solemos solucionar este problema mediante plugins o consultas SQL, pero en ocasiones hay URLs en los datos internos en serie de la base de datos en los que una búsqueda y reemplazo normal no funcionarán.

WP-CLI, de nuevo, puede ayudarnos en esta tarea. Tenemos el comando search-replace para reemplazar la vieja URL con la nueva en todas las cadenas de la base de datos, incluidas aquellas que tengan datos internos en serie.

wp search-replace ‘dev.tusitio.com’ ‘www.sitio-cliente.com’

Operaciones en WordPress Multisite

Crear un script para para instalar un plugin Importador de WordPress en un sitio concreto:

 #!/bin/bash
for site in $(wp site list –field=url)
do
wp plugin install wordpress-importer –url=$site –activate
done

Ejecutar comandos de manera sencilla

Conectarse a un servidor y navegar hasta la ruta correcta para ejecutar comandos WP-CLI puede ser algo tedioso. En su lugar puedes usar WP-CLI SSH, un paquete adicional que te permite ejecutar comandos WP-CLI desde tu terminal local, si tener que conectarte al servidor remoto.

Antes de instalar WP-CLI SSH tienes que especificar la ubicación del paquete índice de WP-CLI en la carpeta ~/.wp-cli. (Si no existe crea este directorio.)

cd ~/.wp-cli

También hay que instalar el Composer si no lo has hecho anteriormente

curl -sS ‘https://getcomposer.org/installer’ | php

A continuación crea (o usa si ya existe) el archivo composer.json

php composer.phar init –stability dev –no-interaction
php composer.phar config bin-dir bin
php composer.phar config vendor-dir vendor

Añade el paquete índice de WP-CLI

php composer.phar config repositories.wp-cli composer ‘http://wp-cli.org/package-index/’

Luego crea (o usa si ya existe) el archivo config.yml, y añádele estas líneas

require:
– vendor/autoload.php

Con esto ya estaría todo listo para instalar el paquete WP-CLI SSH

php composer.phar require x-team/wp-cli-ssh:dev-master

Lo siguiente es crear el archivo de configuración y configurar los servidores. Crea un archivo wp-cli.yml y añádele los siguientes ajustes

ssh:

production:
# El localizador %pseudotty% se reemplaza con -t o -T dependiendo de si estás canalizando la salida o no
# El localizador %cmd% se reemplaza con el comando originalmente lanzado por WP-CLI
cmd: ssh %pseudotty% production.example.com %cmd%

# Pasamos WP-CLI al servidor remoto mediante el comando –url
url: produccion.ejemplo.com

# Cambiamos (cd) a esta ruta del servidor remoto antes de ejecutar WP-CLI
path: /var/www/produccion

# WP-CLI en SSH parará si tecleas alguno de estos comandos:
– db drop
– db reset

En este ejemplo anterior, por supuesto, reemplaza produccion.ejemplo.com por la URL de tu servidor y /var/www/produccion por la ruta a tu instalación de WordPress. En la sección disabled commands puedes definir comandos WP-CLI no permitidos en el servidor remoto. Puedes crear tantos servidores como quieras, usando nombres diferentes para cada uno.

Si todo se ha configurado correctamente ya podrás ejecutar comandos utilizando el subcomando ssh y añadiendo el argumento del servidor

wp ssh plugin status –host=produccion

Si estuvieses trabajando principalmente en el servidor remoto también tienes la opción de crear un alias en tu archivo ~/.bash_profile ,para que el comando wp use ese servidor por defecto

alias wp=”wp ssh –host=produccion”

Usos avanzados de WP-Cli

Puedes extender la funcionalidad base de WP-CLI usando tus códigos. Hay dos maneras de hacerlo. Puedes cargar y ejecutar código PHP desde un archivo o crear tu propio plugin que genere comandos personalizados.

Ejecutar un archivo PHP

Si quieres probar un código PHP no necesitas incluirlo en un archivo de WordPress. WP-CLI dispone del comando eval-file que ejecuta comandos PHP que se hayan cargado previamente en WordPress. Por ejemplo, si quieres imprimir el título de una entrada WordPress aleatoria el código para esta acción sería algo así

global $wpdb;
$random_post = $wpdb->get_var(
“SELECT post_title
FROM $wpdb->posts
WHERE post_type = ‘post’
AND post_status = ‘publish’
ORDER BY rand()
LIMIT 1″
);
echo “Random post: $random_post”;

Lo guardas en un archivo llamado script.php y compruebas la respuesta tecleando este comando

wp eval-file ./script.php

Comandos disponibles