Como usar WordPress CLI

Como Usar o WordPress CLI

· · 21 min read ·
Written By: avatar do autor Joella Dunn
avatar do autor Joella Dunn
Joella is a writer with years of experience in WordPress. At Duplicator, she specializes in site maintenance — from basic backups to large-scale migrations. Her ultimate goal is to make sure your WordPress website is safe and ready for growth.
·
Reviewed By: avatar do revisor John Turner
avatar do revisor John Turner
John Turner is the President of Duplicator. He has over 20+ years of business and development experience and his plugins have been downloaded over 25 million times.

Você já clicou em menus infinitos no painel do WordPress apenas para atualizar um ou dois plugins?

Ou talvez você tenha passado um tempo precioso fazendo backup manual do seu site, desejando que houvesse uma maneira mais rápida? Existe!

WP-CLI é uma ferramenta poderosa que permite gerenciar seu site WordPress diretamente da linha de comando. Pense nisso como ter um painel de controle secreto onde você pode fazer praticamente qualquer coisa sem fazer login na área de administração do WordPress.

Aprender WP-CLI pode parecer intimidante no início. Mas confie em mim, é um divisor de águas. Ele acelera seu fluxo de trabalho, automatiza tarefas repetitivas e lhe dá mais controle sobre seu site.

Este tutorial mostrará como instalar, entender e usar o WP-CLI de forma eficaz.

Aqui estão os principais pontos:

  • WP-CLI é uma interface de linha de comando que permite gerenciar o WordPress sem o painel, economizando tempo significativo em tarefas rotineiras
  • A instalação requer PHP 5.6+, acesso SSH e alguns comandos de terminal para baixar e configurar a ferramenta
  • Você pode usar o WP-CLI para executar tarefas essenciais, incluindo atualização do WordPress, backup de sites, gerenciamento de plugins/temas e solução de problemas de erros
  • Comandos como wp core update e wp plugin update --all lidam com atualizações instantaneamente em todo o seu site
  • O WP-CLI permite automação poderosa por meio de scripts bash, permitindo que você gerencie vários sites simultaneamente
  • A ferramenta é particularmente valiosa para desenvolvedores, oferecendo acesso direto ao banco de dados, funcionalidade de pesquisa e substituição, e scaffolding de tema filho

Sumário

O que é o WordPress CLI?

WordPress CLI, ou WP-CLI, é uma interface de linha de comando para WordPress. Isso pode parecer técnico, mas simplesmente significa que você pode interagir com seu site WordPress usando comandos de texto em vez de clicar em botões no painel usual.

Em vez de fazer login através de um navegador web, você usa um terminal ou prompt de comando em seu computador. Você digita comandos e o WP-CLI os executa, realizando ações como atualizar plugins, criar usuários ou fazer backup do seu banco de dados. É uma maneira diferente de gerenciar seu site.

Essencialmente, o WP-CLI permite que você converse diretamente com o WordPress usando comandos. Este método não é apenas eficiente, mas também abre novas possibilidades para automação e gerenciamento avançado.

Desenvolvedores adoram o WP-CLI porque ele permite gerenciar e editar sites WordPress rapidamente. Você digita comandos precisos que podem atualizar, configurar e solucionar problemas do seu site em segundos.

Por que usar WP-CLI?

O WP-CLI pode revolucionar a forma como você trabalha com sites WordPress.

Velocidade

A velocidade é a primeira grande vantagem. Tarefas manuais que consomem horas podem ser concluídas em minutos ou até segundos.

Atualizar 20 plugins? Isso é um único comando. Criar várias contas de usuário? Outra linha de texto rápida.

Automação

A automação se torna fácil com o WP-CLI.

Tarefas repetitivas podem ser scriptadas e agendadas. Você pode criar scripts bash que gerenciam vários sites WordPress simultaneamente, reduzindo drasticamente a carga de trabalho.

As capacidades de script significam que você pode integrar o gerenciamento do WordPress em fluxos de trabalho de automação maiores. Combine o WP-CLI com outras ferramentas como Git, Ansible ou scripts personalizados para um gerenciamento completo do site.

Controle

