laravel-verification

Bucle de Verificación Laravel

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

Cuándo Usarlo

• Antes de abrir un pull request para un proyecto Laravel
• Después de refactorizaciones grandes o actualizaciones de dependencias
• Verificación previa al despliegue en entornos de staging o producción
• Ejecución completa del pipeline de linting → pruebas → seguridad → preparación para despliegue

Cómo Funciona

• Ejecuta las fases secuencialmente desde comprobaciones de entorno hasta preparación para despliegue, de modo que cada capa se basa en la anterior.
• Las comprobaciones de entorno y Composer actúan como puerta de entrada; detén 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 lanzamiento.
• Las comprobaciones de compilación/preparación para despliegue y colas/programador son las puertas finales; cualquier fallo bloquea el lanzamiento.

Fase 1: Comprobaciones de Entorno

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

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

Si usas Laravel Sail localmente:

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

Fase 1.5: Composer y Autocarga

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 los 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 las reversiones 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 Compilación y Despliegue

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

• Asegúrate de que los warmups de caché tengan éxito en la configuración de producción
• Verifica que los workers de colas y el programador estén configurados
• Confirma que storage/ y bootstrap/cache/ tengan permisos de escritura en el entorno de destino

Fase 7: Comprobaciones de Colas y Programador

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 staging): despacha un trabajo sin operación a una cola dedicada y ejecuta un worker único 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 haya producido el efecto secundario esperado (entrada de registro, fila en la 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