Download the PHP package huangdijia/laravel-horizon-restart without Composer
On this page you can find all versions of the php package huangdijia/laravel-horizon-restart. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download huangdijia/laravel-horizon-restart
More information about huangdijia/laravel-horizon-restart
Files in huangdijia/laravel-horizon-restart
Package laravel-horizon-restart
Short Description Horizon Restart for Laravel.
License MIT
Homepage https://github.com/huangdijia/laravel-horizon-restart
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-horizon-restart
Laravel Horizon Restart
中文文档
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.
Features
- 🚀 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
Requirements
- PHP 8.2 or higher
- Laravel 11.x or 12.x
- Laravel Horizon 5.x or 6.x
Installation
Install the package via Composer:
The service provider will be automatically registered.
Usage
Basic Usage
To restart all Horizon supervisors across all servers:
This 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
How It Works
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
Use Cases
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
Configuration
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
Comparison with Other Methods
| Method | Single Server | Multiple Servers | Graceful |
|---|---|---|---|
horizon:terminate |
✅ | ❌ | ✅ |
queue:restart |
✅ | ✅ | ✅ |
horizon:restart (this package) |
✅ | ✅ | ✅ |
Development
Testing
Run the test suite:
Code Style
Fix code style issues:
Static Analysis
Run static analysis:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
License
The MIT License (MIT). Please see License File for more information.
Credits
Links
All versions of laravel-horizon-restart with dependencies
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/console Version ^10.0|^11.0|^12.0
illuminate/bus Version ^10.0|^11.0|^12.0
laravel/horizon Version ^5.0|^6.0