Para desenvolvedores, o WP-CLI oferece controle sem precedentes. Quer instalar rapidamente um plugin, criar um tema filho ou realizar operações complexas no banco de dados? Isso se torna uma tarefa simples na linha de comando.

A depuração se torna mais acessível. Você pode recuperar informações do site, verificar a compatibilidade de plugins e diagnosticar problemas sem navegar por várias telas de administração do WordPress.

O gerenciamento remoto é outro benefício poderoso. Você pode gerenciar instalações do WordPress sem precisar de acesso gráfico direto. Uma conexão de linha de comando é tudo o que você precisa.

O WP-CLI é instalado por padrão?

Não, o WP-CLI não vem pré-instalado com o WordPress.

Mesmo que você tenha um site WordPress rodando em seu servidor, você precisará tomar medidas extras para configurar o WP-CLI. É uma ferramenta separada que requer instalação manual.

O WP-CLI não faz parte dos arquivos principais do WordPress nem é empacotado com painéis de controle de hospedagem típicos. Você precisará instalá-lo manualmente em seu servidor.

A maioria dos ambientes de hospedagem web suporta WP-CLI, mas é sempre bom verificar com seu provedor de hospedagem para confirmar a compatibilidade e obter orientações específicas de instalação.

Como instalar o WP-CLI

Para instalar o WP-CLI, certifique-se de que seu servidor atende aos requisitos. Você precisará de:

  • PHP 5.6 ou superior: O WP-CLI é um aplicativo PHP, portanto, certifique-se de ter uma versão PHP compatível instalada.
  • Acesso SSH: Você precisará de acesso à linha de comando do seu servidor via SSH para executar os comandos de instalação. A maioria dos provedores de hospedagem oferece acesso SSH.

Em seguida, abra o terminal, puTTY ou Ubuntu. Isso depende do sistema operacional do seu computador.

Na linha de comando, conecte-se ao seu servidor com este comando:

ssh username@hostname

Em seguida, baixe o build Phar para instalar e gerenciar o CLI do WordPress:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Verifique se o arquivo foi baixado:

php wp-cli.phar --info

Finalmente, você precisará tornar este arquivo executável. Este também é o momento de movê-lo para o seu PATH. Use este comando:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Após isso, o WP-CLI deve estar instalado! Execute este comando para verificá-lo:

wp --info

Se tudo estiver funcionando corretamente, você verá uma saída parecida com esta:

OS:  Linux 4.10.0-42-generic #46~16.04.1-Ubuntu SMP Mon Dec 4 15:57:59 UTC 2017 x86_64
Shell:   /usr/bin/zsh
PHP binary:    /usr/bin/php
PHP version:     7.1.12-1+ubuntu16.04.1+deb.sury.org+1
php.ini used:   /etc/php/7.1/cli/php.ini
MySQL binary:
MySQL version:
SQL modes:
WP-CLI root dir:        /home/wp-cli/.wp-cli
WP-CLI packages dir:    /home/wp-cli/.wp-cli/packages/
WP-CLI global config:   /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 1.5.0

Como Usar o WordPress CLI

Agora que você tem o WP-CLI instalado, vamos explorar algumas maneiras práticas de usá-lo. Aqui está uma visão geral rápida:

  • Atualizar o WordPress: Mantenha seu core, plugins e temas atualizados com comandos únicos
  • Recuperar Informações do Site: Acesse números de versão, URLs, configurações e detalhes de usuários instantaneamente
  • Fazer Backup do Seu Site: Exporte bancos de dados e crie backups completos usando os comandos WP-CLI do Duplicator
  • Gerenciar Seu Banco de Dados: Otimize, repare, exporte e importe arquivos de banco de dados
  • Gerenciar Plugins e Temas: Instale, ative, desative, atualize e desinstale em massa
  • Moderar Comentários: Liste, aprove, marque como spam, mova para a lixeira ou exclua comentários com filtros
  • Criar Posts e Páginas: Gere e atualize conteúdo com campos personalizados pela linha de comando
  • Criar e Modificar Usuários: Adicione usuários, atualize funções, redefina senhas e gerencie permissões
  • Solucionar Erros: Verifique arquivos principais, desative plugins, alterne temas e verifique bancos de dados
  • Criar um Tema Filho: Estruture temas filhos com a estrutura e os arquivos corretos
  • Regenerar Miniaturas: Recrie miniaturas de imagens após alterar as configurações de tamanho
  • Pesquisar e Substituir URLs: Atualize URLs em seu banco de dados para migrações e alterações de domínio

1. Atualizar o WordPress

Manter seu site WordPress atualizado é crucial para segurança e desempenho. O WP-CLI facilita tarefas administrativas como backups.

Para atualizar sua instalação do WordPress para a versão mais recente, use este comando:

wp core update

Para atualizar plugins com WP-CLI, use:

wp plugin update --all

Para atualizar um plugin específico, use seu slug:

wp plugin update plugin-slug

Atualizar temas funciona da mesma maneira.

wp theme update --all
wp theme update theme-slug

Você também pode atualizar para uma versão específica, se necessário. Por exemplo, para atualizar para o WordPress 6.4.3, você usaria:

wp core update --version=6.4.3

Para pré-visualizar quais atualizações ocorreriam sem realmente fazer alterações, use o sinalizador --dry-run:

wp core update --dry-run

Este comando mostrará quais atualizações estão disponíveis sem aplicá-las. É uma boa maneira de testar antes de fazer a atualização de verdade.

2. Obter informações do site

O WP-CLI permite recuperar rapidamente várias informações sobre seu site WordPress. Isso pode ser útil para depuração, verificação de configurações ou simplesmente para obter uma melhor compreensão de sua configuração.

Para ver a versão atual da sua instalação do WordPress, use:

wp core version

Isso exibirá o número da versão, como 6.4.3.

Para recuperar a URL principal do seu site WordPress, use:

wp option get home

Isso retornará a URL configurada em suas configurações do WordPress.

Para encontrar um e-mail de administrador, use:

wp option get admin_email

Para encontrar o título do seu site, use:

wp option get blogname

Você pode obter uma lista de usuários usando:

wp user list

Você pode obter os detalhes de um usuário específico usando o ID do usuário dele. Por exemplo, para o ID de usuário 1:

wp user get 1

Esses comandos são úteis para acessar rapidamente detalhes importantes sobre seu site WordPress sem fazer login no painel. Você também pode usar essas informações em scripts para automatizar certas tarefas.

3. Fazer backup do seu site

Backups regulares são essenciais para qualquer site WordPress. O WP-CLI pode ajudá-lo a criar backups de forma rápida e fácil.

O backup mais simples que você pode realizar com o WP-CLI é uma exportação do banco de dados. Você pode usar este comando:

wp db export

No entanto, backups completos ficam um pouco mais complicados.

Para torná-los mais fáceis, use o Duplicator. Este plugin de backup vem com comandos WP-CLI para que você possa fazer backup do seu site sem sair da interface de linha de comando do WordPress.

plugin Duplicator Pro

Use este comando para criar um backup completo do site (banco de dados e arquivos):

wp duplicator build

Os comandos WP-CLI do Duplicator Pro são altamente personalizáveis. Aqui estão algumas opções:

  • --template=<ID>: Use um modelo de backup predefinido.
  • --dir=<path>: Especifique um local de backup personalizado.
  • --delete: Remova automaticamente o backup após a criação.
  • --phpsqldump, --phpzip, --duparchive: Altere o mecanismo de arquivamento usado para backups.

Use o comando wp duplicator build --help para uma visão geral completa das opções disponíveis.

Esses comandos fornecem uma maneira fácil de criar, gerenciar e limpar seus backups. Você pode automatizar backups criando scripts simples que executam esses comandos WP-CLI.

Por exemplo, você pode criar um script bash para fazer backup de vários sites simultaneamente.

#!/bin/bash

# Define site path to user associations
declare -A site_configs=(
    ["/var/www/site1/public"]="user1"
    ["/var/www/site2/public"]="user2"
    ["/var/www/site3/public"]="user3"
    # Add more associations as needed
)

target_path="/path/to/backup/destination"

# Create and clean the destination folder
mkdir -p "$target_path" || { echo "Unable to create folder $target_path"; exit 1; }
cd "$target_path" || { echo "Unable to access folder $target_path"; exit 1; }

