Eylem Sınıfları: O basit yapı, o dev hizmetin yerini alıyor.

<p>Her büyüyen Laravel projesi bu aşamadan geçer. "Mantık kontrolör içinde olmaz" öğrenirsiniz, bir <code>UserService</code> oluşturursunuz ve geliştiğinizi hissedersiniz. Gerçekten de başlangıçta bir gelişme olur.</p>

<p>Fakat zaman geçtikçe <code>UserService</code> <code>create()</code>, <code>update()</code>, <code>deactivate()</code>, <code>sendWelcome()</code>, <code>exportCsv()</code>, <code>resetPassword()</code> gibi yöntemlerle dolup taşar. Bir gün dosyayı açtığınızda 800 satır, yapıcıda 15 bağımlılık olduğunu görürsünüz ve artık kimse bir şeyin nerede başladığını veya bittiğini anlayamaz.</p>

<p>Bir hizmet katmanı oluşturmadınız. Güzel bir adı olan bir <strong>God class</strong> oluşturdunuz.</p>

<h2>
    <a name="sorun-her-seyi-yapan-service-iyi-yapmaz" href="#sorun-her-seyi-yapan-service-iyi-yapmaz"></a>
    Sorun: Her şeyi yapan Service, hiçbir şeyi iyi yapmıyor
</h2>

<p>Klasik bir belirti, yapıcıdır:</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="kd">class</span> <span class="nc">UserService</span>

<span class="k">public</span> <span class="k">function</span> <span class="n">criar</span><span class="p">(</span><span class="kt">array</span> <span class="nv">$veriler</span><span class="p">)</span> <span class="p">{</span> <span class="cm">/* ... */</span> <span class="p">}</span>
<span class="k">public</span> <span class="k">function</span> <span class="n">exportarCsv</span><span class="p">()</span> <span class="p">{</span> <span class="cm">/* ... */</span> <span class="p">}</span>
<span class="k">public</span> <span class="k">function</span> <span class="n">resetarSenha</span><span class="p">(</span><span class="kt">User</span> <span class="nv">$kullanici</span><span class="p">)</span> <span class="p">{</span> <span class="cm">/* ... */</span> <span class="p">}</span>
<span class="c1">// + 12 yöntem birbirleriyle alakasız</span>

<p>Dikkat edin: <code>resetarSenha()</code> kullanmak için Laravel, <code>CsvExporter</code> ve <code>PaymentGateway</code>'yi birlikte başlatmak zorunda, oysa bunların <strong>resetar senha</strong> ile hiçbir alakasının olmaması gerekir. Sorumluluklar hepsi tek bir düğümde bağlı.</p>

<p>Bu, "S" ile SOLID'in hafifçe ağladığı bir durum: bir sınıf, değişmek için bir sebep. Bu Service'in 15 sebebi var.</p>

<h2>
    <a name="çözüm-action-classes-bir-sınıf-bir-eşya" href="#çözüm-action-classes-bir-sınıf-bir-eşya"></a>
    Çözüm: Action Classes — bir sınıf, bir işlem
</h2>

<p>Fikir, o kadar basit ki komik: <strong>her işleme kendi sınıfı, bir tane de genel bir yöntemle (genellikle <code>handle()</code> veya <code>__invoke()</code>) sahip olmalı.</strong></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="kd">class</span> <span class="nc">CreateUser</span>

