# 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.

> 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.

João Rizzon · 2026-09-16 · Painéis

---

## 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](https://docs.cpanel.net/cpanel/advanced/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 php` mostra qual PHP o servidor usa por padrão para o seu usuário.
- `php -v` imprime a versão desse PHP.
- `ls -d /opt/cpanel/ea-php*/root/usr/bin/php` lista 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.php` selecionado, 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:

```php
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.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.
- **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.

