WordPress · 8 min read · Oct 30, 2025

Como Instalar e Usar WP-CLI no Ubuntu

WP-CLI é uma interface de linha de comando para gerenciar instalações do WordPress no Ubuntu e em outros sistemas baseados em Linux. Ele permite que os usuários realizem uma ampla gama de tarefas administrativas sem precisar usar o painel da web do WordPress, oferecendo uma maneira mais rápida e eficiente de gerenciar sites. Com o WP-CLI, você pode atualizar plugins e temas, gerenciar usuários, criar e excluir postagens, configurar definições e até automatizar tarefas complexas, tudo diretamente do terminal. Esta ferramenta é particularmente benéfica para desenvolvedores e administradores de sistema que gerenciam vários sites WordPress, pois simplifica muitas tarefas rotineiras e permite operações em massa, tornando o gerenciamento do WordPress mais eficiente e escalável.

Este tutorial explicará como instalar o WP-CLI e o WordPress usando o WP-CLI e realizar algumas tarefas básicas. Os passos foram testados no Ubuntu 24.04.

Requisitos

  • Um servidor rodando Ubuntu Linux.
  • Uma senha de root configurada para seu servidor.

Começando

Antes de começar, você deve atualizar seu sistema com a versão mais recente. Você pode fazer isso executando o seguinte comando:

apt update -y  
apt upgrade -y

Uma vez que seu servidor esteja atualizado, reinicie seu servidor para aplicar as alterações.

Instalar Servidor LAMP

Primeiro, você precisará instalar o Apache, MariaDB e PHP em seu sistema. Você pode instalar todos eles executando o seguinte comando:

apt-get install apache2 mariadb-server php php-cli php-common php-curl php-gd php-mbstring php-xml php-xmlrpc php-zip php-mysql -y

Uma vez que todos os pacotes estejam instalados, você pode prosseguir com a instalação do WP-CLI.

Instalar WP-CLI

A ferramenta WP-CLI está disponível em um arquivo .phar. Você pode baixá-lo com o seguinte comando:

cd /tmp  
wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Uma vez baixado, mova o arquivo baixado para o diretório /usr/bin:

mv wp-cli.phar /usr/bin/wpcli

Em seguida, adicione permissão de execução ao arquivo wpcli com o seguinte comando:

chmod +x /usr/bin/wpcli

Em seguida, verifique a instalação do WP-CLI com o seguinte comando:

wpcli --info

Se tudo correr bem, você deve obter a seguinte saída:

Shell:  /bin/bash
PHP binary:  /usr/bin/php8.3
php.ini used:  /etc/php/8.3/cli/php.ini
WP-CLI root dir:  phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:  phar://wp-cli.phar/vendor
WP_CLI phar path:  /root
WP-CLI packages dir:  
WP-CLI global config:  
WP-CLI project config:  
WP-CLI version:  2.11.0

Ativar Conclusão do Bash

A conclusão do bash é um recurso do WP-CLI que permite listar todos os comandos disponíveis pressionando Tab.

Para fazer isso, você precisará baixar o script bash do repositório Git:

wget https://github.com/wp-cli/wp-cli/raw/master/utils/wp-completion.bash

Em seguida, adicione o caminho do script bash no arquivo .bashrc para que a conclusão do wp seja carregada automaticamente.

nano .bashrc

Adicione a seguinte linha:

source /root/wp-completion.bash

Salve e feche o arquivo, então recarregue o perfil bash com o seguinte comando:

source ~/.bashrc

Agora, você pode testá-lo digitando wpcli e pressionando Tab duas vezes. Você deve ver a lista de comandos disponíveis com wp.

Instalar WordPress com WP-CLI

Nesta seção, aprenderemos como baixar e instalar o WordPress com o WP-CLI.

Criar Banco de Dados para WordPress

Primeiro, faça login no MariaDB e crie um banco de dados para o WordPress:

mysql -u root -p

Forneça sua senha de root e, em seguida, crie um banco de dados e um usuário para o WordPress com o seguinte comando:

