WP-CLI

O WP-CLI (WordPress Command Line Interface) é uma ferramenta avançada para gerenciar uma instalação de WordPress diretamente da linha de comando ou do terminal. Em vez de usar o painel padrão do WordPress, você pode executar comandos para realizar tarefas como atualizar plugins, gerenciar temas e definir configurações, tudo a partir do seu terminal.

Há vários benefícios em usar o WP-CLI, incluindo:

• Velocidade: A execução de tarefas usando a linha de comando geralmente é mais rápida do que navegar pela interface de administração do WordPress, especialmente para tarefas repetitivas.
• Automação: O WP-CLI pode ser integrado a scripts para fluxos de trabalho automatizados.
• Gerenciamento remoto: O WP-CLI permite que você gerencie sites WordPress remotamente.
• Flexibilidade: A capacidade de executar comandos e scripts oferece um nível de controle e personalização.

Acesse o WP-CLI na Kinsta

O WP-CLI v2 é instalado por padrão em todos os nossos servidores. Para acessar o WP-CLI, você deve conectar-se ao seu servidor com SSH e navegar até a raiz do documento do seu site. A Kinsta fornece acesso SSH com todos os nossos planos de Hospedagem Gerenciada de WordPress.

1. Conecte-se ao seu servidor com SSH

O método mais fácil de se conectar via SSH é usar um nome de usuário e senha. As etapas para se conectar variam de acordo com seu sistema operacional.

Windows

Os usuários do Windows precisam de um cliente de terminal para se conectar ao SSH. Recomendamos que você faça o download do cliente PuTTY gratuito usando o instalador .msi.

1. Inicie o PuTTY e digite seu Endereço IP do Provedor e o número exclusivo da Porta (ambos encontrados em MyKinsta > Sites > nome do site > Informações > SFTP/SSH). Em seguida, clique em Abrir.
2. Se esta for a primeira vez que você se conecta, provavelmente verá um prompt de chave rsa2. Clique em Sim para manter a confiança futura no provedor.
3. Na tela do terminal, digite seu nome de usuário Kinsta (encontrado no MyKinsta > Sites > nome do site > Informações > SFTP/SSH) e pressione Enter.
4. Digite sua senha Kinsta (encontrada no MyKinsta > Sites > nome do site > Info > SFTP/SSH) e pressione Enter novamente.

Agora você está conectado via SSH ao seu site WordPress.

Mac/Linux

1. Abra um novo terminal em Aplicativos > Utilitários > Terminal.
2. No MyKinsta, navegue até Sites > nome do site > Informações > SFTP/SSH e, no Comando do terminal SSH, clique em Copiar para a área de transferência.
3. Cole o Comando do terminal SSH no terminal e pressione Enter.
4. Digite sua senha Kinsta (encontrada no MyKinsta > Sites > nome do site > Informações > SFTP/SSH) e pressione Enter novamente.

Agora você está conectado via SSH ao seu site WordPress.

2. Navegue até a raiz do documento do site

Para executar comandos WP-CLI, você deve primeiro navegar até a raiz do documento do seu site; é aqui que os arquivos WordPress (como wp-config.php, wp-content, wp-admin e wp-includes) estão localizados. Para navegar até a raiz do documento do seu site na Kinsta, digite o seguinte comando:

cd public

Agora você pode usar os comandos WP-CLI em sua instalação WordPress hospedada na Kinsta. Para obter uma lista completa dos comandos WP-CLI disponíveis, consulte a documentação do desenvolvedor do WordPress.

Comandos úteis do WP-CLI

A seguir, uma lista de comandos WP-CLI que você pode achar úteis. Para obter uma lista completa dos comandos WP-CLI disponíveis, incluindo parâmetros e opções globais, consulte a documentação do desenvolvedor do WordPress.

Opções úteis

Veja a seguir uma lista de opções úteis que você pode adicionar ao final dos seus comandos:

• --skip-themes: Impede que os temas WordPress sejam carregados quando você executa um comando WP-CLI. Isso é útil se houver um problema em um dos temas que cause conflitos com os comandos WP-CLI.
• --skip-plugins: Impede que os plugins do WordPress sejam carregados quando você executa um comando WP-CLI. Isso é útil se houver um problema em um dos plugins que cause conflitos com os comandos WP-CLI.
• --all: Aplica um comando a todos os itens relevantes. Por exemplo, se você quiser atualizar todos os plugins ou usuários.
• --dry-run: Pode ser usado para simular a execução de um comando sem fazer nenhuma alteração real. Ele mostra a você o que aconteceria se o comando fosse executado, mas não realizará nenhuma das ações. Por exemplo, se você executar uma pesquisa e substituição, atualizar todos os plugins ou excluir artigos em massa.
• --format=<format>: Especifica o formato de saída quando você exporta dados. Por exemplo, quando você executa wp plugin list ou wp user list, pode querer o formato table, json ou csv.

Plugins

Veja uma lista de plugins

Você pode exibir uma lista dos plugins instalados com o seguinte comando:

wp plugin list

Habilite um plugin

Para habilitar um plugin, use o seguinte comando, substituindo $plugin pelo nome do plugin em wp plugin list.

wp plugin activate $plugin

Desabilite um plugin

Para desabilitar um plugin, use o seguinte comando, substituindo $plugin pelo nome do plugin em wp plugin list.

wp plugin deactivate $plugin

Atualize um plugin específico

Para atualizar um plugin, use o seguinte comando, substituindo $plugin pelo nome do plugin em wp plugin list.

wp plugin update $plugin

Atualize todos os plugins

wp plugin update --all

Reverta um plugin

Se você atualizar um plugin e isso causar algum dano ao seu site, poderá revertê-lo instalando uma versão específica usando o seguinte comando, substituindo $plugin pelo nome do plugin em wp plugin list e $versionpelo número da versão desejada.

wp plugin update $plugin --version=$version

URLs

Defina a URL da página inicial

Para definir a URL da sua página inicial, use o seguinte comando, substituindo $URL pela URL desejada.

wp option update home '$URL'

Defina a URL do site

Para definir a URL do site, use o comando a seguir, substituindo $URL pela URL desejada.

wp option update siteurl '$URL'

Usuários

Liste todos os usuários do WordPress

Veja uma lista de todos os usuários do WordPress com o seguinte comando:

wp user list

Crie um novo usuário

Para criar um novo usuário, use o seguinte comando, substituindo $username e $emailaddress pelas credenciais do usuário e $role pela função que você deseja atribuir ao novo usuário, como administrador, por exemplo.

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

Redefina a senha de um usuário

Para redefinir a senha de um usuário, use o seguinte comando, substituindo $username pelo nome de usuário desejado em wp user list.

wp user reset-password $username

Atualize os detalhes de um usuário

Para atualizar um usuário, use o seguinte comando, substituindo $user pelo nome de usuário desejado em wp user list, $field pelo campo que você deseja atualizar e $value pelos novos dados que deseja inserir.

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

Cache

Para usar os comandos de limpeza de cache listados abaixo, o plugin Kinsta Must Use (MU) deve estar instalado no site.

Limpe todo o cache

Para limpar todo o cache, incluindo o cache do site, o edge caching, o cache do CDN e o cache Redis, use o seguinte comando:

wp kinsta cache purge --all

Limpe o cache de página inteira e o edge caching

Para limpar o cache de página inteira e o edge caching, use o seguinte comando:

wp kinsta cache purge

Limpe o cache do site sem limpar o edge caching

Para limpar apenas o cache do site, use o seguinte comando:

wp kinsta cache purge --site

Limpe o cache do CDN

Para limpar apenas o cache do CDN, use o seguinte comando:

wp kinsta cache purge --cdn

Limpe o cache Redis

Para limpar apenas o cache Redis, use o seguinte comando:

wp kinsta cache purge --object

Limpe o cache de objetos

Limpe o cache de objetos do seu site com o seguinte comando:

wp cache flush

Isso pode levar a um pequeno aumento temporário nos tempos de carregamento à medida que o cache é reconstruído.

Pesquisa e substituição

Ao executar qualquer pesquisa e substituição em seu site WordPress, recomendamos fazer o backup e usar a opção --dry-run para ver o que será substituído antes de executar o comando.

Substitua o domínio antigo pelo novo

Para substituir uma URL antiga por uma nova, use o seguinte comando, substituindo $old-domain pela URL que você deseja trocar e $new-domain pela URL nova:

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

Recomenda-se usar --skip-columns=guid para evitar alterar acidentalmente as URLs armazenadas como identificadores únicos na coluna guid do banco de dados, o que poderia quebrar as URLs dos artigos. Esse comando também pode ser usado para substituir domínios de endereços de e-mail.

Substitua HTTP por HTTPS

Para atualizar suas URLs de HTTP para HTTPS, use o seguinte comando:

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

Recomenda-se usar --skip-columns=guid para não alterar acidentalmente as URLs armazenadas como identificadores únicos na coluna guid do banco de dados, o que pode levar a problemas com anexos de mídia.

Solução de problemas

Se você tiver problemas para executar comandos no WP-CLI, isso pode ser devido a um tema ou plugin que está apresentando um erro fatal. Você pode adicionar o seguinte ao seu comando WP-CLI para ignorar o carregamento de temas e plugins:

--skip-themes --skip-plugins

Por exemplo, para obter uma lista de usuários e ignorar os temas e plugins, você pode executar o seguinte:

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

Se quiser ignorar plugins específicos, você pode usar o seguinte, substituindo $plugin pelo nome do plugin e usando uma vírgula para separar cada plugin:

--skip-plugins=$plugin,$plugin

Por exemplo:

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