Depo Kalıbı

Coddy'nin PHP Journey'sinin Nesne Yönelimli Programlama bölümünün bir parçası. Ders 81 / 91.

Repository Pattern, uygulamanızın iş mantığı ile veri depolama alanı arasında aracılık eden bir tasarım kalıbıdır. Etki alanı nesnelerine erişim için koleksiyon benzeri bir arayüz sağlar ve verilerin gerçekte nasıl depolandığı veya alındığına ilişkin ayrıntıları gizler.

Bir repository’yi, nesneleri kalıcı olarak saklamayı ve geri almayı bilen özel bir koleksiyon olarak düşün. Uygulama kodun, verilerin bir veritabanında, dosyada veya API’de bulunup bulunmadığını bilmeden repository’den ID’ye göre bir kullanıcı ister ya da yeni bir ürün kaydeder. Bu ayrım, kodunu daha kolay test edilebilir ve esnek hâle getirir.

<?php
interface UserRepositoryInterface {
    public function find(int $id): ?User;
    public function findAll(): array;
    public function save(User $user): void;
    public function delete(int $id): void;
}

class User {
    public function __construct(
        public int $id,
        public string $name,
        public string $email
    ) {}
}

Depo uygulaması gerçek depolama mekanizmasını yönetir:

<?php
class InMemoryUserRepository implements UserRepositoryInterface {
    private array $users = [];
    
    public function find(int $id): ?User {
        return $this->users[$id] ?? null;
    }
    
    public function findAll(): array {
        return array_values($this->users);
    }
    
    public function save(User $user): void {
        $this->users[$user->id] = $user;
    }
    
    public function delete(int $id): void {
        unset($this->users[$id]);
    }
}

$repo = new InMemoryUserRepository();
$repo->save(new User(1, "Alice", "alice@example.com"));
$repo->save(new User(2, "Bob", "bob@example.com"));

echo $repo->find(1)->name . "\n";
echo count($repo->findAll());

Çıktı:

Alice
2

Bu kalıbın güzelliği, iş mantığınızı değiştirmeden uygulamaları değiştirebilmenizdir. Bellek içi depolamadan veritabanına geçmeniz mi gerekiyor? Aynı arayüzü uygulayan yeni bir repository sınıfı oluşturun. Uygulama kodunuz, somut uygulamaya değil arayüze bağlı olduğu için olduğu gibi kalır.

Görev

Kolay

Repository Pattern'ı kullanarak bir ürün envanter sistemi oluşturalım. Alan nesneleriniz ile bunların nasıl depolandığı arasında temiz bir ayrım oluşturacak ve uygulama kodunuzun depolama ayrıntılarını bilmeden ürünlerle çalışmasına olanak tanıyacaksınız.

Kodunuzu dört dosya arasında düzenleyeceksiniz:

Product.php: Envanterinizdeki öğeleri temsil eden bir Product sınıfı oluşturun. Her ürünün bir id (int), name (string) ve price (float) değeri vardır. Kolay erişim için public özelliklerle birlikte constructor promotion kullanın.
ProductRepositoryInterface.php: Herhangi bir ürün depolama uygulaması için sözleşmeyi tanımlayan bir ProductRepositoryInterface oluşturun. Arayüzünüz şu metotları bildirmelidir:
- find(int $id): ?Product: Bir ürünü ID'sine göre alın veya bulunamazsa null döndürün
- findAll(): array: Tüm ürünleri bir dizi olarak alın
- save(Product $product): void: Bir ürünü depolayın veya güncelleyin
- delete(int $id): void: Bir ürünü ID'sine göre kaldırın
InMemoryProductRepository.php: Hem Product sınıfını hem de arayüzü dahil edin. Ürünleri depolamak için private bir dizi kullanarak arayüzü uygulayan bir InMemoryProductRepository sınıfı oluşturun. Verimli arama için ürünler ID'lerine göre indekslenmelidir. findAll() metodu yalnızca ürün nesnelerini döndürmelidir (dizi anahtarlarını sıfırlamak için array_values() kullanın).
main.php: Repository dosyasını dahil edin. İki girdi alacaksınız: önce eklenecek ürünlerin JSON dizesi, ardından ayrı bir satırda aranacak tamsayı ID.
JSON biçimi şöyle olacaktır:
```
[{"id": 1, "name": "Laptop", "price": 999.99}, {"id": 2, "name": "Mouse", "price": 29.99}]
```
Bir InMemoryProductRepository oluşturun, JSON girdisindeki tüm ürünleri kaydedin, ardından belirli bir ürünü bulmak için ikinci girdiyi (ID) kullanın. Sonuçları şu biçimde yazdırın:
```
Total products: [count]
Found: [name] - $[price]
```
Fiyatı iki ondalık basamakla biçimlendirin. Ürün bulunamazsa bunun yerine Found: Not found yazdırın.

Repository Pattern, depolama uygulamalarını değiştirmeniz gerektiğinde öne çıkar. Ana kodunuz yalnızca arayüze bağlıdır: bellek içi depolamadan veritabanına geçmek, herhangi bir uygulama mantığını değiştirmeden yeni bir repository sınıfı oluşturmak anlamına gelir.

Kendin dene

<?php

require_once 'InMemoryProductRepository.php';

// Girdiyi oku
$jsonInput = trim(fgets(STDIN));
$searchId = intval(trim(fgets(STDIN)));

// JSON girdisini bir diziye ayrıştır
$productsData = (array)json_decode($jsonInput, true);

// TODO: Bir InMemoryProductRepository örneği oluştur

// TODO: $productsData üzerinde döngü yap ve her ürünü kaydet
// Her öğenin 'id', 'name' ve 'price' anahtarları vardır

// TODO: Tüm ürünleri al ve toplam sayıyı yazdır
// Format: "Total products: [count]"

// TODO: $searchId ile ürünü bul
// Bulunursa yazdır: "Found: [name] - $[price]" (fiyat 2 ondalık basamağa biçimlendirilmiş)
// If not found, print: "Found: Not found"

?>