KPanel inclui uma consola WP-CLI que executa comandos no seu site WordPress a partir do navegador, sem cliente SSH e sem iniciar sessão no servidor. Este guia explica onde a encontrar, quais os comandos exatamente permitidos e porquê, os atalhos integrados no ecrã, e o que fazer quando precisa de algo que a consola não executa.
Abrir a Consola
- Inicie sessão em KPanel e clique em Websites na barra lateral esquerda.
- Clique no seu site WordPress.
- Abra o separador WordPress e, depois, a secção Console.
A entrada já começa com um wp fixo, pelo que só escreve o que vem depois dele. plugin list, não wp plugin list. Prima Enter ou clique em Run.
Console é uma das secções que aparecem nos planos geridos. Noutros planos, a faixa de separadores termina com um link +8 on Managed em alternativa. Todas as ações aqui descritas que não sejam um comando em bruto têm um botão equivalente noutro ponto do KPanel, pelo que nada fica fora de alcance: a consola é apenas uma forma mais rápida de chegar ao mesmo motor.
Os comandos são executados como o próprio utilizador de sistema do seu site, dentro do diretório do seu site. Não conseguem ver nem tocar em qualquer outro site.
O Que a Consola Executa e o Que Não Executa
A consola utiliza uma lista de permissões. Apenas os prefixos de comando abaixo são aceites, e qualquer outro é rejeitado antes de chegar ao servidor, com uma mensagem a identificar o comando 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 |
| Utilizadores | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Base de dados | db size, db tables, db optimize, db repair, db check |
| Cache e transients | 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 |
| Configuração | config get, config list, config has, config shuffle-salts |
| Modo de manutenção | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Inspeção apenas de leitura | option get, option list, post list, post get, comment list, comment get |
| Media e idioma | media regenerate, language core install, language core update |
| Procurar e substituir | search-replace |
As exclusões deliberadas importam mais do que as inclusões:
evaleshellestão bloqueados. PHP arbitrário e shell arbitrária tornariam a consola equivalente a uma linha de comandos root num separador do navegador.db import,db export,db drop,db queryedb resetestão bloqueados. Importar e repor destroem uma base de dados sem qualquer confirmação;db queryé uma linha de comandos SQL sem restrições. Em vez disso, utilize o phpMyAdmin: Aceder à Sua Base de Dados com o phpMyAdmin.config seteconfig deleteestão bloqueados. Uma escrita incorreta emwp-config.phpcoloca o site fora do ar. Consulte os valores aqui, altere-os através do gestor de ficheiros.option updateeoption deleteestão bloqueados. Editar opções às cegas é uma forma comum de danificar um site sem possibilidade de recuperação.
A consola não faz qualquer cópia de segurança por si, em nenhum comando. Só os botões da secção Ações Rápidas fazem isso. Antes de search-replace, core update, plugin update, theme update, db optimize ou db repair, faça você mesmo uma cópia de segurança a partir da página Cópias de segurança do site. Consulte Fazer uma Cópia de Segurança.
Trabalhar na Consola
O ecrã faz mais do que aceitar um comando de cada vez.
Botões predefinidos. Atalhos agrupados situam-se acima da linha de comandos: Desempenho (limpar cache, limpar transients, limpar regras de reescrita, verificação de autoload), Base de Dados (otimizar, verificar, reparar, tamanho), Diagnóstico (versão do WP, verificar atualizações, verificar o core, eventos cron), Conteúdo (listar plugins, temas, utilizadores, executar cron agora), Segurança (utilizadores administradores, checksums de plugins, repor salts, wp-config) e Manutenção (ativar e desativar o modo de manutenção, regenerar miniaturas, estado). Um clique executa o comando.
Histórico. Prima as setas para cima e para baixo na linha de comandos para percorrer os últimos 50 comandos neste site.
Snippets. Clique no ícone de marcador junto a um comando para o guardar com um nome, de modo a que uma instrução longa que utiliza todos os meses fique a apenas um clique da próxima vez.
Cartão de ambiente. Acima da linha de comandos, um cartão mostra a versão do PHP, a versão do WordPress, o limite de memória, a memória atualmente utilizada, o máximo de carregamento e o limite de tempo de execução do site, com um botão Copiar para suporte que coloca tudo isto, mais a sua lista de plugins ativos, na área de transferência. Cole isso num pedido de suporte e poupa uma troca de mensagens desnecessária.
Copiar resultado. Cada bloco de resultados tem botões de copiar e limpar.
O resultado é transmitido à medida que o comando é executado, pelo que uma operação longa mostra progresso em vez de ficar silenciosa.
Comandos a 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 os ficheiros do core e dos plugins com as cópias oficiais publicadas e reporta qualquer alteração. É a verificação inicial mais rápida num site que suspeita ter sido adulterado.
option list --autoload=yes lista todas as opções que o WordPress carrega em cada pedido. Uma tabela de autoload sobrecarregada é uma das causas mais comuns de um site lento sem motivo aparente.
Manutenção Geral
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
Utilizadores
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
Tudo o que for escrito aqui fica registado no registo de atividade da sua conta, incluindo palavras-passe. Altere uma palavra-passe definida desta forma assim que iniciar sessão. Os detalhes completos sobre a recuperação de conta encontram-se em Repor uma Palavra-passe de Administrador do WordPress Perdida.
Procurar e Substituir
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Faça sempre primeiro uma simulação (dry run). A explicação completa, incluindo o motivo pelo qual uma substituição SQL em bruto corrompe uma base de dados WordPress, encontra-se em Executar uma Pesquisa e Substituição.
Consola ou Ações Rápidas?
Ambas executam o mesmo WP-CLI por baixo. Escolha com base no seguinte:
| Tarefa | Melhor opção |
|---|---|
| Limpar cache, atualizar plugins, regenerar media | Ações Rápidas, um clique e faz primeiro uma cópia de segurança |
| Pesquisa e substituição com pré-visualização por tabela | Ações Rápidas, o cartão Search & Replace |
| Qualquer coisa que precise de uma flag específica | Consola |
| Listar, inspecionar, diagnosticar | Consola |
| Executar um evento cron em atraso | Consola |
Editar wp-config.php ou importar uma base de dados | Nenhuma das duas. Utilize o gestor de ficheiros ou o phpMyAdmin |
Quando Precisa de Mais do Que a Lista de Permissões
Para um WP-CLI sem restrições, ligue-se por SSH e execute wp diretamente a partir do diretório do seu site. O SSH utiliza apenas autenticação por chave, pelo que deve primeiro adicionar a sua chave pública a partir do separador Definições do site e, depois, do separador Chaves SSH. Os detalhes de ligação, incluindo o anfitrião, a porta e o nome de utilizador exatos, são apresentados nesse mesmo ecrã. Consulte Adicionar Chaves SSH e Ligar por SFTP.
Resolução de Problemas
"'x y' is not in the allowed command list." O comando não consta da lista de permissões. Consulte a tabela acima para encontrar o equivalente permitido mais próximo, ou utilize SSH.
"No results returned. Check that WP-CLI is available." O comando foi executado mas não imprimiu nada. Normalmente, é o comportamento correto para uma consulta sem resultados.
O comando esgota o tempo limite. Os comandos da consola têm um limite de 60 segundos. Operações longas, como a regeneração de uma biblioteca de media de grandes dimensões, devem ser executadas a partir das Ações Rápidas, que utiliza um limite mais longo, ou por SSH.
Nada é executado e os botões estão desativados. A sua função na conta KapsuleHost é apenas de leitura para este site. Peça a um titular da conta para a alterar.