Administrar WordPress con WP-CLI

,
Administar WordPress con WP-CLI

Administrar WordPress cuando tienes varios sitios puede ser complicado si no cuentas con las herramientas necesarioas. Hoy te queremos mostrar WP-CLI, la herramienta de la línea de comandos para WordPress; con la que puedes actualizar plugins, configurar instalaciones multisitio, agregar/eliminar usuarios, posts, categorías, insertar datos de ejemplos, buscar y reemplazar en la base de datos, y mucho más, sin necesidad de usar el navegador web. Además te ayuda en las tareas de automatización ya que puedes comprobar si existen actualizaciones disponibles para tus plugins y en caso de existir, actualizarlos.

Este este tutorial aprenderemos cómo instalar WP-CLI, habilitar el autocompletamiento de comandos y administrar WordPress mediante tareas frecuentes de mantenimiento.

Requerimientos

Antes de instalar WP-CLI, tu entorno debe cumplir los siguientes requerimientos mínimos:

  • Entorno UNIX (OS X, Linux, FreeBSD, Cygwin). El soporte en entornos Windows es limitado.
  • PHP 5.3.29 o superior.
  • WordPress 3.7  o superior. Otras versiones anteriores pueden tener funcionalidades degradas.

Instalando WP-CLI

Existen varios métodos de instalación de esta herramienta de línea de comandos, pero el método recomendado para la mayoría de los usuarios es descargando el archivo Phar. Una vez que hemos verificados que cumplimos los requerimientos, procedemos a descargarlo.

Mediante curl:

O mediante wget:

Para comprobar si el archivo Phar funciona correctamente puedes ejecutar el siguiente comando:

Lo cual devuelve algo como (en el ejemplo tenemos un «Microsoft» porque lo estoy ejecutando en el Bash de Ubuntu para Windows 10 🙂 ):

A continuación configuraremos WP-CLI para ejecutarlo con solo escribir wp y a la vez sea accesible desde cualquier parte del sistema, para ello es necesario asignarle permisos de ejecución al archivo wp-cli.phar y moverlo hacia el directorio /usr/local/bin/ con el nombre wp:

Entornos WHM/cPanel

En WHN/cPanel si usas FastCGI, al ejecutar el comando anterior, puedes recibir un error como el siguiente:

Esto se debe a que no usas un verdadero CLI de PHP, lo cual puedes comprobar mediante:

En cambio si ejecutas ese mismo comando desde una instalación de PHP que no use FastCGI, te devuelve:

Observa como la primera línea indica la presencia de FastCGI (cgi-fcgi) o no (cli). Por tanto es necesario ejecutar el archivo Phar con el comando php-cli:

Para acceder a la herramienta WP-CLI mediante el comando wp y desde cualquier parte del sistema, crearemos un alias en el archivo /root/.bashrc:

Si deseas ejecutar WP-CLI siempre desde el usuario root, puedes agregar la siguiente opción «–allow-root» quedando:

Debes tener presente que cada operación que se realice de escritura (actualizar/instalar plugins, etc) será bajo el usuario root, por lo que debes de ajustar los permisos luego. El comando find te puede ayudar a automatizar esta parte. Finalmente debemos cargar (sourced) el nuevo archivo .bashrc en nuestro sesión:

Si estamos desde el usuario root no es recomendable ejecutar WP-CLI, aun así es posible hacerlo agregando la opción –allow-root. Lo recomendado es ejecutarlo a través del usuario donde está el sitio WordPress que queremos administar:

La misma operación anterior pero con el comando su:

NOTA: Si el usuario por el que desea ejecutar WP-CLI no tiene bash activo los comandos anteriores no podrán ejecutarse.

A partir de aquí estamos listos para administrar WordPress desde la línea de comandos con WP-CLI.

Actualizando WP-CLI

Puedes actualizarlo repitiendo los pasos de instalación o simplemente ejecutando el siguiente comando:

Puedes instalar las actualizaciones nightly de WP-CLI, para ello ejecuta:

Las actualizaciones nightly son más o menos estables, por lo son útiles pare entornos de desarrollo donde siempre quieres tener las últimas características de la herramienta, pero descuidando la estabilidad.

Autocompletamiento de comandos

WP-CLI ofrece un autocompletamiento de comandos al presionar la tecla TAB. Para ello debes de cargar en el archivo ~/.bash_profile el siguiente script para Bash: wp-completion.bash

Agregamos el archivo wp-completation.bash a ~/.bash_profile:

Finalmente cargamos el nuevo archivo en la sesión actual:

Cómo ejectuar WP-CLI

WP-CLI debe ser ejecutado en el directorio donde tienes instalado WordPress o especificando el camino de la instalación de WordPress que quieres administrar, por ejemplo:

En el ejemplo anterior se han listado todos los plugins instalados en el directorio /home/misitio/public_html en cual contiene una instalación de WordPress.

Puedes obtener información sobre todos los comandos relacionados con plugins:

Incluso puedes obtener la ayuda de los subcomandos disponibles:

Administrar WordPress desde la línea de comandos

A continuación les mostraré algunos comandos útiles de WP-CLI que te permitirán administar WordPress. Cada una de las tareas mostradas a continuación están enfocadas a tareas de manteniemiento como actualización de plugins, temas, núcleo de WordPress, reinstalación del núcleo de WordPress, etc.

Actualizando Plugins de WordPress

Mantener tus plugins actualizados es importante, ya que puede traer nuevas características o simplemente mejorar funciones antiguas con nuevas correcciones de código. Hay varias formas de hacerlo: primero, puede actualizar todos sus complementos a la vez con un simple comando:

En caso que necesites actualizar un plugin en específico, para ello listas primeramente los plugins que tienes instalados:

Luego puedes actualizar un plugin que necesites de la siguiente forma:

Actualizando Temas de WordPress

Al igual que los plugins es importante mantener actualizado el tema activo. Siempre y cuando tu tema se encuentre en el repositorio oficial de WordPress podrás actualizarlo con WP-CLI:

Los temas instalados los listas con el siguiente comando:

Puedes actualizar todos los temas instalados con un solo comando:

Actualizando el Núcleo de WordPress

Mantener el núcleo de WordPress actualizado es importante para la seguridad y la compatibilidad con los últimos temas y plugins. Para actualizar los archivos y la base de datos de tu sitio de WordPress ejecuta:

El primer comando actualiza todos sus archivos, y el segundo ejecuta las actualizaciones necesarias en la base de datos.

Reinstalando el Núcleo de WordPress

Para reinstalar el núcleo de WordPress sin los temas predeterminados y plugins, puedes ejecutar:

Eliminando los Transitorios (transients)

La API de transients permite a los desarrolladores almacenar información en tu base de datos de WordPress con un tiempo de vencimiento. Esta ayuda en la carga del sitio y mantiene tu servidor con bajo consumo de recursos. En ocasiones se hace necesario limpiar los transients. Con WP-CLI puedes hacerlo ejecutando:

Punto Final

Espero que hayas aprendido una nueva forma de administrar WordPress desde la línea de comandos con WP-CLI. Para una mayor introducción a WP-CLI, te recomiendo la guía de inicio rápido. Además, en el siguiente enlace puedes aprender más sobre algunos comandos útiles. No te pierdas la lista de comandos, si deseas conocer en profundidad los comandos disponibles y opciones.

0 comentarios

Dejar un comentario

¿Quieres unirte a la conversación?
Siéntete libre de contribuir

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *