Laravel Horizon Kurulumu: Adım Adım Rehber

Laravel Horizon, Laravel framework'üne entegre edilebilen güçlü ve gerçek zamanlı kuyruk yönetim aracıdır. Bu araç, özellikle yoğun trafik ve karmaşık arka plan işlemleriyle çalışan uygulamalarda, kuyrukların görsel ve kontrol edilebilir olmasını sağlar. Horizon, Laravel’in native queue sistemiyle uyumlu olup Redis tabanlıdır ve kullanımı oldukça basittir, ancak kurulum sürecinde dikkat edilmesi gereken bazı teknik detaylar vardır. Bu yazıda, Horizon’un kurulum adımlarını ve temel yapılandırmasını detaylandıracağız.

İlk olarak, Laravel projenize Horizon paketini eklemeniz gerekir. Bunu Composer aracılığıyla yapabilirsiniz:



Kurulum tamamlandıktan sonra, Horizon servis sağlayıcısı otomatik olarak yüklenir; ancak, Laravel’in ayarlarını güncellemeniz gerekebilir. Ayrıca, config/app.php dosyasına manuel ekleme yapmanıza gerek yoktur, çünkü Laravel 5.5 ve sonrası otomatik keşif (auto-discovery) ile bu adımı halleder.

Kurulumun bir sonraki adımı, Horizon’un yapılandırma dosyasını publish etmektir:



Bu komut, config/horizon.php dosyasını oluşturur ve Horizon’un çalışma parametrelerini ayarlamanıza olanak tanır. Burada, kuyrukların hangi Redis bağlantısıyla ve hangi ayarlarla çalışacağını belirleyebilirsiniz. Ayrıca, Horizon’un dashboard’unda göreceğiniz işlem ve kuyruk istatistikleri için bu yapılandırma kritik önemdedir.

Horizon’u çalıştırmak için ise, aşağıdaki komutu kullanabilirsiniz:



Bu komut, Horizon’un arka planda çalışmasını sağlar ve özellikle production ortamında, Supervisor gibi process yöneticileri ile birlikte kullanılmalıdır. Supervisor yapılandırması, Horizon’un sürekli ve stabil çalışmasını sağlar, bu nedenle sisteminizde Supervisor kurulu ve uygun şekilde yapılandırılmış olmalıdır.

Son olarak, Horizon’un güvenli ve erişilebilir olması için, uygun erişim kontrolleri ve SSL ayarlarının yapılandırılması önerilir. Ayrıca, Horizon’un yeni versiyonlarını ve güncellemelerini takip etmek, güvenlik ve performans açısından önemlidir.

İşte temel adımlar:

Composer ile Horizon paketini ekle

php artisan horizon:install komutunu çalıştır

config/horizon.php dosyasını düzenle

Horizon’u başlat veya Supervisor ile otomatikleştir

Bu aşamaları tamamladıktan sonra, Horizon’u kullanmaya başlayabilir ve Laravel uygulamanızın arka plan işlemlerini daha etkin yönetebilirsiniz. Bu noktada, özellikle Redis yapılandırması ve process yönetimi konularında dikkatli olmak, sistem stabilitesi açısından kritiktir.