MariaDB [(none)]> CREATE DATABASE wp;  
MariaDB [(none)]> CREATE USER 'wpuser' IDENTIFIED BY 'password';

Em seguida, conceda todas as permissões ao banco de dados do WordPress com o seguinte comando:

MariaDB [(none)]> GRANT ALL PRIVILEGES ON wp.* TO 'wpuser';

Em seguida, limpe as permissões e saia do shell do MariaDB com o seguinte comando:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Uma vez que você tenha feito isso, pode prosseguir para a próxima etapa.

Baixar e Instalar WordPress

Primeiro, mude o diretório para a raiz da web do Apache e dê as permissões adequadas com o seguinte comando:

cd /var/www/html  
chown -R www-data:www-data /var/www/html/

Em seguida, baixe a fonte do WordPress executando o WP-CLI como um usuário www-data:

sudo -u www-data wp core download

Você deve ver a seguinte saída:

md5 hash verified: aea5bb5e4fd51034f67c85e6d8bc6bbf
Success: WordPress downloaded.

Em seguida, gere o arquivo wp-config.php com o seguinte comando:

sudo -u www-data wpcli core config --dbname='wp' --dbuser='wpuser' --dbpass='password' --dbhost='localhost' --dbprefix='wp_'

Você deve ver a seguinte saída:

Success: Generated 'wp-config.php' file.

Não se esqueça de substituir wpuser e password pelo seu usuário e senha do banco de dados do WordPress.

Agora, inicie a instalação do WordPress com o seguinte comando:

sudo -u www-data wpcli core install --url='http://example.com' --title='Meu Blog WordPress' --admin_user='wpadmin' --admin_password='password' --admin_email='[email protected]'

Por favor, substitua o nome do domínio, adminuser e senha conforme sua necessidade.

Agora, abra seu navegador da web e digite a URL http://example.com/wp-admin. Você será redirecionado para a página de login do WordPress, conforme mostrado abaixo:

Login do WordPress

Forneça seu nome de usuário e senha de administrador e clique no botão Entrar. Você deve ver o painel do WordPress na seguinte página:

WordPress

Uma vez que você tenha feito isso, pode prosseguir para a próxima etapa.

Instalar Temas e Plugins

Você pode instalar plugins e temas facilmente usando a ferramenta de linha de comando WP-CLI.

Primeiro, liste todos os plugins instalados com o seguinte comando:

sudo -u www-data wpcli plugin list

Saída:

+---------+----------+--------+---------+
| name    | status   | update | version |
+---------+----------+--------+---------+
| akismet | inactive | none   | 4.1.2   |
| hello   | inactive | none   | 1.7.2   |
+---------+----------+--------+---------+

Você também pode listar todos os temas instalados com o seguinte comando:

sudo -u www-data wpcli theme list

Saída:

+-----------------+----------+--------+---------+
| name            | status   | update | version |
+-----------------+----------+--------+---------+
| twentynineteen  | active   | none   | 1.4     |
| twentyseventeen | inactive | none   | 2.2     |
| twentysixteen   | inactive | none   | 2.0     |
+-----------------+----------+--------+---------+

Agora, pesquise e instale o plugin “WP Super Cache” com o seguinte comando:

sudo -u www-data wpcli plugin search "WP Super Cache"

Saída:

Success: Showing 10 of 508 plugins.
+------------------------------------------------------------------+--------------------------------------+--------+
| name                                                             | slug                                 | rating |
+------------------------------------------------------------------+--------------------------------------+--------+
| WP Super Cache                                                   | wp-super-cache                       | 86     |
| Autoptimize                                                      | autoptimize                          | 94     |
| WP Fastest Cache                                                 | wp-fastest-cache                     | 96     |
| WP-Optimize – Clean, Compress, Cache.                      | wp-optimize                          | 98     |
| WP Super Cache – Clear all cache                           | wp-super-cache-clear-cache-menu      | 66     |
| WPS Hide Login                                                   | wps-hide-login                       | 98     |
| Cerber Security, Antispam & Malware Scan                     | wp-cerber                            | 98     |
| Minimal Coming Soon & Maintenance Mode – Coming Soon Builder | minimal-coming-soon-maintenance-mode | 96     |
| Hummingbird – Speed up, Cache, Optimize Your CSS and JS          | hummingbird-performance              | 96     |
| CAOS | Host Google Analytics Locally                             | host-analyticsjs-local               | 96     |
+------------------------------------------------------------------+--------------------------------------+--------+

Agora, instale e ative o plugin wp-super-cache com o seguinte comando:

sudo -u www-data wpcli plugin install wp-super-cache  
sudo -u www-data wpcli plugin activate wp-super-cache

Você deve ver a seguinte saída:

Plugin 'wp-super-cache' activated.
Success: Activated 1 of 1 plugins.

Em seguida, instale e ative o tema islemag com o seguinte comando:

sudo -u www-data wpcli theme install islemag  
sudo -u www-data wpcli theme activate islemag

Atualizar WordPress e Plugins

Se você deseja atualizar um plugin específico do WordPress, execute o seguinte comando:

sudo -u www-data wpcli plugin update wp-super-cache

Se você deseja atualizar seu WordPress, execute os seguintes comandos:

sudo -u www-data wpcli core update  
sudo -u www-data wpcli core update-db

Comando Básico do WP-CLI

Para verificar a versão do seu WordPress, execute o seguinte comando:

sudo -u www-data wpcli core version

Você deve ver a seguinte saída:

5.2.2

Para verificar se há alguma atualização disponível para o WordPress, execute o seguinte comando:

sudo -u www-data wpcli core check-update

Para limpar o cache do WordPress, execute o seguinte comando:

sudo -u www-data wpcli cache flush

Para atualizar todos os plugins, execute o seguinte comando:

sudo -u www-data wpcli plugin update --all

Para desativar todos os plugins, execute o seguinte comando:

sudo -u www-data wpcli plugin deactivate --all

Você também pode ver a lista de comandos disponíveis com o WP-CLI usando o seguinte comando:

sudo -u www-data wpcli --help

Você deve ver a seguinte saída:

NAME

  wp

DESCRIPTION

  Manage WordPress through the command-line.

SYNOPSIS

  wp 

SUBCOMMANDS

  cache                 Adds, removes, fetches, and flushes the WP Object Cache object.
  cap                   Adds, removes, and lists capabilities of a user role.
  cli                   Review current WP-CLI info, check for updates, or see defined aliases.
  comment               Creates, updates, deletes, and moderates comments.
  config                Generates and reads the wp-config.php file.
  core                  Downloads, installs, updates, and manages a WordPress installation.
  cron                  Tests, runs, and deletes WP-Cron events; manages WP-Cron schedules.
  db                    Performs basic database operations using credentials stored in wp-config.php.
  embed                 Inspects oEmbed providers, clears embed cache, and more.
  eval                  Executes arbitrary PHP code.
  eval-file             Loads and executes a PHP file.
  export                Exports WordPress content to a WXR file.
  help                  Get help on WP-CLI, or on a specific command.
  i18n                  Provides internationalization tools for WordPress projects.
  import                Imports content from a given WXR file.
  language              Installs, activates, and manages language packs.
  maintenance-mode      Activates, deactivates or checks the status of the maintenance mode of a site.
  media                 Imports files as attachments, regenerates thumbnails, or lists registered image sizes.
  menu                  Lists, creates, assigns, and deletes the active theme's navigation menus.
  network               Perform network-wide operations.
  option                Retrieves and sets site options, including plugin and WordPress settings.
  package               Lists, installs, and removes WP-CLI packages.
  plugin                Manages plugins, including installs, activations, and updates.
  post                  Manages posts, content, and meta.

Conclusão

O tutorial acima ensinou como instalar o WP-CLI em um servidor Debian. Você também aprendeu como usar o WP-CLI para instalar e gerenciar WordPress, plugins e temas. Para mais informações sobre o comando WP-CLI, visite a documentação do WP-CLI.

Share: X/Twitter LinkedIn
#WordPress

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.