laravel-verification

Bucle de Verificación Laravel

Ejecutar antes de PRs, después de cambios importantes y antes del despliegue.

Cuándo Usarlo

• Antes de abrir un pull request para un proyecto Laravel
• Después de refactorizaciones importantes o actualizaciones de dependencias
• Verificación previa al despliegue en staging o producción
• Ejecutar el pipeline completo de lint -> pruebas -> seguridad -> preparación para despliegue

Cómo Funciona

• Las fases se ejecutan secuencialmente desde las comprobaciones de entorno hasta la preparación para despliegue, de modo que cada capa se construye sobre la anterior.
• Las comprobaciones de entorno y de Composer actúan como puerta de entrada; detenerse inmediatamente si fallan.
• El linting y análisis estático deben estar limpios antes de ejecutar las pruebas completas y la cobertura.
• Las revisiones de seguridad y migraciones ocurren después de las pruebas, para verificar el comportamiento antes de los pasos de datos o publicación.
• Las comprobaciones de construcción/despliegue y de colas/planificador son las puertas finales; cualquier fallo bloquea la publicación.

Fase 1: Comprobaciones de Entorno

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

• Verificar que .env esté presente y que existan las claves requeridas
• Confirmar APP_DEBUG=false para entornos de producción
• Confirmar que APP_ENV coincida con el despliegue objetivo (production, staging)

Si usas 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 tu 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 CI (formato -> análisis estático -> pruebas):

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

Fase 4: Comprobaciones de Seguridad y Dependencias

composer audit

Fase 5: Base de Datos y Migraciones

php artisan migrate --pretend
php artisan migrate:status

• Revisa cuidadosamente las migraciones destructivas
• Asegúrate de que los nombres de archivos de migración sigan el formato Y_m_d_His_* (ej: 2025_03_14_154210_create_orders_table.php) y describan claramente el cambio
• Asegúrate de que los rollbacks sean posibles
• Verifica los métodos down() y evita la pérdida irreversible de datos sin copias de seguridad explícitas

Fase 6: Preparación para Construcción y Despliegue

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

• Asegúrate de que los calentamientos de caché tengan éxito en la configuración de producción
• Verifica que los workers de colas y el planificador estén configurados
• Confirma que storage/ y bootstrap/cache/ sean escribibles en el entorno de destino

Fase 7: Comprobaciones de Colas y Planificador

php artisan schedule:list
php artisan queue:failed

Si se usa Horizon:

php artisan horizon:status

Si queue:monitor está disponible, úsalo para verificar el backlog sin procesar trabajos:

php artisan queue:monitor default --max=100

Verificación activa (solo en staging): enviar un trabajo no operativo a una cola dedicada y ejecutar un único worker para procesarlo (asegúrate 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

Verifica que el trabajo produjo el efecto secundario esperado (entrada de log, fila en tabla de healthcheck o métrica).

Ejecuta esto solo en entornos que no sean producción, donde sea seguro procesar un trabajo de prueba.

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