blog
Painéis

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.

JR · · 11 min de leitura · 3 tabelas · 8 blocos de código

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
  1. Por que o backup agendado às 3h nunca roda
  2. O que a tela de Cron Jobs do cPanel faz
  3. Por que /usr/bin/php pode chamar a versão errada de PHP
  4. Desligar o WP-Cron no wp-config.php
  5. Criar o cron real no cPanel
  6. Parar a enxurrada de e-mails a cada execução
  7. Como confirmar que o cron rodou, e o que checar quando não rodou
  8. 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:

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

  1. No Gerenciador de Arquivos, com o wp-config.php selecionado, clique em Editar (Edit). Se aparecer aviso de codificação, confirme.
  2. Procure a linha que diz /* That's all, stop editing! Happy publishing. */ (em instalações em português, o comentário pode estar traduzido).
  3. Acima dessa linha, cole:
define( 'DISABLE_WP_CRON', true );
  1. 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:

  1. 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.
  2. Pelo log que você criou. Abra wpcron.log no Gerenciador de Arquivos. Com o carimbo de date no 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.
  3. 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:

O que não vale colocar em cron:

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

  1. Documentação oficial do cPanel — Cron Jobs. Consultado em 2026-09-16.
Leia também