CLI no PHP: scripts confiáveis e cron

CLI no PHP: scripts confiáveis e cron — PHP moderno é uma plataforma sólida — o segredo é disciplinar estrutura, erros e dependências.

O objetivo aqui é prático: decisões pequenas que melhoram confiabilidade e manutenção. Se você já lidou com bugs intermitentes, sabe o valor de padrões simples.

Como eu abordo

• Comece com o caso real (o que está quebrando ou ficando caro).
• Defina uma regra pequena e aplicável (sem reescrever tudo).
• Instrumente: teste, log ou métrica para confirmar melhora.
• Documente o “porquê” em poucas linhas para não perder contexto.

Armadilhas comuns

• Otimizar cedo sem medir.
• Misturar camadas (controller fazendo SQL, por exemplo).
• Não registrar contexto (request id, rota, usuário) nos logs.
• Apostar em “mágica” de framework sem entender o fluxo.

Checklist rápido

• Qual é o risco principal (segurança, performance, disponibilidade)?
• Como eu valido a mudança (teste, log, métrica)?
• O que pode dar errado e como reverter?
• Quem mantém isso daqui a 3 meses?

Trecho de código

<?php
$pdo = new PDO($dsn, $user, $pass, [
  PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
  PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

$stmt = $pdo->prepare('SELECT id, email FROM users WHERE email = :email');
$stmt->execute(['email' => $email]);
$user = $stmt->fetch();

Se esta nota te poupou tempo, anote o que você ajustou e por quê. Isso vira um guia interno com o tempo.