# Iterate through site path to user associations
for site_path in "${!site_configs[@]}"; do
    user="${site_configs[$site_path]}"

    # Check if the web folder exists
    if [ ! -d "$site_path" ]; then
        echo "Folder $site_path does not exist. Skipping..."
        continue
    fi

    # Execute backup
    cd "$site_path" || { echo "Unable to access $site_path"; continue; }
    echo "Creating backup for $site_path with user $user"
    sudo -u "$user" wp duplicator build --delete --dir="$target_path"
done

# Change ownership and create zip
cd "$target_path" || { echo "Unable to access $target_path"; exit 1; }
chown $USER:$USER *
zip ../backups.zip *

O WP-CLI pode lidar com backups básicos de banco de dados. Para backups mais flexíveis e automatizados, instale o Duplicator Pro. Seus comandos estendem o WP-CLI, tornando-o uma ferramenta poderosa para sua estratégia de backup.

4. Gerenciar seu banco de dados

O WP-CLI oferece vários comandos para gerenciar seu banco de dados WordPress diretamente da linha de comando. Isso pode ser útil para otimizar o desempenho, solucionar problemas e realizar tarefas de manutenção.

Para otimizar seu banco de dados, use:

wp db optimize

Este comando ajuda a melhorar o desempenho do banco de dados removendo sobrecarga. É uma boa prática executá-lo regularmente.

Se você encontrar problemas com seu banco de dados, pode tentar repará-lo usando:

wp db repair

Este comando tenta corrigir quaisquer tabelas corrompidas.

Você já viu um comando básico de exportação de banco de dados, mas aqui está outro exemplo. Você pode exportar o banco de dados com um nome de arquivo personalizado:

wp db export my_database_backup.sql

Para importar um banco de dados exportado anteriormente, use:

wp db import my_database_backup.sql

Certifique-se de que o arquivo SQL exista no diretório onde você está executando o comando.

Este comando substituirá seu banco de dados existente pelo que está no arquivo especificado. Tenha cuidado ao executar este comando em um site ativo. Sempre faça backup dele primeiro!

Esses comandos facilitam o gerenciamento e a manutenção do seu banco de dados WordPress, sem a necessidade de fazer login no phpMyAdmin ou em outra ferramenta de gerenciamento de banco de dados. Eles fornecem acesso direto às operações do banco de dados através da linha de comando.

5. Gerenciar plugins e temas

O WP-CLI oferece uma maneira conveniente de gerenciar seus plugins e temas do WordPress a partir da linha de comando. Isso é muito mais rápido do que usar a área de administração do WordPress, especialmente se você precisar gerenciar vários plugins e temas.

Para instalar um plugin, use o seguinte comando, substituindo plugin-slug pelo slug real do plugin:

wp plugin install plugin-slug

Por exemplo, para instalar o popular plugin All in One SEO:

wp plugin install all-in-one-seo-pack

Você também pode instalar um plugin a partir de um arquivo ZIP:

wp plugin install /path/to/plugin.zip

Para ativar um plugin, use:

wp plugin activate plugin-slug

Por exemplo, para ativar o AIOSEO:

wp plugin activate all-in-one-seo-pack

Para desativar um plugin, use:

wp plugin deactivate plugin-slug

Para ver uma lista de todos os plugins instalados, use:

wp plugin list

Você também pode usar um sinalizador para filtrar por status:

wp plugin list --status=active

Isso exibirá uma lista dos seus plugins instalados, incluindo o status deles (ativo ou inativo).

Para desinstalar um plugin, use:

wp plugin uninstall plugin-slug

Use o WP-CLI de forma semelhante para gerenciar temas, substituindo "plugin" por "theme". Por exemplo, veja como instalar o tema Twenty Twenty-Four:

wp theme install twentytwentyfour

Esses comandos permitem gerenciar seus plugins e temas de forma eficiente. Você pode realizar ações em massa, atualizar, ativar ou desativar plugins e temas com um único comando, economizando tempo e esforço valiosos.

6. Moderar comentários

Gerenciar comentários pode ser uma tarefa demorada. O WP-CLI oferece uma maneira rápida de moderar comentários pela linha de comando. Isso é especialmente útil se você tiver um grande número de comentários para lidar.

Para ver uma lista de todos os comentários, use:

wp comment list

Este comando exibirá uma lista de todos os comentários, juntamente com seu ID, autor e status. Você pode usar vários sinalizadores para filtrar os comentários.

Para listar apenas comentários pendentes:

wp comment list --status=hold

Você também pode listar comentários aprovados com:

wp comment list --status=approve

Ou comentários de spam com:

wp comment list --status=spam

Para aprovar um comentário, use seu ID:

wp comment approve comment-id

Substitua comment-id pelo ID real do comentário.

Para desaprovar um comentário, use:

wp comment unapprove comment-id

Para marcar um comentário como spam:

wp comment spam comment-id

Para desmarcar um comentário como spam:

wp comment unspam comment-id

Para mover um comentário para a lixeira:

wp comment trash comment-id

Para excluir um comentário permanentemente:

wp comment delete comment-id

Tenha cuidado, esta ação é irreversível.

Você pode realizar ações em massa combinando comandos com filtros. Por exemplo, para aprovar todos os comentários pendentes:

wp comment list --status=hold --format=ids | xargs wp comment approve

Este comando recupera os IDs dos comentários pendentes e aprova todos eles em uma única etapa.

Esses comandos facilitam muito o gerenciamento de comentários, especialmente se você recebe um grande volume deles. Você pode filtrar, aprovar, excluir ou marcar comentários como spam rapidamente usando comandos simples.

7. Criar posts e páginas

O WP-CLI permite criar e gerenciar conteúdo diretamente da linha de comando. Isso pode ser útil para adicionar rapidamente posts ou páginas.

Para criar um novo post, use:

wp post create --post_type=post --post_title="My New Post" --post_content="This is the content of my new post." --post_status=publish

Substitua "Meu Novo Post" e "Este é o conteúdo do meu novo post." pelo título e conteúdo reais que você deseja. Este comando criará um novo post publicado com o título e conteúdo fornecidos.

Você também pode definir o status do post como rascunho se não quiser publicá-lo imediatamente.

Para criar uma nova página, use:

wp post create --post_type=page --post_title="My New Page" --post_content="This is the content of my new page." --post_status=publish

Para atualizar conteúdo com o WP-CLI, você precisará do ID do post ou da página:

wp post update post-id --post_title="Updated Title" --post_content="Updated Content."

Substitua post-id pelo ID do post ou página que você deseja atualizar e "Título Atualizado" e "Conteúdo Atualizado" pelo novo conteúdo.

Para excluir um post ou página, use o ID:

wp post delete post-id

Para listar seus posts:

wp post list --post_type=post

Para listar suas páginas:

wp post list --post_type=page

Você pode usar várias flags para filtrar a lista por status, autor e muito mais.

Você também pode definir campos personalizados usando WP-CLI. Por exemplo:

wp post meta set post-id meta-key "Meta Value"

Substitua post-id, meta-key e Meta Value pelos valores reais.

Esses comandos fornecem uma maneira rápida de adicionar, atualizar ou remover conteúdo sem fazer login na área administrativa do WordPress. Isso pode ser muito útil quando você deseja automatizar tarefas de gerenciamento de conteúdo.

8. Criar e modificar usuários

Você pode criar, atualizar e excluir usuários com WP-CLI.

Para criar um novo usuário, use este comando:

wp user create username user@example.com --user_pass="password" --role=author

Substitua username, user@example.com, password e author pelos valores desejados.

Este comando criará um novo usuário com o nome de usuário, e-mail, senha e função especificados. Você pode usar outras funções, como editor, administrador, assinante e muito mais.

Para ver uma lista de todos os usuários em seu site:

wp user list

Isso exibirá uma lista de todos os usuários, juntamente com seus IDs, nomes de usuário e e-mails.

Para obter os detalhes de um usuário específico, use:

wp user get user-id

Substitua user-id pelo ID do usuário.

Para atualizar um usuário existente, você pode usar o comando wp user update. Por exemplo, para alterar o endereço de e-mail do usuário:

wp user update user-id --user_email=newemail@example.com

Você também pode atualizar outros campos, como a senha ou a função do usuário.

Para redefinir a senha de um usuário, use:

wp user update user-id --user_pass=new_password

Para excluir um usuário:

wp user delete user-id

Você pode gerenciar funções e permissões de usuário usando WP-CLI. Por exemplo, adicione a função de editor a um usuário com este comando:

wp user set-role user-id editor

Use wp user remove-role para remover um usuário de uma função.

Agora você terá todas as ferramentas necessárias para gerenciar usuários em seu site WordPress a partir da linha de comando. Isso pode ser especialmente útil quando você precisar executar ações em massa de usuários.

9. Solucionar erros

O WP-CLI pode ser uma ferramenta útil para solucionar erros e depurar problemas em seu site WordPress. Aqui estão alguns comandos que podem ajudar.

O WP-CLI pode mostrar se há algum erro na sua configuração do WordPress. Este comando verificará se todos os arquivos principais do WordPress estão intactos. Se algum arquivo estiver faltando ou modificado, ele relatará um erro.

wp core verify-checksums

Embora o WP-CLI não possa identificar diretamente erros em plugins ou temas, você pode usá-lo para desativar plugins ou trocar de tema para solucionar problemas.

Para desativar todos os plugins:

wp plugin deactivate --all

Para mudar para um tema padrão:

wp theme activate twentytwentyfour

Depois disso, você pode reativá-los um por um para isolar o erro.

Você pode usar o comando wp db check para verificar erros no banco de dados, que podem indicar problemas em seu site:

wp db check

Você pode usar os comandos mencionados na seção de gerenciamento de banco de dados para reparar seu banco de dados, se necessário.

O WP-CLI não interage diretamente com os logs do servidor. Para ver os logs de erro do seu servidor web, você normalmente precisa usar ferramentas de linha de comando como tail para visualizar os logs de erro do seu servidor web diretamente. A localização desses logs varia com base na configuração do seu servidor.

Ao usar o WP-CLI, você pode testar e diagnosticar rapidamente problemas potenciais para colocar seu site de volta em funcionamento rapidamente.

10. Criar um tema filho

Criar um tema filho é uma boa ideia quando você deseja personalizar seu tema WordPress sem modificar os arquivos do tema original. O WP-CLI torna esse processo simples e rápido.

Para criar um tema filho, use o comando wp scaffold child-theme seguido pelo slug do tema pai.

Por exemplo, para criar um tema filho para o tema Twenty Twenty-Four, use:

wp scaffold child-theme twentytwentyfour

Este comando criará um novo diretório para o seu tema filho com os arquivos básicos necessários, incluindo style.css e functions.php. Ele também adicionará as informações de cabeçalho necessárias ao style.css para torná-lo um tema filho válido.

Você pode personalizar o diretório do tema filho adicionando o sinalizador --theme_slug.

wp scaffold child-theme twentytwentyfour --theme_slug=my-child-theme

Você também pode especificar o nome do tema filho com --theme_name.

wp scaffold child-theme twentytwentyfour --theme_name="My Child Theme"

Encontre a lista completa de opções com:

wp help scaffold child-theme

Este comando torna muito fácil a criação de temas filhos, que mantêm suas personalizações organizadas e garantem que elas não sejam substituídas ao atualizar o tema pai.

11. Regenerar miniaturas

Quando você altera os tamanhos de imagem nas configurações do WordPress, muitas vezes é necessário regenerar as miniaturas para suas imagens existentes. Esta é uma tarefa comum que o WP-CLI pode executar de forma eficiente.

Para regenerar todas as miniaturas, use:

wp media regenerate

Este comando percorrerá todos os seus arquivos de mídia existentes e regenerará as miniaturas com base nas suas configurações atuais. Isso pode levar algum tempo, dependendo de quantas imagens você tem.

Você também pode regenerar miniaturas para imagens específicas ou tamanhos específicos. Veja a lista completa de sinalizadores disponíveis usando:

wp help media regenerate

12. Pesquisar e substituir URLs

A funcionalidade de busca e substituição no WP-CLI é extremamente útil quando você migra um site WordPress. Ela ajudará você a atualizar URLs após uma mudança de domínio.

Para procurar uma URL antiga e substituí-la por uma nova URL, use o seguinte comando:

wp search-replace 'oldurl.com' 'newurl.com'

