Começar

Como configurar tarefas cron (tarefas agendadas).

Rode um script a cada poucos minutos, de hora em hora ou todo dia: como adicionar uma tarefa cron, testá-la com Executar agora e receber a saída por e-mail.

2 MIN DE LEITURA

O cron executa um comando de acordo com um agendamento: o cron do WordPress, o scheduler do Laravel, um script de backup, uma tarefa de limpeza.

Onde fica

Sites → seu site → Tarefas cron (ou busque «cron» no topo do painel).

Como adicionar uma tarefa

  1. Clique em Adicionar tarefa.
  2. Quando — escolha o agendamento: a cada minuto, a cada N minutos, de hora em hora, todo dia num horário, em dias úteis, num dia de cada mês — ou escreva a sua própria expressão cron.
  3. Comando — o que executar, por exemplo:
cd ~/public_html && php artisan schedule:run
/usr/local/bin/php ~/public_html/wp-cron.php
  1. Clique em Salvar.

A tarefa roda com o usuário da sua hospedagem, a partir da sua pasta pessoal. Use caminhos completos ou faça um cd antes.

Como testar

Executar agora roda a tarefa na hora e mostra a saída e o código de saída (0 = tudo certo). A execução é interrompida depois de um minuto — tarefas longas devem ficar no agendamento, não no Executar agora.

Saída por e-mail

Enviar a saída por e-mail define um endereço para todas as tarefas do site: tudo o que uma tarefa imprimir é enviado para ele. Tarefas que não imprimem nada não enviam nada. Para silenciar uma tarefa, acrescente > /dev/null 2>&1 ao comando dela.

Como desativar uma tarefa

A chave ao lado da tarefa a desativa sem excluí-la («Tarefa desativada — ela continua aqui»). Excluir apaga a tarefa.

WordPress: troque o wp-cron por um cron de verdade

O WordPress executa as tarefas agendadas dele nas visitas, o que pesa em sites movimentados e falha em sites com pouco acesso. Adicione ao wp-config.php:

define('DISABLE_WP_CRON', true);

e crie uma tarefa a cada 5 minutos:

cd ~/public_html && /usr/local/bin/php wp-cron.php > /dev/null 2>&1

Boas práticas

  • Não rode tarefas pesadas a cada minuto; a cada 5–15 minutos é mais do que suficiente para a maioria das tarefas.
  • Faça scripts que possam rodar duas vezes sem problema (um arquivo de lock ou a verificação de que a execução anterior terminou).
  • Grave um log em arquivo quando precisar de histórico: >> ~/logs/job.log 2>&1.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte