laravel-verification

name laravel-verification description Bucle de verificación para proyectos Laravel: verificaciones de entorno, linting, análisis estático, pruebas con cobertura, escaneos de seguridad y preparación para despliegue. origin ECC Bucle de Verificación Laravel Ejecutar antes de PRs, después de cambios importantes y antes del despliegue. Cuándo Usar Antes de abrir un pull request para un proyecto Laravel Después de refactorizaciones importantes o actualizaciones de dependencias Verificación previa al despliegue para staging o producción Ejecutar el pipeline completo de lint -> prueba -> seguridad -> preparación para despliegue Cómo Funciona Ejecutar las fases secuencialmente desde las verificaciones de entorno hasta la preparación para despliegue, de modo que cada capa construya sobre la anterior. Las verificaciones de entorno y Composer son requisitos previos para todo lo demás; detener inmediatamente si fallan. El linting/análisis estático debe estar limpio antes de ejecutar pruebas completas y cobertura. Las revisiones de seguridad y migraciones ocurren después de las pruebas para verificar el comportamiento antes de los pasos de datos o lanzamiento. La preparación de build/despliegue y las verificaciones de cola/scheduler son los últimos filtros; cualquier fallo bloquea el lanzamiento. Fase 1: Verificaciones de Entorno php -v composer --version php artisan --version Verificar que .env esté presente y que las claves requeridas existan Confirmar APP_DEBUG=false para entornos de producción Confirmar que APP_ENV coincida con el despliegue objetivo ( production , staging ) Si se usa Laravel Sail localmente: ./vendor/bin/sail php -v ./vendor/bin/sail artisan --version Fase 1.5: Composer y Autoload composer validate composer dump-autoload -o Fase 2: Linting y Análisis Estático vendor/bin/pint -- test vendor/bin/phpstan analyse Si el proyecto usa Psalm en lugar de PHPStan: vendor/bin/psalm Fase 3: Pruebas y Cobertura php artisan test Cobertura (CI): XDEBUG_MODE=coverage php artisan test --coverage Ejemplo de pipeline CI (formato -> análisis estático -> pruebas): vendor/bin/pint -- test vendor/bin/phpstan analyse XDEBUG_MODE=coverage php artisan test --coverage Fase 4: Seguridad y Verificación de Dependencias composer audit Fase 5: Base de Datos y Migraciones php artisan migrate --pretend php artisan migrate:status Revisar cuidadosamente las migraciones destructivas Asegurarse de que los nombres de archivo de migración sigan el formato Y_m_d_His_* (ej. 2025_03_14_154210_create_orders_table.php ) y describan el cambio claramente Asegurarse de que los rollbacks sean posibles Verificar los métodos down() y evitar la pérdida irreversible de datos sin copias de seguridad explícitas Fase 6: Preparación de Build y Despliegue php artisan optimize:clear php artisan config:cache php artisan route:cache php artisan view:cache Asegurarse de que los warmups de caché tengan éxito en la configuración de producción Verificar que los workers de cola y el scheduler estén configurados Confirmar que storage/ y bootstrap/cache/ sean escribibles en el entorno objetivo Fase 7: Verificaciones de Cola y Scheduler php artisan schedule:list php artisan queue:failed Si se usa Horizon: php artisan horizon:status Si queue:monitor está disponible, usarlo para verificar el backlog sin procesar jobs: php artisan queue:monitor default --max=100 Verificación activa (solo staging): despachar un job no-op a una cola dedicada y ejecutar un solo worker para procesarlo (asegurarse de que esté configurada una conexión de cola que no sea sync ). php artisan tinker --execute= "dispatch((new App\\Jobs\\QueueHealthcheck())->onQueue('healthcheck'))" php artisan queue:work --once --queue=healthcheck Verificar que el job produjera el efecto secundario esperado (entrada de log, fila en tabla de healthcheck o métrica). Ejecutar esto solo en entornos que no sean producción donde procesar un job de prueba sea seguro. Ejemplos Flujo 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