O cron do WordPress não é um cron
O WP-Cron só roda quando alguém visita o site. Por que post agendado perde a hora, backup não sai e "só olhar" pode atualizar um plugin, e como resolver.
A gente tinha um script que só lia arquivos de um WordPress de teste. Nenhuma escrita, nenhuma alteração. No meio da leitura, um arquivo do Yoast simplesmente sumiu. Numa rodada anterior, o site tinha ficado preso em modo de manutenção.
O culpado era o cron do WordPress. Carregar o WordPress, mesmo para ler, conta como uma visita, e a visita dispara as tarefas agendadas. Uma delas era a atualização automática do Yoast, que rodou ali, no meio do nosso script.
O WP-Cron roda quando alguém aparece
O nome engana. O cron do sistema operacional roda no relógio: às 3h, roda. O WP-Cron não. A documentação do WordPress diz com todas as letras que ele não roda continuamente e só é disparado quando uma página carrega. A cada visita, o WordPress confere se há tarefa vencida e executa.
Daí saem dois problemas opostos, e quem cuida de muitos sites vê os dois.
Site com pouca visita: a tarefa atrasa
A própria documentação dá o exemplo: uma tarefa marcada para as 14h, num site sem visitas até as 17h, só roda às 17h. O post agendado que sai com horas de atraso, o famoso "agendamento perdido", o e-mail de lembrete que não chega e o backup do plugin que não saiu de madrugada têm, muitas vezes, essa causa.
Em site institucional de cliente pequeno, que tem visita de dia e silêncio de noite, toda tarefa noturna está sujeita a isso.
Site com muita visita: tarefa no meio do expediente
O outro lado é o que mordeu o nosso script. As tarefas rodam na visita de alguém, no processo que estava montando a página para essa pessoa. Uma tarefa pesada, como uma atualização, a importação de um feed ou um backup feito por plugin, deixa aquela visita lenta, e pode deixar o site em manutenção no pior momento.
A lição que a gente tirou: no WordPress, "só olhar" pode mudar o site. Antes de uma manutenção ou de um script de leitura, saiba o que está agendado para rodar.
A saída: o cron de verdade
O WordPress permite desligar o disparo por visita e chamar o cron pelo agendador do servidor, que roda no relógio. A documentação mostra os dois passos. Primeiro, no wp-config.php:
define( 'DISABLE_WP_CRON', true );
Depois, no agendador do servidor, uma chamada ao wp-cron.php no intervalo que fizer sentido, como a cada 15 minutos:
*/15 * * * * wget --delete-after https://site-do-cliente.com.br/wp-cron.php
Com isso, as tarefas rodam na hora, mesmo sem visitas, e saem do caminho de quem está navegando.
Onde não dá
Muita hospedagem compartilhada não dá acesso ao agendador do sistema. Aí as opções são o painel da hospedagem, que às vezes tem uma tela de tarefas agendadas, ou um serviço externo que chama o wp-cron.php de tempos em tempos. Só não desligue o WP-Cron sem colocar outro no lugar: as tarefas param de rodar, e nada avisa.
Para conferir se o cron de um site está saudável, o Site Health do WordPress, em Ferramentas, acusa quando as tarefas agendadas estão atrasadas.
Com o WP-CLI, dá para ver a fila inteira: wp cron event list mostra cada tarefa, o gancho que ela dispara e quando ela deve rodar. Tarefa com data no passado, num site com cron saudável, não deveria existir por muito tempo. E vale olhar o que os plugins agendaram: não é raro achar tarefa de plugin que nem está mais instalado, rodando ou tentando rodar a cada visita.
Para ir além
- Como atualizar plugins em dezenas de sites WordPress sem quebrar nenhum: atualizar quando você escolhe, e não quando alguém visita.
- Site WordPress lento: o que conferir antes de culpar a hospedagem: o cron é um dos suspeitos.
O agendamento que não depende de visita
No Sites Station, o post agendado fica guardado no painel, e o próprio Sites Station publica na hora marcada pela API do site. Ele não depende do cron do WordPress do cliente, então não sai atrasado por falta de visita, seja um site ou trinta.
Dá para ver isso com os seus sites: teste grátis, sem cadastrar cartão.