<span class="k">public</span> <span class="k">function</span> <span class="n">handle</span><span class="p">(</span><span class="kt">array</span> <span class="nv">$veriler</span><span class="p">):</span> <span class="kt">User</span>
<span class="p">{</span>
    <span class="nv">$user</span> <span class="o">=</span> <span class="nc">User</span><span class="o">::</span><span class="nf">create</span><span class="p">(</span><span class="nv">$veriler</span><span class="p">);</span>

    <span class="nv">$this</span><span class="o">-&gt;</span><span class="n">mailer</span><span class="o">-&gt;</span><span class="nf">to</span><span class="p">(</span><span class="nv">$user</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">send</span><span class="p">(</span><span class="k">new</span> <span class="nc">Welcome</span><span class="p">(</span><span class="nv">$user</span><span class="p">));</span>

    <span class="k">return</span> <span class="nv">$user</span><span class="p">;</span>
<span class="p">}</span>

<p>Bir sınıf. Bir sorumluluk. Gerçekten o işlemi gerçekleştirmek için ihtiyaç duyduğu kadar bağımlılık içeren bir yapıcı.</p>

<p>Kontrolörde ise temiz ve net görünür:</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="k">public</span> <span class="k">function</span> <span class="n">store</span><span class="p">(</span><span class="kt">StoreUserRequest</span> <span class="nv">$request</span><span class="p">,</span> <span class="kt">CreateUser</span> <span class="nv">$action</span><span class="p">)</span>

<span class="k">return</span> <span class="k">new</span> <span class="nc">UserResource</span><span class="p">(</span><span class="nv">$user</span><span class="p">);</span>

<p>Laravel bağımlılığı kendisi çözer. Kontrolörü okuduğunuzda, neler olduğunu hemen anlıyorsunuz: doğruluyor, kullanıcıyı oluşturuyor, geri döndürüyor. 800 satırlık bir hizmet içinde aramak zorunda kalmıyorsunuz.</p>

<h2>
    <a name="pratikte-nasil-kullanilir" href="#pratikte-nasil-kullanilir"></a>
    Pratikte nasıl kullanılacağı
</h2>

<p><strong>Doğrudan konteynerden çağırarak:</strong></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="nf">app</span><span class="p">(</span><span class="nc">CreateUser</span><span class="o">::</span><span class="n">class</span><span class="p">)</span><span class="o">-&gt;</span><span class="nf">handle</span><span class="p">(</span><span class="nv">$veriler</span><span class="p">);</span>

<p><strong>Aynı Action'ı farklı bağlamlarda yeniden kullanarak</strong> burada parlıyor:</p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><span class="c1">// HTTP kontrolöründe</span>

<p>Aynı iş kuralı, tek bir yerde, üç farklı noktadan çağrılıyor. Bu, DRY ilkesi gerçek anlamda çalışıyor, kopyala-yapıştır değil.</p>

<h2>
    <a name="hot-take-ama-service-ölmedi" href="#hot-take-ama-service-ölmedi"></a>
    Hot take: "Ama Service, öldü mü?"
</h2>

<p>Hayır. Ve burada tartışma kızışıyor.</p>

<p>Service, gerçekten <strong>uygun</strong> olan bir dizi işlem olduğu zaman hâlâ mantıklıdır; bu işlemler gerçek durum veya bağımlılık paylaşabilir — tipik bir <code>PaymentService</code> gibi, bir geçit ile konuşan ve <code>charge()</code>, <code>refund()</code>, <code>check()</code> gibi işlemler gerçekleştiren.</p>

<p>Problem asla Service'in kendisi olmadı. Problemi, tüm mantığı kontrolör içine sokmak için bir <strong>kova</strong> olarak kullanmaktı. Action bunun antidotudur: İşlemler arasında "kullanıcı ile oynamak" dışında hiçbir ortak nokta yoksa, aynı sınıfta tutulmamalıdırlar.</p>

<h2>
    <a name="uyarı-astronot-mimar-olmayın" href="#uyarı-astronot-mimar-olmayın"></a>
    Uyarı: Astronot mimar olmayın
</h2>

<p>Artık önemli bir uyarı, çünkü biliyorum ki bunu okuyan bazı kişiler <code>Actions/</code> her şey için yaratmak istiyor.</p>

<p><strong>Her işlem bir Action'a ihtiyaç duymaz.</strong> Basit bir CRUD, bir <code>update</code> işlemi, bir durum değişikliği? Bu, kontrolörde huzur içinde yaşayabilir. İki satırlık bir yöntem içeren bir <code>UpdateUserName</code> sınıfı oluşturmak organizasyon değil, bir seremoni.</p>

<p>Kural, <strong>işlemin gerçekten iş kuralı var mı?</strong> Birden fazla adım içeriyorsa, yan etkileri varsa veya şeyler arasında koordinasyon gerektiriyorsa, Action'a dönüşür. Sadece bir <code>-&gt;update()</code> yapıyorsanız, bırakın kontrolörde kalsın ve hayatınıza devam edin.</p>

<p>Temiz kod, karmaşıklığı azaltmakla ilgilidir; dosyaları yaymakla değil.</p>

<h2>
    <a name="kapatmadan-once" href="#kapatmadan-once"></a>
    Kapatmadan Önce
</h2>

<p>Projenizdeki en büyük Service'i açın ve özel yöntemlerinizi sayın. 5, 6'dan fazla ve birbirleriyle ilgisi yoksa? Muhtemelen orada, çıkmayı bekleyen pek çok Action var.</p>

<p>Peki, siz Service takımı mı, Action takımı mı yoksa "duruma göre" takımı mısınız? Yorumlarda buluşalım, bu tartışma gerçekten ilginç. 🔥</p>