Yazılım

Laravel Uygulamanızı Anlık Hissettirmek: Kuyruklar ve Horizon için Nihai Rehber

teknomers
teknomers

TL;DR: HTTP isteklerinde yavaş iş yapmayı bırakın. QUEUE_CONNECTION değerini redis olarak ayarlayarak, Horizon‘ı kurarak ve ağır görevleri arka planda çalışan işlere aktararak, UI’nız milisaniyeler içinde yanıt verirken, karmaşık işlemler arka planda gerçekleşir.

<h2>Bugün Niçin Kuyruk Kullanmalısınız</h2>
<p>Standart bir uygulama akışında, bir istekte ağır görevler gerçekleştirmek kullanıcıyı engeller. Kuşak bazlı mimarinin benimsenmesi üç temel fayda sağlar:</p>
<p><em> Daha İyi Kullanıcı Deneyimi</em>: Uygulamanız hemen yanıt verir (örneğin, "İsteğiniz alındı!") ve gerçek görevi daha sonra işler.<br/>
</em><em>Performans</em>: PDF oluşturma, resim küçük resimlerini işleme veya webhook gönderme gibi ağır görevler PHP-FPM'i bloke etmez.<br/>
</em><em>Dayanıklılık</em>: Yerleşik yeniden denemeler ve geri çekilme stratejileri, kullanıcı akışınızı hatalı üçüncü taraf API'lerine karşı korur.</p>

<h2>Hızlı Başlangıç: Redis &amp; Horizon</h2>
<p>Başlamak için, <code>.env</code> dosyanızı Redis sürücüsünü kullanacak şekilde güncelleyin:</p>
<p><strong>1) Redis sürücüsü</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code># .env

QUEUE_CONNECTION=redis
REDIS_CLIENT=phpredis # veya predis

<p><strong>2) Bir işçi başlatma</strong> (yerel)<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan queue:work <span class="nt">--tries</span><span class="o">=</span>3 <span class="nt">--timeout</span><span class="o">=</span>30

# yayına alırken güvenli bir şekilde durdurmak için: php artisan queue:restart

<p><strong>3) Horizon'u kurun (gösterge panosu + denetim yönetimi)</strong><br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>composer require laravel/horizon

php artisan horizon:install
php artisan migrate
php artisan horizon
# metrikler, kuyruklar, başarısız işler için /horizon adresini ziyaret edin

<blockquote>
    <p>Üretimde, <code>php artisan horizon</code>'u bir işlem yöneticisi altında çalıştırın (systemd, Supervisor, Forge, Vapor).<br/>Laravel, <code>php artisan horizon:terminate</code> ile işçileri nazikçe yeniden yükler.</p>
</blockquote>

<h2>Adım 1 — E-postalarınızı Kuyruğa Alma (1 Satırla Kazanın)</h2>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="c1">// her Mailable kuyruklanabilir:</span>

Mail::to($user)->queue(new OrderConfirmed($order));
// ya da DB onayı sonrası gönderimi garanti etmek için:
Mail::to($user)->queue((new OrderConfirmed($order))->afterCommit());

<p>Veya Mailable’in kendisini kuyruklanabilir yapın:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="kn">use</span> <span class="nc">Illuminate\Contracts\Queue\ShouldQueue</span><span class="p">;</span>

class OrderConfirmed extends Mailable implements ShouldQueue
{
public function __construct(public Order $order) {}
public function build() { / … / }
}

<p><strong>Neden</strong>: e-posta sağlayıcıları yavaş veya oran sınırlandırılmış olabilir—yanıtı bloke etmeyin.</p>

<hr/>

