A Laravel package that extends Laravel Horizon with the ability to restart supervisors across multiple servers, similar to php artisan queue:restart but specifically designed for Horizon workers.
- 🚀 Restart all Horizon supervisors across multiple servers with a single command
- 🔄 Graceful termination of workers similar to
queue:restart - 📦 Automatic service provider registration
- 🎯 Works seamlessly with Horizon's queue distribution
- ⚡ Zero downtime deployments for Horizon workers
- PHP 8.2 or higher
- Laravel 11.x or 12.x
- Laravel Horizon 5.x or 6.x
Install the package via Composer:
composer require huangdijia/laravel-horizon-restartThe service provider will be automatically registered.
To restart all Horizon supervisors across all servers:
php artisan horizon:restartThis command will:
- Discover all running Horizon supervisors
- Dispatch a restart job to each supervisor's queue
- Gracefully terminate each supervisor (similar to
horizon:terminate) - Horizon will automatically restart the supervisors
When you run horizon:restart, the package:
- Discovers Supervisors: Queries the Horizon master supervisor repository to find all active supervisors
- Dispatches Jobs: Creates a
HorizonRestartJobfor each supervisor and dispatches it to that supervisor's queue - Executes Termination: Each job runs on its respective server and calls
horizon:terminatelocally - Auto Restart: Horizon's process monitoring automatically restarts terminated supervisors
This approach ensures that:
- All servers receive the restart signal
- Workers finish their current jobs before terminating
- No jobs are lost during the restart process
- Each server restarts independently
This package is particularly useful for:
- Multi-Server Deployments: When you have Horizon running on multiple servers and need to restart all of them
- Code Deployments: After deploying new code, restart all workers across all servers
- Configuration Changes: When Horizon configuration changes and all workers need to reload
- Memory Management: Periodic restarts to clear memory leaks or reset worker state
The package automatically configures a special supervisor for handling restart jobs. No manual configuration is required.
The restart supervisor is automatically configured with:
- Connection: Uses the same connection as your first Horizon environment
- Queue: Uses Horizon's internal queue name
- Processes: 1 worker to handle restart jobs
- Tries: 3 attempts per job
| Method | Single Server | Multiple Servers | Graceful |
|---|---|---|---|
horizon:terminate |
✅ | ❌ | ✅ |
queue:restart |
✅ | ✅ | ✅ |
horizon:restart (this package) |
✅ | ✅ | ✅ |
Run the test suite:
composer testFix code style issues:
composer cs-fixRun static analysis:
composer analyseContributions are welcome! Please feel free to submit a Pull Request.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.