Bilmediğiniz Eloquent Cast’leri

Paylaş

Hâlâ `json_decode` kullanıyor musun?

Projenizde, veritabanından bir sütunu okuyup `json_decode` yaparak dizi üzerinde işlem yapıyorsanız ve sonrasında tekrar `json_encode` ile kaydediyorsanız, muhtemelen sık sık `true` parametresini unutmaktan korkuyorsunuz.

Daha kötüsü, virgülle ayrılmış bir listeyi depolayıp sürekli olarak `explode` ve `implode` yapmak zorunda kalmak. Bu işlemler, Laravel’in `Eloquent` ile halledilebilecek sorunlar.

Çoğu geliştirici, `casts` fonksiyonunu sadece dört tiple (örneğin, `array`, `boolean`, `datetime`, `integer`) tanıyıp bırakıyor, ancak aslında çok daha fazlası var.

<h2>
    <a name="cast_nedir" href="#cast_nedir"></a>
    `Cast` nedir?
</h2>
<p>`Cast`, veritabanındaki format ile PHP'de kullanmak istediğiniz format arasında otomatik bir dönüşüm sağlar. Modelinizde tanımı yaparak `Eloquent`, iki yönde köprü kurar:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

class Produto extends Model
{
protected function casts(): array
{
return [
‘ativo’ => ‘boolean’,
‘preco’ => ‘decimal:2’,
‘publicado_em’ => ‘datetime’,
];
}
}

<p>Şimdi ise burada pek bilinmeyen `casts`'leri keşfedeceğiz.</p>

<h2>
    <a name="AsArrayObject" href="#AsArrayObject"></a>
    `AsArrayObject`: Gerçek, değiştirebilir bir dizi
</h2>
<p>Klasik `array` cast'inin bir problemi var: Bir öğeyi doğrudan değiştiremiyorsunuz. Aşağıdaki kod <strong>çalışmaz</strong>:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

$produto->options[‘cor’] = ‘azul’; // sessizce yok sayılır 😑

Ancak AsArrayObject ile bu mümkün:

use Illuminate\Database\Eloquent\Casts\AsArrayObject;
protected function casts(): array
{
return [
'options' => AsArrayObject::class,
];
}

$produto->options['cor'] = 'azul';
$produto->options['tamanho'] = 'M';
$produto->save(); // doğru şekilde kaydedilir
        

<h2>
    <a name="AsCollection" href="#AsCollection"></a>
    `AsCollection`: JSON sütununuz `Collection` olur
</h2>
<p>Laravel'in Collections'ını seviyorsanız (ve mutlaka seviyorsunuzdur), neden o JSON'u sıradan bir dizi olarak kullanasınız? <code>AsCollection</code> size bir Collection sunar ve tam anlamıyla <code>map</code>, <code>filter</code>, <code>where</code> gibi metodları kullanmanıza izin verir:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

use Illuminate\Database\Eloquent\Casts\AsCollection;

protected function casts(): array
{
return [
‘tags’ => AsCollection::class,
];
}

$produto->tags->filter(fn ($tag) => $tag['ativo'])->pluck('nome');
        

<h2>
    <a name="AsEnumCollection" href="#AsEnumCollection"></a>
    `AsEnumCollection`: Şimdi bir dizi enum
</h2>
<p>Bir kolonun `çoklu` enum'lar içerdiği durumlarda (örneğin, bir kullanıcının izinleri) <code>AsEnumCollection</code> kullanılır:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

use App\Enums\Permissao;
use Illuminate\Database\Eloquent\Casts\AsEnumCollection;

protected function casts(): array
{
return [
‘permissoes’ => AsEnumCollection::of(Permissao::class),
];
}

<h2>
    <a name="AsStringable" href="#AsStringable"></a>
    `AsStringable`: Süper güce sahip string
</h2>
<p>Tüm işlemleri manual olarak yapmak yerine, <code>AsStringable</code> ile stringleriniz artık `Stringable` objesi olarak gelerek doğrudan yöntem zincirlemesi yapabilir:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

use Illuminate\Database\Eloquent\Casts\AsStringable;

protected function casts(): array
{
return [
‘titulo’ => AsStringable::class,
];
}

$post->titulo->slug(); // akıcı stil
$post->titulo->limit(50)->upper();
        

<h2>
    <a name="encrypted_hashed" href="#encrypted_hashed"></a>
    `encrypted` ve `hashed`: Boilerplate olmadan güvenlik
</h2>
<p>Hassas veriyi veritabanında güvenli bir şekilde saklamak için `encrypted` cast'i kullanabilirsiniz:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

protected function casts(): array
{
return [
‘token_api’ => ‘encrypted’,
‘dados_bancarios’ => ‘encrypted:array’, // hem şifreler hem de serileştirir
];
}

Şifreler için hashed kullanarak otomatik hashlemeyi gerçekleştirebilirsiniz:

'password' => 'hashed',
        

<h2>
    <a name="kullanım_pratikte" href="#kullanım_pratikte"></a>
    Pratikte nasıl kullanılır
</h2>
<p><strong>Kullanıcı tercihleri:</strong> JSON formatında bir <code>preferencias</code> kolonunu <code>AsArrayObject</code> ile kullanarak, örneğin <code>$user->preferencias['tema'] = 'dark'</code> yapabilir ve kaydedebilirsiniz.</p>
<p><strong>Roller/İzinler:</strong> `AsEnumCollection::of(Permissao::class)` ile tiplenmiş bir liste tutarak <code>contains()</code> fonksiyonu ile karşılaştırmalar yapabilirsiniz.</p>
<p><strong>Herhangi bir şeyin metadata'sı:</strong> Sipariş, ürün, post — o <code>meta</code> JSON kolonu, size model üzerinde doğrudan <code>map</code>, <code>filter</code> ve diğer yöntemleri sunar.</p>

<h2>
    <a name="özelleştirilebilir_cast" href="#özelleştirilebilir_cast"></a>
    Özel bir `cast` yaratmak
</h2>
<p>Varsayılan `casts`'ler yetmiyorsa, <code>CastsAttributes</code> (okuma ve yazma) veya sadece yazma işlemi için <code>CastsInboundAttributes</code> uygulayarak özelleştirilmiş bir `cast` oluşturabilirsiniz. Aşağıda, kayıt öncesi hashalama yapan bir `cast` örneği:</p>
<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>

namespace App\Casts;

use Illuminate\Contracts\Database\Eloquent\CastsInboundAttributes;
use Illuminate\Database\Eloquent\Model;

class AsHash implements CastsInboundAttributes
{
public function set(Model $model, string $key, mixed $value, array $attributes): string
{
return bcrypt($value);
}
}