<h2>Adım 2 — Gelişmiş İş Mantığı (Görüntüler &amp; PDF'ler)</h2>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="c1">// app/Jobs/GenerateThumbnails.php</span>

namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\Middleware\RateLimited;
use Illuminate\Queue\Middleware\WithoutOverlapping;
use Intervention\Image\ImageManager;
use Illuminate\Support\Facades\Storage;

class GenerateThumbnails implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

<span class="k">public</span> <span class="kt">int</span> <span class="nv">$timeout</span> <span class="o">=</span> <span class="mi">60</span><span class="p">;</span>        <span class="c1">// uzun görevleri öldür</span>
<span class="k">public</span> <span class="kt">int</span> <span class="nv">$tries</span>   <span class="o">=</span> <span class="mi">3</span><span class="p">;</span>         <span class="c1">// birkaç kez yeniden dene</span>
<span class="k">public</span> <span class="nv">$backoff</span>     <span class="o">=</span> <span class="p">[</span><span class="mi">5</span><span class="p">,</span> <span class="mi">30</span><span class="p">,</span> <span class="mi">120</span><span class="p">];</span> <span class="c1">// artan geri çekilme</span>

<span class="k">public</span> <span class="k">function</span> <span class="n">__construct</span><span class="p">(</span><span class="k">public</span> <span class="kt">string</span> <span class="nv">$path</span><span class="p">)</span> <span class="p">{}</span>

<span class="k">public</span> <span class="k">function</span> <span class="n">middleware</span><span class="p">():</span> <span class="kt">array</span>
<span class="p">{</span>
    <span class="k">return</span> <span class="p">[</span>
        <span class="k">new</span> <span class="nc">WithoutOverlapping</span><span class="p">(</span><span class="nv">$this</span><span class="o">-&gt;</span><span class="n">path</span><span class="p">),</span>  <span class="c1">// anahtar ile idempotentlik</span>
        <span class="k">new</span> <span class="nc">RateLimited</span><span class="p">(</span><span class="s1">'media'</span><span class="p">),</span>             <span class="c1">// dalgalı yüklemeleri sınırlamak için</span>
    <span class="p">];</span>
<span class="p">}</span>

<span class="k">public</span> <span class="k">function</span> <span class="n">handle</span><span class="p">(</span><span class="kt">ImageManager</span> <span class="nv">$images</span><span class="p">):</span> <span class="kt">void</span>
<span class="p">{</span>
    <span class="nv">$img</span> <span class="o">=</span> <span class="nv">$images</span><span class="o">-&gt;</span><span class="nf">read</span><span class="p">(</span><span class="nc">Storage</span><span class="o">::</span><span class="nf">disk</span><span class="p">(</span><span class="s1">'uploads'</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">path</span><span class="p">(</span><span class="nv">$this</span><span class="o">-&gt;</span><span class="n">path</span><span class="p">));</span>
    <span class="nv">$thumb</span> <span class="o">=</span> <span class="nv">$img</span><span class="o">-&gt;</span><span class="nf">scaleDown</span><span class="p">(</span><span class="n">width</span><span class="o">:</span> <span class="mi">640</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">toJpeg</span><span class="p">(</span><span class="mi">80</span><span class="p">);</span>
    <span class="nc">Storage</span><span class="o">::</span><span class="nf">disk</span><span class="p">(</span><span class="s1">'uploads'</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">put</span><span class="p">(</span><span class="s2">"thumbs/</span><span class="si">{</span><span class="nv">$this</span><span class="o">-&gt;</span><span class="n">path</span><span class="si">}</span><span class="s2">"</span><span class="p">,</span> <span class="p">(</span><span class="n">string</span><span class="p">)</span> <span class="nv">$thumb</span><span class="p">);</span>
<span class="p">}</span>

}

<p>Resmi kaydettikten sonra denetleyicinizden aktarın:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">GenerateThumbnails</span><span class="o">::</span><span class="nf">dispatch</span><span class="p">(</span><span class="nv">$storedPath</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">onQueue</span><span class="p">(</span><span class="s1">'media'</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">afterCommit</span><span class="p">();</span>

<hr/>

<h2>Adım 3 — Gerçekten İhtiyacınız Olan Güvenilirlik Desenleri</h2>
<p>Anında yanıt illüzyonu istiyorsanız, işi<br/><strong>yanıt gönderildikten sonra</strong> itebilirsiniz (yeniden deneme/metrikler için kuyrukları kullanmak daha iyidir):<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">SomeJob</span><span class="o">::</span><span class="nf">dispatchAfterResponse</span><span class="p">(</span><span class="nv">$payload</span><span class="p">);</span>

<hr/>

<h2>Adım 4 — Yığınlar &amp; Zincirler (bir API çağrısı birçok işi tetikler)</h2>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="kn">use</span> <span class="nc">Illuminate\Bus\Batch</span><span class="p">;</span>

use Illuminate\Support\Facades\Bus;

$batch = Bus::batch([
new GenerateThumbnails($p1),
new GenerateThumbnails($p2),
new GenerateThumbnails($p3),
])->then(function (Batch $batch) {
// tüm küçük resimler tamamlandı
})->catch(function (Batch $batch, Throwable $e) {
// en az bir tane başarısız oldu
})->finally(function (Batch $batch) {
// temizleme
})->name(‘product:thumbnails’)->onQueue(‘media’)->dispatch();

<p>İşleri zincirleme (katı sıra):<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nc">SendInvoice</span><span class="o">::</span><span class="nf">withChain</span><span class="p">([</span>
<span class="k">new</span> <span class="nc">SyncToERP</span><span class="p">(</span><span class="nv">$order</span><span class="o">-&gt;</span><span class="n">id</span><span class="p">),</span>
<span class="k">new</span> <span class="nc">NotifyAccountant</span><span class="p">(</span><span class="nv">$order</span><span class="o">-&gt;</span><span class="n">id</span><span class="p">),</span>

])->dispatch($order->id);

<hr/>

<h2>Adım 5 — Gerçekten İhtiyacınız Olan Güvenilirlik Desenleri</h2>
<ul>
    <li><strong>İdempotans</strong>: <code>WithoutOverlapping($key)</code> kullanın; işleri küçük ve <em>durumsuz</em> tutun.</li>
    <li><strong>afterCommit()</strong>: Sadece DB işlemi onaylandıktan sonra kuyruğa ekleyin.</li>
    <li><strong>Zaman aşımı &amp; denemeler</strong>: Her iş (veya her işçi) için <code>$timeout</code> ve <code>$tries</code> tanımlayın.</li>
    <li><strong>Geri çekilme</strong>: Geçici kesintilere dayanmak için <code>[5,30,120]</code> gibi diziler kullanın.</li>
    <li><strong>Oran sınırlama</strong>: <code>RateLimited('emails')</code> kullanarak sağlayıcıdan gelen trafikteki kısıtlamaları önleyin.</li>
    <li><strong>Hızlı başarısız ol, incele</strong>: Horizon, başarısız işleri gösterir; düzeltip <code>queue:retry all</code> kullanın.</li>
</ul>

<p>Başarısız işler CLI'sini kullanacaksınız:<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan queue:failed

php artisan queue:retry all
php artisan queue:forget {id}

<hr/>

<h2>Adım 6 — Horizon: Öncelikler, Dengeler, Metrikler</h2>
<p><code>config/horizon.php</code> örneği (bir yüksek öncelikli kuyruk + bir medya için):<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="s1">'defaults'</span> <span class="o">=&gt;</span> <span class="p">[</span>
<span class="s1">'supervisor-1'</span> <span class="o">=&gt;</span> <span class="p">[</span>
    <span class="s1">'connection'</span> <span class="o">=&gt;</span> <span class="s1">'redis'</span><span class="p">,</span>
    <span class="s1">'queue'</span> <span class="o">=&gt;</span> <span class="p">[</span><span class="s1">'high'</span><span class="p">,</span> <span class="s1">'media'</span><span class="p">,</span> <span class="s1">'default'</span><span class="p">],</span>
    <span class="s1">'balance'</span> <span class="o">=&gt;</span> <span class="s1">'auto'</span><span class="p">,</span>      <span class="c1">// basit | otomatik</span>
    <span class="s1">'minProcesses'</span> <span class="o">=&gt;</span> <span class="mi">2</span><span class="p">,</span>
    <span class="s1">'maxProcesses'</span> <span class="o">=&gt;</span> <span class="mi">10</span><span class="p">,</span>
    <span class="s1">'tries'</span> <span class="o">=&gt;</span> <span class="mi">3</span><span class="p">,</span>
    <span class="s1">'timeout'</span> <span class="o">=&gt;</span> <span class="mi">60</span><span class="p">,</span>
    <span class="s1">'nice'</span> <span class="o">=&gt;</span> <span class="mi">0</span><span class="p">,</span>
<span class="p">],</span>

],

<p>Horizon'ı başlatın (yerel):<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan horizon

<p>Üretim (systemd örneği):<br/></p>
<div class="highlight js-code-highlight">
    <pre class="highlight ini"><code><span class="c"># /etc/systemd/system/horizon.service</span>

[Unit]
Description=Laravel Horizon
After=redis.service

[Service]
User=www-data
Restart=her zaman
ExecStart=/usr/bin/php /var/www/app/artisan horizon

[Install]
WantedBy=multi-user.target

<blockquote>
    <p>Yayın ipucu: <code>php artisan horizon:terminate</code> komutunu sürüm sırasında çalıştırın; Horizon, yeni kodla işçileri nazikçe yeniden başlatacaktır.</p>
</blockquote>

<hr/>

<h2>Gözlemlilik</h2>
<ul>
    <li><strong>Horizon</strong>: kuyruk uzunlukları, çalışma süresi, verim, başarısız işler.</li>
    <li><strong>Telescope</strong>: her isteği, iş gönderimlerini, DB sorgularını, günlükleri.</li>
    <li><strong>Uyarılar</strong>: başarısız işler veya uzun çalışma süreleri için bir Slack webhook'u kullanın.</li>
</ul>

<hr/>

<h2>Üretim Kontrol Listesi (kopyala/yapıştır)</h2>
<ul>
    <li>[ ] <code>QUEUE_CONNECTION=redis</code></li>
    <li>[ ] Horizon kurulu &amp; bir denetim altında çalışıyor</li>
    <li>[ ] Ayrı kuyruklar: <code>high</code>, <code>emails</code>, <code>media</code>, <code>webhooks</code></li>
    <li>[ ] <code>$tries</code>, <code>$timeout</code>, ve <code>$backoff</code> her iş için ayarlandı</li>
    <li>[ ] DB yazımlarıyla tetiklenen işler için <code>afterCommit()</code></li>
    <li>[ ] Ara yazılım: <code>WithoutOverlapping</code> / <code>RateLimited</code></li>
    <li>[ ] Başarısızlıklar için metrikler + uyarılar</li>
    <li>[ ] Yayında nazik yenilemeler (<code>horizon:terminate</code>)</li>
</ul>

<hr/>

<h2>Paylaşılabilir Tek Ekran Görseli</h2>
<div class="highlight js-code-highlight">
    <pre class="highlight diff"><code><span class="gd">- // YAVAŞ (yanıtı bloke eder)

Kaynak: Orijinal Makale

API’nizi Bozmaktan Kaçının: Laravel’de URL Versiyonlamasını Ustaca Yapın
Bagisto’da Kritik Güvenlik Sorunu: Sessiz Yönetici Hesabı Değiştirme ve Silme – Bagisto Arka Kapı
Sunucunuzda Disk Alanı Tükendiğinde: Önleme, Tespit ve Kurtarma
Laravel’de via() fonksiyonunu yeniden yazmadan kullanıcı bazlı bildirim tercihleri
Laravel’in Fabrika İlişkilerinizi Neden Tahmin Edemediği
Bu Makaleyi Paylaş
Önceki Makale TikTok, Sonsuz Kaydırma Gibi Bağımlılık Yapan Özellikleri Kapatacak
Sonraki Makale Cyberpunk 2077 TCG Adaptasyonu Gelişmeye Devam Ediyor

Sanal Medya

Son Eklenenler

Yeni Noob Incremental Kodlarıyla Oyun Deneyiminizi Geliştirin
Oyun
NotebookLM ile Sohbetten Kaynak Deposu Oluşturmanın Yolu Açılıyor
Genel
Apple iOS 27’yi Duyurdu: Yenilikler ve Özellikler Neler?
Liste
Gogs’ta Kritik Sıfır Gün Açığı: Uzaktan Kod İcrası Tehdidi!
Siber Güvenlik
Amazon, AI ile kişiye özel ürün tasarımına izin veriyor
Yapay Zeka
Startup Battlefield 2026’ya Başvurmanın Yolları ve Son Tarih 8 Haziran!
Genel