Ejecutar Laravel Queue en cPanel con Cron

Laravel ofrece un sistema de colas muy útil para ejecutar tareas en segundo plano, como enviar correos, generar reportes o procesar subidas de archivos pesadas. En un VPS solemos usar Supervisor para mantener vivo el worker de colas, pero en hosting compartido con cPanel no está disponible. La alternativa práctica es programar el worker con un cronjob.

Paso 1 Configura el worker en el Scheduler de Laravel. En app/Console/Kernel.php añade una tarea programada que invoque el worker de colas y se detenga cuando no haya más trabajos. Un ejemplo directo sería este flujo en el método schedule: $schedule->command(queue:work --stop-when-empty)->everyMinute()->withoutOverlapping();

Qué hace cada parte. queue:work ejecuta el worker de colas. --stop-when-empty detiene el proceso cuando la cola queda vacía para que el cron lo relance al siguiente minuto. everyMinute programa la ejecución cada minuto. withoutOverlapping evita que se solapen procesos si uno anterior sigue en ejecución.

Paso 2 Crea el cronjob en cPanel. Entra en cPanel, sección Cron Jobs, y añade una tarea por minuto que ejecute el scheduler de Laravel. Ejemplos según la versión de PHP del servidor:

* * * * * /usr/local/bin/ea-php81 /home/{account_name}/live/artisan schedule:run

Si tu hosting usa PHP 8.4:

* * * * * /usr/local/bin/ea-php84 /home/{account_name}/live/artisan schedule:run

Ajusta los valores según tu entorno. {account_name} es el nombre de tu cuenta de hosting. live es el directorio del proyecto Laravel. Cambia ea-php81, ea-php82 o ea-php84 por la versión activa en tu cPanel.

Recomendaciones rápidas. Verifica que el driver de colas esté bien configurado en el archivo de entorno, por ejemplo database o redis. Activa logs para revisar posibles fallos. Si tu cola procesa tareas pesadas, considera aumentar timeout o separar colas por prioridad. Comprueba periódicamente que schedule:run se ejecuta en el minuto previsto.

En Q2BSTUDIO ayudamos a empresas a desplegar y optimizar aplicaciones Laravel en entornos compartidos y en la nube, combinando buenas prácticas DevOps con seguridad y escalabilidad. Si necesitas soporte para despliegues, observabilidad o alta disponibilidad, nuestros servicios cloud AWS y Azure te facilitan infraestructuras robustas y optimizadas. Si además buscas crear funcionalidades avanzadas o integrar colas y procesos de negocio en tus plataformas, desarrollamos aplicaciones y software a medida alineados con tus objetivos.

Somos especialistas en inteligencia artificial, agentes IA e ia para empresas, ciberseguridad y pentesting, servicios inteligencia de negocio y power bi, así como en automatización de procesos. Nuestro equipo diseña soluciones end to end que combinan software a medida, prácticas seguras de desarrollo, servicios cloud aws y azure y analítica para aportar valor real y sostenible.