Substitua 'urlantiga.com' pela URL do seu site anterior e 'urlnova.com' pela URL do seu novo site.

Este comando pesquisará em todo o seu banco de dados e substituirá todas as instâncias da URL antiga pela nova.

Sempre faça backup do seu banco de dados antes de executar este comando. Isso garante que você possa reverter facilmente para o estado anterior caso algo dê errado.

Seja muito preciso com as URLs antiga e nova. Mesmo um pequeno erro de digitação pode causar problemas.

Este comando pode ser poderoso, mas também é muito perigoso se usado incorretamente. Teste em um site de staging antes de implementá-lo em produção.

Se você estiver usando dados serializados em seu banco de dados (o que é muito comum), use o sinalizador --all-tables para garantir que todas as instâncias das URLs sejam alteradas. Por exemplo:

wp search-replace 'oldurl.com' 'newurl.com' --all-tables

Para visualizar as alterações sem realmente fazê-las, use o sinalizador --dry-run:

wp search-replace 'oldurl.com' 'newurl.com' --dry-run

Este comando mostrará uma lista de todas as alterações que ele faria, dando a você a chance de verificá-las antes de prosseguir.

Perguntas Frequentes (FAQs)

O WP CLI funciona no Windows?

O WP-CLI funciona no Windows com a ajuda de ferramentas como WSL (Windows Subsystem for Linux) ou através de ambientes PHP compatíveis. A instalação direta é possível, mas problemas de compatibilidade podem surgir sem a configuração adequada.

Como registro um comando do WP CLI?

Registre um comando WP-CLI usando a função WP_CLI::add_command em seu código PHP. Defina uma função de callback para o comportamento do comando e inclua-a na base de código do seu plugin ou tema. Documente adequadamente os argumentos e o uso para garantir a funcionalidade.

Como verificar se a CLI está instalada ou não?

Verifique se o WP-CLI está instalado abrindo um terminal e executando o comando wp --info. Se estiver instalado, o número da versão ou o caminho será exibido; caso contrário, uma mensagem de erro aparecerá.

Como usar o WordPress CLI como iniciante?

Comece a usar o WordPress CLI instalando o WP-CLI e navegando até o seu diretório WordPress na linha de comando. Execute comandos como wp plugin list para ver os plugins ou wp theme activate para alterar temas. Comece com comandos básicos e consulte a documentação do WP-CLI para obter orientação.

Considerações Finais

O WP-CLI é uma ferramenta poderosa que pode melhorar significativamente seu fluxo de trabalho de gerenciamento do WordPress. De atualizações simples a operações complexas de banco de dados, ele oferece uma maneira mais rápida e eficiente de interagir com seus sites WordPress.

Encorajamos você a começar a experimentar o WP-CLI hoje mesmo. Comece com alguns comandos básicos deste tutorial do WP-CLI e explore gradualmente seus recursos mais avançados.

Quanto mais você usar, mais confortável ficará e mais perceberá seu potencial!

Se você está procurando flexibilidade extra no WP-CLI, considere usar o Duplicator Pro. É uma ferramenta de backup que se integra perfeitamente ao WP-CLI, otimizando seus backups de site a partir da linha de comando.

Enquanto você está aqui, acho que você vai gostar destes tutoriais extras do WordPress:

avatar do autor
Joella Dunn Content Writer
Joella is a writer with years of experience in WordPress. At Duplicator, she specializes in site maintenance — from basic backups to large-scale migrations. Her ultimate goal is to make sure your WordPress website is safe and ready for growth.
Our content is reader-supported. If you click on certain links we may receive a commission.

Não Deixe Mais Um Dia Passar Desprotegido

Cada hora sem backups adequados do WordPress coloca seu site em risco • Cada migração atrasada do WordPress custa desempenho e crescimento

Get Duplicator Now
Plugin Duplicator

Espere! Não perca sua
oferta exclusiva!

Como cliente , você recebe 60% DE DESCONTO

Experimente o Duplicator gratuitamente em seu site — veja por que mais de 1,5 milhão de profissionais do WordPress confiam em nós. Mas não espere — este desconto exclusivo de 60% está disponível apenas por tempo limitado.

or
Get 60% Off Duplicator Pro Now →