Agendar tarefa no cPanel e corrigir o WP-Cron
O agendador do WordPress só roda quando alguém visita o site. Como trocá-lo por um cron de verdade no painel, com o caminho certo do PHP e sem virar spam na sua caixa de entrada.

Resposta curta: o cron do cPanel usa 5 campos de tempo (minuto, hora, dia, mês, dia da semana) e um comando. Para o WordPress, você desliga o WP-Cron com DISABLE_WP_CRON no wp-config.php e cria um cron real chamando o wp-cron.php a cada 15 minutos.
Neste artigo
- Por que o backup agendado às 3h nunca roda
- O que a tela de Cron Jobs do cPanel faz
- Por que /usr/bin/php pode chamar a versão errada de PHP
- Desligar o WP-Cron no wp-config.php
- Criar o cron real no cPanel
- Parar a enxurrada de e-mails a cada execução
- Como confirmar que o cron rodou, e o que checar quando não rodou
- O que mais vale a pena colocar no cron, e o que não vale
Por que o backup agendado às 3h nunca roda
O WordPress tem um agendador próprio, o WP-Cron. Ele é o que faz um plugin de backup rodar "todo dia às 3h", o que publica post agendado, o que manda o resumo diário do plugin de segurança.
O detalhe que quase nenhum tutorial conta: o WP-Cron não é um relógio. Ele é uma verificação que acontece quando alguém carrega uma página do site. A cada visita, o WordPress olha a lista de tarefas e pergunta "tem algo vencido?". Se tem, dispara.
A consequência é direta. Site com visita constante executa quase no horário. Site com pouco tráfego executa quando aparecer o próximo visitante. Se ninguém abre o site entre 1h e 9h da manhã, a tarefa das 3h só roda às 9h, junto com todas as outras que venceram na madrugada. É por isso que o backup "agendado" aparece com horário estranho no histórico, ou some por dias.
Tem o efeito contrário também. Em site com muito acesso, o WP-Cron é consultado em cima de cada visita. Em hospedagem compartilhada isso vira consumo de CPU distribuído por todo o dia, sem que você tenha controle sobre quando.
A correção é a mesma nos dois casos: desligar o gatilho por visita e passar a chamar o agendador em horário fixo, a partir do cron do servidor, que no cPanel fica em Cron Jobs.
O que a tela de Cron Jobs do cPanel faz
Cron é o agendador do próprio Linux. O cPanel só oferece uma tela para você escrever a linha sem mexer no terminal. Um cron job tem duas partes: quando e o quê.
O "quando" são cinco campos de tempo, na ordem que a tela apresenta:
| Campo | Valores aceitos | Exemplo | Significado do exemplo |
|---|---|---|---|
| Minuto | 0 a 59 | */15 |
a cada 15 minutos |
| Hora | 0 a 23 | 3 |
às 3 da manhã |
| Dia (do mês) | 1 a 31 | * |
todo dia |
| Mês | 1 a 12 | * |
todo mês |
| Dia da semana | 0 a 6 (0 = domingo) | 1 |
segunda-feira |
O asterisco significa "qualquer valor". A barra significa intervalo: */15 no campo de minuto é "nos minutos 0, 15, 30 e 45".
O "o quê" é uma linha de comando executada pelo servidor com o seu usuário da hospedagem, no mesmo ambiente de permissões dos seus arquivos. Não é uma URL clicada num navegador, não é um plugin. É um comando.
A documentação oficial do cPanel sobre Cron Jobs é explícita ao recomendar conhecimento de comandos Linux antes de usar o recurso, e alerta que intervalos muito curtos consomem recursos do servidor. Vale levar o aviso a sério: um comando errado agendado a cada minuto erra a cada minuto, e você só descobre pelo consumo.
A tela fica em cPanel > Avançado > Cron Jobs. Ela tem, de cima para baixo: o campo de e-mail de notificação, um seletor de intervalos prontos (Common Settings), os cinco campos de tempo, o campo Command, e a lista dos cron jobs já existentes.
Por que /usr/bin/php pode chamar a versão errada de PHP
O tutorial genérico manda colar /usr/bin/php. Isso pode funcionar, pode chamar uma versão de PHP diferente da que o seu site usa, ou pode não existir. Em servidor cPanel com EasyApache 4, cada versão de PHP fica em um caminho próprio, e a versão do PHP em linha de comando não é necessariamente a mesma que você escolheu no MultiPHP Manager para o site.
Se você chamar o wp-cron.php com uma versão de PHP mais antiga do que a que o site roda, o resultado típico é erro de sintaxe no log e nenhuma tarefa executada, sem nenhum aviso na tela do WordPress.
Como descobrir o caminho do PHP sem usar terminal
Use o próprio cron para se apresentar. Crie um cron temporário, deixe seu e-mail no campo de notificação e agende para daqui a alguns minutos:
which php; php -v; ls -d /opt/cpanel/ea-php*/root/usr/bin/php
O que cada parte faz:
which phpmostra qual PHP o servidor usa por padrão para o seu usuário.php -vimprime a versão desse PHP.ls -d /opt/cpanel/ea-php*/root/usr/bin/phplista os binários de cada versão instalada no servidor, quando o servidor usa EasyApache 4.
O e-mail que chegar traz o resultado. Anote o caminho da versão que corresponde à do seu site (você confere a versão do site em cPanel > MultiPHP Manager). Depois, apague esse cron temporário, ele já cumpriu a função.
Um caminho completo tem esta cara (exemplo, não copie sem conferir o seu):
/opt/cpanel/ea-php82/root/usr/bin/php
Se o ls não retornar nada, o servidor pode não usar EasyApache. Nesse caso use o que o which php respondeu, desde que o php -v mostre a versão que você espera.
Desligar o WP-Cron no wp-config.php
Antes de mexer: baixe uma cópia do arquivo. No cPanel > Gerenciador de Arquivos, entre na pasta do site (normalmente public_html), clique em wp-config.php, clique em Download. Se algo der errado, você sobe esse arquivo de volta e o site volta ao estado anterior. Um erro de digitação em wp-config.php derruba o site inteiro com tela branca, então a cópia não é formalidade.
Onde exatamente colar a linha DISABLE_WP_CRON
- No Gerenciador de Arquivos, com o
wp-config.phpselecionado, clique em Editar (Edit). Se aparecer aviso de codificação, confirme. - Procure a linha que diz
/* That's all, stop editing! Happy publishing. */(em instalações em português, o comentário pode estar traduzido). - Acima dessa linha, cole:
define( 'DISABLE_WP_CRON', true );
- Salve e abra o site em uma aba anônima. Se carregar normalmente, deu certo. Se aparecer tela branca ou erro, restaure o arquivo que você baixou.
A partir daqui, nenhuma visita dispara tarefa agendada. As tarefas continuam registradas e vencidas, esperando alguém chamar o wp-cron.php. Esse alguém passa a ser o cron do cPanel. Se você parar no passo 4 e não criar o cron, nada mais é executado: nem backup, nem post agendado, nem envio de fila de e-mail de plugin.
Criar o cron real no cPanel
Escolher entre chamar o PHP direto ou a URL do wp-cron.php
Há dois formatos que resolvem. Escolha um.
Chamando o PHP diretamente (não depende de rede, não passa pelo servidor web):
/opt/cpanel/ea-php82/root/usr/bin/php /home/USUARIO/public_html/wp-cron.php
Troque o caminho do PHP pelo que você descobriu e USUARIO pelo seu usuário do cPanel. O caminho completo da pasta aparece no topo do Gerenciador de Arquivos.
Chamando pela URL (útil quando o site depende de contexto HTTP, como multisite ou plugins que checam o domínio):
/usr/bin/wget -q -O /dev/null "https://seudominio.com.br/wp-cron.php?doing_wp_cron"
Aqui -q deixa o wget silencioso e -O /dev/null joga fora o HTML retornado, que não interessa.
Por que 15 minutos, e por que "às 3h" não resolve
O seletor Common Settings preenche os cinco campos para você. Referências comuns:
| Objetivo | Minuto | Hora | Dia | Mês | Dia da semana |
|---|---|---|---|---|---|
| A cada 15 minutos | */15 |
* |
* |
* |
* |
| A cada hora, no minuto 0 | 0 |
* |
* |
* |
* |
| Uma vez por dia, às 3h | 0 |
3 |
* |
* |
* |
| Segunda-feira às 4h | 0 |
4 |
* |
* |
1 |
Para substituir o WP-Cron, a cada 15 minutos costuma ser o equilíbrio razoável: as tarefas saem com atraso máximo de 15 minutos e o servidor não é chamado o tempo todo. Se o site tem tarefa que precisa de precisão maior (fila de pedidos de loja, por exemplo), diminua para 5 minutos e acompanhe o consumo de CPU em cPanel > Métricas > Uso de Recursos.
Cuidado com uma armadilha de leitura: agendar "uma vez por dia às 3h" não faz o backup rodar às 3h. Faz o WordPress verificar às 3h se há algo vencido. Qualquer outra tarefa que vencer às 10h vai esperar até as 3h do dia seguinte. Por isso o cron que substitui o WP-Cron deve ser frequente, e o horário específico continua sendo definido dentro do plugin.
Salvar o job e conferir na lista de Cron Jobs Atuais
Preencha os campos, cole o comando em Command e clique em Adicionar Novo Trabalho Cron. O job aparece na tabela Cron Jobs Atuais, no fim da página, com opções de editar e excluir.
Parar a enxurrada de e-mails a cada execução
Por padrão, o cron envia por e-mail tudo que o comando imprime na tela. Um cron a cada 15 minutos que imprime qualquer coisa vira quase cem mensagens por dia na mesma caixa.
Há dois controles, e eles servem para coisas diferentes.
O campo Cron Email, no topo da tela. Ele define para onde vão as notificações de todos os cron jobs da conta. A documentação do cPanel indica que, para desativar as notificações, você limpa esse campo e salva. É o botão geral.
O redirecionamento no fim do comando, que age em um job só. A documentação do cPanel indica acrescentar >/dev/null 2>&1 ao final do comando para desativar o e-mail daquela tarefa específica:
/opt/cpanel/ea-php82/root/usr/bin/php /home/USUARIO/public_html/wp-cron.php >/dev/null 2>&1
Lendo em português: >/dev/null manda a saída normal para o descarte, e 2>&1 manda a saída de erro para o mesmo lugar da saída normal, ou seja, também para o descarte.
Existe um meio-termo mais útil que o silêncio total: mandar tudo para um arquivo de log, que você lê quando desconfiar de algo.
/opt/cpanel/ea-php82/root/usr/bin/php /home/USUARIO/public_html/wp-cron.php >> /home/USUARIO/logs/wpcron.log 2>&1
O >> acrescenta ao fim do arquivo em vez de sobrescrever. Crie a pasta logs antes, pelo Gerenciador de Arquivos.
Esse formato tem um ponto cego que vale corrigir logo: se o comando roda sem erro e sem imprimir nada, o arquivo fica vazio, e vazio é exatamente o que você veria se o cron nunca tivesse rodado. Para separar os dois casos, faça o comando carimbar a data a cada execução:
date >> /home/USUARIO/logs/wpcron.log; /opt/cpanel/ea-php82/root/usr/bin/php /home/USUARIO/public_html/wp-cron.php >> /home/USUARIO/logs/wpcron.log 2>&1
O date escreve a data e hora no log antes de cada chamada. A partir daí, uma linha nova a cada 15 minutos significa "o cron disparou", e a ausência de linhas novas significa "o cron não disparou".
E marque na agenda: arquivo de log cresce. Com o carimbo de data, ele cresce sempre, mesmo sem erro. Ou você limpa de tempos em tempos, ou usa > (sobrescreve a cada execução) no lugar de >>, aceitando guardar só a última execução.
Recomendação prática: deixe o e-mail ativo nos primeiros dias, para ver o que o comando responde. Depois que estiver estável, troque para log em arquivo ou para /dev/null.
Como confirmar que o cron rodou, e o que checar quando não rodou
Três formas de verificar, da mais simples para a mais técnica:
- Pelo plugin. Abra o painel do plugin de backup ou de segurança e olhe a data e hora da última execução. Se avançou depois do horário do cron, está funcionando. Essa é a verificação que realmente prova que a fila foi consumida.
- Pelo log que você criou. Abra
wpcron.logno Gerenciador de Arquivos. Com o carimbo dedateno comando, cada execução deixa uma linha com data e hora: linhas novas aparecendo no intervalo esperado significam que o cron está disparando. Sem o carimbo, um arquivo vazio é ambíguo, pode ser "rodou em silêncio" ou "nunca rodou", e aí você precisa conferir pelo item 1. - Por um plugin de inspeção de cron. Existem plugins que listam os eventos agendados do WordPress, mostram o próximo horário previsto e permitem executar um evento na hora. Com o WP-Cron desligado, é a forma mais direta de confirmar que a fila está sendo consumida.
Problemas comuns e o que costuma estar por trás:
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| E-mail do cron com "command not found" | Caminho do PHP ou do wget errado | Refaça a descoberta do caminho com o cron temporário |
| E-mail com erro de sintaxe do PHP | Versão de PHP da linha de comando mais antiga que a do site | Use o caminho completo da versão correta, não php puro |
| Nenhuma linha nova no log com carimbo de data | O cron não está disparando: job não foi salvo, ou o comando falhou antes de escrever | Confira se o job aparece em Cron Jobs Atuais e reative o e-mail de notificação por um dia |
| Log com linhas de data, mas plugin parado no mesmo horário | Caminho do wp-cron.php errado, o PHP roda e não encontra o arquivo |
Confira a pasta real do site no Gerenciador de Arquivos, pode não ser public_html |
| Roda, mas nenhuma tarefa é executada | DISABLE_WP_CRON não foi salvo, ou foi colocado depois da linha de "stop editing" |
Reabra o wp-config.php e confira a posição da linha |
| Versão por URL retorna erro 401 | Site protegido por senha de diretório | Prefira o formato chamando o PHP diretamente |
| Muitos e-mails por dia | Comando imprime saída e o Cron Email está preenchido | Acrescente >/dev/null 2>&1 ou limpe o campo de e-mail |
Se você precisar voltar tudo como estava: apague o cron job na lista de Cron Jobs Atuais e remova (ou troque para false) a linha DISABLE_WP_CRON no wp-config.php. O WordPress volta a disparar tarefas por visita no minuto seguinte.
O que mais vale a pena colocar no cron, e o que não vale
Depois que a tela deixa de ser assustadora, ela resolve outras rotinas que hoje você faz na mão:
- Backup por script, quando você já tem um comando que gera o arquivo. Agende para horário de baixo movimento e mande a saída para um log, não para o e-mail.
- Limpeza de arquivos temporários em pastas que você controla, uma vez por semana. Escreva o caminho completo e confira duas vezes antes de salvar: comando de exclusão agendado com caminho errado apaga com precisão o que você não queria.
- Chamada de scripts do WP-CLI, quando a hospedagem oferece o comando, para tarefas como otimizar tabelas.
O que não vale colocar em cron:
- Tarefa que demora mais que o intervalo. Se o comando leva 20 minutos e você agenda a cada 15, duas execuções passam a se sobrepor e o consumo dobra.
- Intervalo de um minuto por precaução. É o caminho mais rápido para estourar limite de recursos, e a documentação do cPanel alerta justamente para isso.
- Comando copiado de tutorial sem entender cada pedaço. O cron executa com as suas permissões, em silêncio, para sempre, até alguém desligar.
Duas últimas conferências antes de fechar a aba: o cron job aparece na lista Cron Jobs Atuais com os cinco campos preenchidos como você pretendia, e o e-mail de notificação está configurado do jeito que você decidiu (ativo para acompanhar, ou vazio depois da fase de teste). Todos os caminhos deste artigo são exemplos; o seu caminho de PHP e a sua pasta de instalação você confirma na própria conta antes de salvar.
Referências
- Documentação oficial do cPanel — Cron Jobs. Consultado em 2026-09-16.