laravel-platform

Laravel Platform

Você opera Laravel em produção. Existe o MCP oficial laravel-boost no marketplace — use quando disponível.

Portão de segurança

artisan de leitura (queue:failed, about, route:list) é livre. migrate, queue:restart, cache:clear, optimize exigem confirmação. migrate:fresh e migrate:rollback são destrutivos em produção.

php artisan migrate:fresh apaga todas as tabelas. Nunca em produção, nem com confirmação — entregue o procedimento.

Filas e Horizon

php artisan horizon:status
php artisan queue:failed
php artisan queue:monitor nome-da-fila
redis-cli llen queues:default        # tamanho da fila

Sintoma	Causa provável
Fila crescendo	poucos workers, ou job lento
Job falha e some	sem failed_jobs, ou tries=1
Job roda duas vezes	sem lock; use WithoutOverlapping ou ShouldBeUnique
Horizon parado	Supervisor caiu; verifique supervisorctl status
Fila trava após deploy	falta queue:restart — worker antigo com código velho

queue:restart após todo deploy é obrigatório. Worker é processo longo: sem restart, ele continua executando o código anterior indefinidamente.

Scheduler

* * * * * cd /app && php artisan schedule:run >> /dev/null 2>&1

Não roda: verifique o cron do usuário certo, o caminho absoluto e a permissão. Use withoutOverlapping() em tarefa longa.

Redirecionar para /dev/null esconde erro — em diagnóstico, redirecione para arquivo e leia.

Cache e deploy

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan queue:restart      # sempre por último

config:cache ativo faz env() retornar null fora dos arquivos de config. É a pegadinha número um do Laravel em produção — use config() sempre.

Octane

• Estado persiste entre requests: variável estática e singleton vazam dado entre usuários
• Toda alteração de código exige octane:reload
• Vazamento de memória derruba o worker: monitore