<p>Bir <a href="https://tenancyforlaravel.com/" target="_blank" rel="noopener noreferrer">stancl/tenancy</a> paketini kullanan çoklu kiracılı bir Laravel uygulaması geliştiriyorsanız, bir gün her kiracı için bir Artisan komutunu aynı anda çalıştırmanız gerekecek. Veritabanlarını migrate etmek, önbellekleri temizlemek veya bir raporu yeniden oluşturmak gibi işlemleri her kiracı için ayrı ayrı çalıştırmanız gerekebilir. Ancak, <code>php artisan migrate</code> komutu sadece merkezi veritabanınıza etki eder ve her kiracı geride kalır.</p>

<p>Birçok geliştirici bir <code>tenants:artisan</code> komutu arayışına girer, ancak bu komut mevcut değildir. Asıl aradığınız komut <code>tenants:run</code>’dur ve bu, kayıtlı herhangi bir Artisan komutunu her kiracının bağlamında sarmalar. Bu rehber, <code>tenants:run</code> komutunu, kiracı bağlantılarına özel komutları, programatik API’yi ve birkaç kiracıdan sonra karşınıza çıkabilecek sorunları ele alacaktır.</p>

<blockquote>
    <p><strong>Önemli Noktalar:</strong></p>
    <ul>
        <li>Genel komut <code>tenants:run {commandname}</code> şeklindedir — <code>tenants:artisan</code> değil.</li>
        <li>Belirli kiracıları hedeflemek için <code>--tenants=ID</code> kullanın (birden fazla kiracı için bayrağı tekrar edin). Bunu atlayarak tüm kiracılara ulaşabilirsiniz.</li>
        <li>Argüman ve seçeneklerinizi <code>--argument="key=value"</code> ve <code>--option="key=value"</code> ile iletin.</li>
        <li>Migrate, seed ve rollback işlemleri için özel komutları kullanın: <code>tenants:migrate</code>, <code>tenants:seed</code>, <code>tenants:rollback</code>.</li>
        <li>Kiracılar ardışık olarak çalıştırılır. Birkaç yüze geçtiğinizde, her kiracı için bir iş kuyruğu oluşturmaya geçin.</li>
    </ul>
</blockquote>

<h2>tenants:run Komutu Gerçekten Ne Yapar?</h2>
<p><code>tenants:run</code> komutu, kiracıların üzerinden geçer ve her biri için kiracılığı başlatır, ardından adını verdiğiniz komutu çalıştırır, sonra kiracılığı sonlandırır. Kiracılığı başlatmak, bu kiracıya ait veritabanı bağlantısını, önbellek ekini ve dosya sistemi yollarını paket içindeki başlatıcılar aracılığıyla değiştirir — böylece sarmalanmış komut bir kiracı isteği içinde nasıl davranıyorsa o şekilde çalışır.</p>

<p>İşte paketin kaynağından gelen imza:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan tenants:run {commandname}
{--tenants=ID}
{--argument=key=value}
{--option=key=value}

<h2>Belirli Kiracıları Hedeflemek İçin Ne Yapmalıyım?</h2>
<p><code>--tenants</code> seçeneğini kullanarak her kiracı ID'si için bir kez tekrar edin. Bunu atlarsanız, komut <em>tüm</em> kiracılar için çalıştırılır — bu, önbellek temizlemede işe yarar ancak yıkıcı bir işlemde gerçekten tehlikeli olabilir.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code># Bir kiracı

<p>Test ederken <code>--tenants</code> kullanmayı alışkanlık haline getirin. Yanlış yazılan bir komut ismi bir kiracı için yüksek sesle başarısız olur; ancak "tüm" varsayılanında çalıştırılan yıkıcı bir komut akşamınızı mahvedebilir.</p>

<h2>Komuta Argüman ve Seçenekleri Nasıl Geçirebilirim?</h2>
<p>Bu, <code>tenants:run</code>’in kullandığı yer. Sarılmış komuta bayrak eklemek yeterli değildir; çünkü ayırıcı bu bayrakları <code>tenants:run</code>’a atar. Bunun yerine, her birini <code>--argument</code> ve <code>--option</code> ile geçirip <code>key=value</code> çiftleri ile göndermelisiniz.</p>

<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code>php artisan tenants:run email:send \
--tenants=acme \
--argument="subject=Welcome" \
--option="queue=1"

<p>Normalde <code>php artisan email:send "Welcome" --queue</code> olarak çağıracağınız bir komut yukarıdaki form halini alır. Her değer için <code>--argument</code> ve <code>--option</code> tekrar edin. Bu uzun olsa da, sarmalayıcı ile iç komutun bayraklarının çakışmasını önler.</p>

<h2>Ne Zaman Özel Komutları Kullanmalıyım?</h2>
<p>stancl/tenancy, sık kullandığınız işlemler için üretim odaklı komutlar sunar. Örneğin, tenant migrate işlemleri otomatik olarak <code>database/migrations/tenant</code> dizininde arama yapar. <code>tenants:run</code>’dan önce bunları tercih edin:</p>

<table>
    <thead>
        <tr>
            <th>Komut</th>
            <th>Açıklama</th>
            <th>Önemli Seçenekler</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td><code>tenants:migrate</code></td>
            <td>Her tenant veritabanı için migrate işlemini çalıştırıyor.</td>
            <td><code>--tenants=*</code>, <code>--path</code>, <code>--force</code></td>
        </tr>
        <tr>
            <td><code>tenants:migrate-fresh</code></td>
            <td>Bir tenant veritabanasını silip yeniden migrate ediyor (yıkıcı).</td>
            <td><code>--tenants=*</code></td>
        </tr>
        <tr>
            <td><code>tenants:rollback</code></td>
            <td>Her tenant başına son migration grubunu geri alır.</td>
            <td><code>--tenants=*</code></td>
        </tr>
        <tr>
            <td><code>tenants:seed</code></td>
            <td>Her tenant veritabanını seeder işlemi yapar.</td>
            <td><code>--tenants=*</code>, <code>--force</code></td>
        </tr>
        <tr>
            <td><code>tenants:list</code></td>
            <td>Tüm kiracıları ID ve domain ile listele.</td>
            <td>—</td>
        </tr>
        <tr>
            <td><code>tenants:run</code></td>
            <td>Her kiracı için herhangi bir kayıtlı Artisan komutunu çalıştırır.</td>
            <td><code>--tenants=*</code>, <code>--argument=*</code>, <code>--option=*</code></td>
        </tr>
    </tbody>
</table>

<p>Her kiracı veritabanı için migrate işlemini çalıştırmak için şu şekilde yapın (üretimde <code>--force</code> kullanmayı unutmayın):</p>
<div class="highlight js-code-highlight">
    <pre class="highlight shell"><code># Her tenant veritabanını migrate et

php artisan tenants:migrate –force

İki tenant için son grubu geri al

php artisan tenants:rollback –tenants=acme –tenants=globex

Tek bir kiracı için silip yeniden migrate et (yıkıcı!)

php artisan tenants:migrate-fresh –tenants=acme

Her tenantı etkileşim olmadan seed et

php artisan tenants:seed –force