Loop de Verificação do Laravel

Execute antes dos PRs, após grandes mudanças e antes da implantação.

Quando Usar

• Antes de abrir um pull request para um projeto Laravel
• Após refatorações importantes ou atualizações de dependências
• Verificação pré-implantação para staging ou produção
• Execução do pipeline completo: lint -> testes -> segurança -> prontidão para implantação

Como Funciona

• Execute as fases sequencialmente, desde as verificações de ambiente até a prontidão para implantação, para que cada camada se baseie na anterior.
• As verificações de ambiente e Composer bloqueiam todo o resto; pare imediatamente se falharem.
• O linting/análise estática deve estar limpo antes de executar testes completos e cobertura.
• Revisões de segurança e migrações ocorrem após os testes, para que você verifique o comportamento antes das etapas de dados ou lançamento.
• A prontidão de build/implantação e as verificações de fila/scheduler são os portões finais; qualquer falha bloqueia o lançamento.

Fase 1: Verificações de Ambiente

php -v
composer --version
php artisan --version

• Verifique se .env está presente e se as chaves necessárias existem
• Confirme APP_DEBUG=false para ambientes de produção
• Confirme se APP_ENV corresponde ao destino da implantação (production, staging)

Se estiver usando Laravel Sail localmente:

./vendor/bin/sail php -v
./vendor/bin/sail artisan --version

Fase 1.5: Composer e Autoload

composer validate
composer dump-autoload -o

Fase 2: Linting e Análise Estática

vendor/bin/pint --test
vendor/bin/phpstan analyse

Se o seu projeto usa Psalm em vez de PHPStan:

vendor/bin/psalm

Fase 3: Testes e Cobertura

php artisan test

Cobertura (CI):

XDEBUG_MODE=coverage php artisan test --coverage

Exemplo de CI (formato -> análise estática -> testes):

vendor/bin/pint --test
vendor/bin/phpstan analyse
XDEBUG_MODE=coverage php artisan test --coverage

Fase 4: Verificações de Segurança e Dependências

composer audit

Fase 5: Banco de Dados e Migrações

php artisan migrate --pretend
php artisan migrate:status

• Revise cuidadosamente as migrações destrutivas
• Garanta que os nomes dos arquivos de migração sigam Y_m_d_His_* (por exemplo, 2025_03_14_154210_create_orders_table.php) e descrevam a mudança claramente
• Garanta que os rollbacks sejam possíveis
• Verifique os métodos down() e evite perda de dados irreversível sem backups explícitos

Fase 6: Prontidão de Build e Implantação

php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

• Garanta que os aquecimentos de cache sejam bem-sucedidos na configuração de produção
• Verifique se os workers de fila e o scheduler estão configurados
• Confirme se storage/ e bootstrap/cache/ são graváveis no ambiente de destino

Fase 7: Verificações de Fila e Scheduler

php artisan schedule:list
php artisan queue:failed

Se o Horizon for usado:

php artisan horizon:status

Se queue:monitor estiver disponível, use-o para verificar o backlog sem processar jobs:

php artisan queue:monitor default --max=100

Verificação ativa (apenas staging): envie um job "no-op" para uma fila dedicada e execute um único worker para processá-lo (garanta que uma conexão de fila não-sync esteja configurada).

php artisan tinker --execute="dispatch((new App\\Jobs\\QueueHealthcheck())->onQueue('healthcheck'))"
php artisan queue:work --once --queue=healthcheck

Verifique se o job produziu o efeito colateral esperado (entrada de log, linha na tabela de healthcheck ou métrica).

Execute isso apenas em ambientes não produtivos onde o processamento de um job de teste é seguro.

Exemplos

Fluxo mínimo:

php -v
composer --version
php artisan --version
composer validate
vendor/bin/pint --test
vendor/bin/phpstan analyse
php artisan test
composer audit
php artisan migrate --pretend
php artisan config:cache
php artisan queue:failed

Pipeline estilo CI:

composer validate
composer dump-autoload -o
vendor/bin/pint --test
vendor/bin/phpstan analyse
XDEBUG_MODE=coverage php artisan test --coverage
composer audit
php artisan migrate --pretend
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan schedule:list