WordPress
Usando WP-CLI no seu site WordPress
KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…
KPanel inclui um console WP-CLI que executa comandos no seu site WordPress a partir do navegador, sem cliente SSH e sem login no servidor. Este guia cobre onde encontrá-lo, exatamente quais comandos são permitidos e por quê, os atalhos incorporados na tela e o que fazer quando você precisa de algo que o console não executará.
Abrindo o Console
- Faça login em KPanel e clique em Websites na barra lateral esquerda.
- Clique no seu site WordPress.
- Abra a aba WordPress e depois a seção Console.
A entrada já começa com um prefixo fixo wp, então você digita apenas o que vem depois dele. plugin list, não wp plugin list. Pressione Enter ou clique em Run.
Console é uma das seções que aparecem em planos gerenciados. Em outros planos, a faixa de abas termina com um link +8 em Managed em vez disso. Cada ação descrita aqui que não é um comando bruto tem um botão equivalente em outro lugar no KPanel, então nada está fora de alcance: o console é uma forma mais rápida de alcançar o mesmo mecanismo.
Os comandos são executados como o próprio usuário do sistema do seu site, dentro do diretório do seu site. Eles não conseguem ver ou tocar em nenhum outro site.
O Que o Console Fará e o Que Não Fará
O console usa uma lista de permissões. Apenas os prefixos de comando abaixo são aceitos, e qualquer coisa diferente é rejeitada antes de chegar ao servidor com uma mensagem nomeando o comando que foi recusado.
| Área | Permitido |
|---|---|
| Core | core version, core check-update, core update, core is-installed, core verify-checksums |
| Plugins | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Temas | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Usuários | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Banco de Dados | db size, db tables, db optimize, db repair, db check |
| Cache e transientes | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Regras de reescrita | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Config | config get, config list, config has, config shuffle-salts |
| Modo de manutenção | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Inspeção somente leitura | option get, option list, post list, post get, comment list, comment get |
| Mídia e idioma | media regenerate, language core install, language core update |
| Pesquisa e substituição | search-replace |
As exclusões deliberadas são mais importantes do que as inclusões:
evaleshellsão bloqueados. PHP arbitrário e shell arbitrário tornariam o console equivalente a um prompt raiz em uma aba do navegador.db import,db export,db drop,db queryedb resetsão bloqueados. Importação e reinicialização destroem um banco de dados sem etapa de confirmação;db queryé um prompt SQL irrestrito. Use phpMyAdmin em vez disso: Accessing Your Database With phpMyAdmin.config seteconfig deletesão bloqueados. Uma escritawp-config.phpruim coloca o site offline. Leia os valores aqui, altere-os através do gerenciador de arquivos.option updateeoption deletesão bloqueados. Editar opções sem visibilidade é uma forma comum de quebrar um site além da recuperação.
O console não faz backup para você, em nenhum comando. Apenas os botões na seção Quick Actions fazem isso. Antes de search-replace, core update, plugin update, theme update, db optimize ou db repair, faça um backup você mesmo na aba Backups do site. Veja Taking a Backup.
Trabalhando no Console
A tela faz mais do que aceitar um comando por vez.
Botões predefinidos. Atalhos agrupados ficam acima do prompt: Performance (limpar cache, limpar transientes, limpar rewrites, verificação autoload), Database (otimizar, verificar, reparar, tamanho), Diagnostics (versão WP, verificar atualizações, verificar core, eventos cron), Content (listar plugins, temas, usuários, executar cron agora), Security (usuários admin, checksums de plugin, redefinir salts, wp-config) e Maintenance (modo manutenção ligado e desligado, regenerar miniaturas, status). Um clique executa o comando.
Histórico. Pressione as setas para cima e para baixo no prompt para mover-se pelos seus últimos 50 comandos neste site.
Snippets. Clique no ícone de marcador próximo a um comando para salvá-lo com um nome, assim uma invocação longa que você usa a cada mês é um clique na próxima vez.
Cartão de ambiente. Acima do prompt, um cartão mostra a versão PHP do site, versão WordPress, limite de memória, memória atualmente usada, máximo de upload e limite de tempo de execução, com um botão Copy for support que coloca tudo isso mais sua lista de plugins ativos na área de transferência. Cole isso em um ticket de suporte e você economizou uma volta de ida e volta.
Copiar saída. Cada bloco de resultado tem botões copiar e limpar.
A saída volta conforme o comando é executado, então uma operação longa mostra progresso em vez de ficar silenciosa.
Comandos Vale a Pena Conhecer
Diagnóstico
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
verify-checksums compara seus arquivos core e de plugin com as cópias publicadas oficialmente e relata qualquer coisa modificada. É a verificação primeira mais rápida em um site que você suspeita ter sido alterado.
option list --autoload=yes lista cada opção que WordPress carrega em cada solicitação única. Uma tabela autoload inchada é uma das causas mais comuns de um site que é lento sem motivo visível.
Manutenção
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Usuários
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Qualquer coisa digitada aqui é registrada no log de atividades da sua conta, incluindo senhas. Altere uma senha que você define desta forma uma vez que tenha feito login. Detalhes completos sobre recuperação de conta estão em Resetting a Lost WordPress Admin Password.
Pesquisa e Substituição
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Sempre faça uma execução seca primeiro. O guia completo, incluindo por que uma substituição SQL bruta corrompe um banco de dados WordPress, está em Running a Search and Replace.
Console ou Quick Actions?
Ambos executam o mesmo WP-CLI subjacente. Escolha com base nisto:
| Tarefa | Melhor rota |
|---|---|
| Limpar cache, atualizar plugins, regenerar mídia | Quick Actions, um clique e faz backup primeiro |
| Pesquisa e substituição com uma visualização por tabela | Quick Actions, o cartão Search & Replace |
| Qualquer coisa que necessite de um sinalizador específico | Console |
| Listagem, inspeção, diagnóstico | Console |
| Executar um evento cron atrasado | Console |
Editar wp-config.php ou importar um banco de dados | Nenhum. Use o gerenciador de arquivos ou phpMyAdmin |
Quando Você Precisa Mais do Que a Lista de Permissões
Para WP-CLI irrestrito, conecte-se via SSH e execute wp diretamente do diretório do seu site. SSH usa apenas autenticação por chave, então adicione sua chave pública primeiro na aba Files, depois SSH Keys do site. Os detalhes de conexão, incluindo o host exato, porta e nome de usuário, são mostrados na mesma tela. Veja Adding SSH Keys e Connecting Over SFTP.
Solução de Problemas
"'x y' is not in the allowed command list." O comando não está na lista de permissões. Verifique a tabela acima para o equivalente permitido mais próximo, ou use SSH.
"No results returned. Check that WP-CLI is available." O comando foi executado mas não imprimiu nada. Geralmente o comportamento correto para uma consulta sem correspondências.
O comando expira. Os comandos do console são limitados a 60 segundos. Operações longas, como regenerar uma biblioteca de mídia grande, devem ser executadas a partir de Quick Actions, que usa um limite mais longo, ou via SSH.
Nada é executado e os botões estão desabilitados. Sua função de conta Kapsule é somente leitura para este site. Peça a um proprietário de conta que a aumente.