Como gerenciar o WordPress a partir da linha de comando com WP-CLI

No início deste mês, compartilhei um post sobre como instalar, configurar e usar o Docker no desenvolvimento local do WordPress. A principal vantagem do Docker eram seus contêineres: cada instalação do WordPress era encapsulada e isolada das demais. Esses contêineres foram iniciados usando um arquivo de configuração e um comando simples: docker-compose up -d .

A primeira vez que você iniciou um contêiner do Docker com o WordPress, você teve que passar pelo processo de instalação do WordPress:

Depois de escrever esse post, achei ótimo complementá-lo com outra ferramenta que nos ajude a gerenciar as instalações do WordPress a partir da própria linha de comando. Bem, não espere mais! Hoje vou ensinar como usar o WP-CLI para gerenciar instalações do WordPress a partir do console.

O que é WP-CLI?

A linha de comando é a melhor amiga de todo desenvolvedor. WP-CLI (WordPress Command Line Interface) traz o gerenciamento e manutenção do WordPress para nossa linha de comando e é um componente indispensável para qualquer desenvolvedor que queira otimizar seriamente seu tempo. Com o WP-CLI, você poderá atualizar plugins, configurar instalações em vários sites e muitas outras coisas sem precisar usar um navegador da web.

Instalando o WP-CLI

A documentação do projeto explica como instalar o WP-CLI. Existem muitas opções para fazer isso, mas a mais fácil é baixar o arquivo executável diretamente:

e inicie-o usando PHP:

Se quisermos usar o comando de uma forma mais “amigável”, podemos dar permissão de execução e movê-lo para algum diretório que esteja em nosso $PATH :

e a partir de então podemos executar o comando da seguinte forma:

A propósito, lembre-se de executar wp no diretório raiz do WordPress:

WP-CLI e Docker

Suponha que você esteja interessado em usar o WP-CLI para gerenciar os diferentes projetos com os quais trabalha. Se você seguiu meu guia algumas semanas atrás, provavelmente está usando o Docker agora. Então a pergunta é: como você pode usar o WP-CLI e o Docker juntos? É possível executar o WP-CLI em seus contêineres do WordPress Docker?

Idealmente, a imagem do WordPress que usamos no Docker deve incluir WP-CLI. Infelizmente, no momento em que escrevo este post, a imagem oficial não inclui o WP-CLI (e adicioná-lo pode ser complicado). Mas não se preocupe! Existem outras imagens que podemos usar que incluem o WP-CLI pronto para uso. Em vez de usar isso:

use a seguinte imagem:

E é isso! A execução docker-compose up -d fará o download de uma nova imagem do WordPress que inclui o binário WP-CLI.

O único problema que temos agora é que o WP-CLI está dentro do container (ou seja, a “máquina convidada”) e estamos usando nosso terminal na “máquina host”. Como podemos acessá-lo?

Para executar um comando convidado do nosso host, devemos usar docker-compose da seguinte forma:

Por exemplo, suponha que eu esteja trabalhando em nosso plugin Nelio Content, que tenho em um diretório chamado nelio-content . No arquivo docker-compose.yml que criei para este projeto defini dois serviços: um para WordPress (que chamei de wordpress ) e outro para o banco de dados MySQL ( mysql ). Bem, como o WP-CLI está no contêiner do WordPress, é assim que o executamos:

Por fim, se você quiser usar uma versão mais amigável, crie o seguinte alias:

e você poderá executar o comando usando apenas duas letras simples:

Comandos WP-CLI

Agora que temos o WP-CLI instalado e sabemos como invocá-lo, é hora de ver alguns exemplos do que ele nos permite fazer.

Como são os comandos WP-CLI

Em geral, os comandos WP-CLI seguem o seguinte padrão:

Na documentação você tem informações sobre todos os comandos disponíveis, seus parâmetros e como usá-los. Não se esqueça de tê-lo à mão para consultá-lo quando precisar.

Gerenciamento do WordPress

Instalando o WordPress…

Conforme avancei na introdução, a primeira coisa que você precisa fazer ao iniciar um novo contêiner do Docker com o WordPress é concluir o processo de instalação do WordPress. Com o WP-CLI, isso é tão fácil quanto executar o seguinte comando:

Atualizando o WordPress…

Se você deseja atualizar para a versão mais recente do WordPress, basta executar isto:

E se quisermos voltar para uma versão mais antiga, podemos fazê-lo com o seguinte comando:

Gerenciamento de plug-ins

Outra tarefa comum que enfrentamos ao trabalhar com o WordPress é o gerenciamento de plugins. Por exemplo, logo após iniciarmos uma nova imagem do Docker com o WordPress, veremos que essa imagem inclui vários plug-ins nos quais podemos não estar interessados. Como sabemos quais plug-ins estão instalados? Como nos livramos deles? Como ativamos o(s) que queremos?

Listando plugins instalados…

Se você quiser ver os plugins instalados em seu site, execute o subcomando list do comando plugin :

No meu caso, isso retorna:

Excluindo plug-ins…

Para excluir plugins que você não deseja mais, basta chamar wp plugin delete e especificar os plugins que deseja excluir:

Ativando plug-ins…

E para ativar um plugin, repita o processo, mas use o subcomando activate :

Instalando plug-ins…

Para instalar um novo plugin, execute o seguinte:

e o WordPress baixará o plug-in do diretório de plug-ins no WordPress.org e o ativará automaticamente. Fácil, não é?

Gerenciamento de temas

O gerenciamento de temas é muito semelhante ao gerenciamento de plugins: podemos listar os temas instalados, alternar os ativos, excluí-los, etc. Por exemplo, para listar os temas disponíveis temos o seguinte comando:

o que nos dá o seguinte resultado:

Neste exemplo, o tema atualmente ativo é twentyseventeen . Como você mudaria para vinte e dezenove ? É superfácil:

E se quisermos atualizar todos os temas que possuem atualizações disponíveis? É super fácil também:

Quão legal é isso? ?

E agora?

Esta foi uma breve introdução ao uso do WP-CLI. Se você quiser se aprofundar nas possibilidades que oferece, no WordPress.org você encontrará toda a documentação sobre esta ferramenta: como instalá-la, como configurá-la e como usá-la. Eu recomendo que você leia a documentação completamente e continue descobrindo o potencial do WP-CLI por conta própria.

Imagem em destaque por Hannah Joshua no Unsplash.