How to install and set up Laravel Horizon in a Laravel project?

Install via Composer, publish the configuration file with 'artisan horizon:install', and configure workers in the 'horizon.php' file. The official Laravel documentation provides detailed steps for setup and deployment.

Laravel Horizon vs using Supervisor directly for queue management?

Horizon adds a visual dashboard and code-based configuration, while Supervisor is a bare-bones process manager. Horizon is better for monitoring and team collaboration, but Supervisor is lighter if you only need basic process control.

Does Horizon work with database queues or only Redis?

Horizon is specifically designed for Redis queues only. If you're using Laravel's database queue driver, you'll need to rely on the basic queue worker without Horizon's dashboard features.

How to monitor job failures and retry them with Horizon?

Horizon's dashboard includes a 'Failed Jobs' section that lists failures with details and allows retries. You can also configure notifications and job retry logic in the Horizon configuration file.

What's the performance impact of running Horizon in production?

Horizon runs as a separate process and adds minimal overhead to your application, but it requires Redis and additional system resources for monitoring, which might affect low-resource environments.

Can I use Horizon with Laravel Octane or other performance optimizations?

Yes, Horizon is compatible with Laravel Octane and other optimizations, but ensure proper configuration to avoid process conflicts. Refer to Laravel's documentation for integration details.

Open-Awesome

Horizon

MITPHPv5.47.2

Dashboard and code-driven configuration for Laravel Redis queues.

Visit Website GitHub

4.1k stars733 forks0 contributors

What is Horizon?

Laravel Horizon is a dashboard and configuration tool for managing Laravel Redis queues. It provides real-time monitoring of job throughput, runtime, and failures, making queue management more transparent and efficient. All worker configuration is stored in a single file, allowing teams to collaborate through source control.

Target Audience

Laravel developers who use Redis queues and need better visibility and management of their queue systems.

Value Proposition

Developers choose Horizon for its elegant dashboard that simplifies queue monitoring and its code-driven configuration approach that keeps settings version-controlled and collaborative.

Overview

Dashboard and code-driven configuration for Laravel queues.

Use Cases

Best For

Monitoring Laravel Redis queue performance and job failures
Managing worker configuration through code in team environments
Gaining real-time insights into job throughput and runtime
Simplifying queue management with a visual dashboard
Keeping queue configuration in source control for collaboration
Laravel applications that rely heavily on background job processing

Not Ideal For

Projects not using Laravel or Redis queues (e.g., those relying on database or SQS drivers)
Small applications where basic Laravel queue workers with Supervisor provide sufficient functionality without the dashboard overhead
Teams needing multi-backend queue support or flexibility beyond Redis

Pros & Cons

Pros

Elegant Dashboard Interface

Provides a beautiful, real-time dashboard for monitoring job throughput, runtime, and failures, as shown in the README with an example image, enhancing visibility without custom tooling.

Code-Driven Configuration

Stores all worker settings in a single configuration file, enabling version control and team collaboration, which is emphasized in the introduction as a key feature for consistency.

Seamless Redis Integration

Specifically designed for Laravel powered Redis queues, ensuring optimized performance and easy setup within the Laravel ecosystem, as highlighted in the key features.

Real-Time Metrics Monitoring

Tracks key performance indicators like job throughput and runtime in real-time, making queue management transparent and efficient, as stated in the README's introduction.

Cons

Redis-Only Limitation

Horizon only supports Redis queues, so it's incompatible with Laravel's other queue drivers like database or SQS, which can be a deal-breaker for mixed environments.

Laravel Dependency Lock-In

Tightly coupled with Laravel, meaning it cannot be used with other PHP frameworks or standalone applications, reducing flexibility for non-Laravel projects.

Setup and Resource Overhead

Requires additional configuration, Redis dependency, and separate processes, which might be overkill for simple queue needs and add complexity to deployment.

Frequently Asked Questions

Related Projects

LiveWire

A full-stack framework for Laravel that takes the pain out of building dynamic UIs.

Stars23,529

Forks1,737

Last commit3 days ago

Debug Bar

Debugbar for Laravel (Integrates PHP Debug Bar)

Stars19,230

Forks1,606