Adapter

interface Yuboruvchi
{
    public function yubor(string $manzil, string $matn): bool;
}

final class OzXizmatimiz implements Yuboruvchi
{
    public function yubor(string $manzil, string $matn): bool
    {
        echo "  [oz] {$manzil}: {$matn}", PHP_EOL;
        return true;
    }
}

function xabarTarqat(Yuboruvchi $y, array $manzillar, string $matn): int
{
    $soni = 0;
    foreach ($manzillar as $m) {
        if ($y->yubor($m, $matn)) {
            $soni++;
        }
    }
    return $soni;
}

$n = xabarTarqat(new OzXizmatimiz(), ['+998901112233', '+998935556677'],
    'Buyurtmangiz yolga chiqdi');
echo "yuborildi: {$n}", PHP_EOL;

// Tashqi kutubxona - biz uni O'ZGARTIRA OLMAYMIZ
final class SmsGateway
{
    private int $balans = 3;

    /**
     * @param array{to: string, body: string} $payload
     * @return array{status: string, id?: string, error?: string}
     */
    public function send(array $payload): array
    {
        if ($this->balans <= 0) {
            return ['status' => 'failed', 'error' => 'insufficient_balance'];
        }
        if (!str_starts_with($payload['to'], '+998')) {
            return ['status' => 'failed', 'error' => 'invalid_number'];
        }

        $this->balans--;
        echo "  [gateway] {$payload['to']} <- {$payload['body']}", PHP_EOL;

        return ['status' => 'sent', 'id' => 'msg_' . (3 - $this->balans)];
    }

    public function balance(): int
    {
        return $this->balans;
    }
}

$gw = new SmsGateway();
$javob = $gw->send(['to' => '+998901112233', 'body' => 'Salom']);
print_r($javob);

$xato = $gw->send(['to' => '77012345678', 'body' => 'Salom']);
print_r($xato);

final class SmsGatewayAdapter implements Yuboruvchi
{
    /** @var list<string> */
    private array $xatolar = [];

    // moslashtirilayotgan obyekt ichkarida turadi
    public function __construct(private readonly SmsGateway $gateway) {}

    public function yubor(string $manzil, string $matn): bool
    {
        // 1. argumentlarni begona shaklga o'tkazamiz
        $javob = $this->gateway->send([
            'to' => $manzil,
            'body' => $matn,
        ]);

        // 2. javobni o'z shaklimizga qaytaramiz
        if ($javob['status'] !== 'sent') {
            $this->xatolar[] = $manzil . ': ' . ($javob['error'] ?? 'nomalum');
            return false;
        }

        return true;
    }

    /** @return list<string> */
    public function xatolar(): array
    {
        return $this->xatolar;
    }
}

$adapter = new SmsGatewayAdapter(new SmsGateway());

// xabarTarqat() UMUMAN o'zgarmadi
$n = xabarTarqat($adapter,
    ['+998901112233', '77012345678', '+998935556677'],
    'Buyurtmangiz yolga chiqdi');

echo "yuborildi: {$n}", PHP_EOL;
foreach ($adapter->xatolar() as $x) {
    echo 'xato: ', $x, PHP_EOL;
}

$manzillar = ['+998901112233', '+998935556677'];

/** @var list<Yuboruvchi> $yuboruvchilar */
$yuboruvchilar = [
    new OzXizmatimiz(),
    new SmsGatewayAdapter(new SmsGateway()),
];

foreach ($yuboruvchilar as $y) {
    printf("%s:%s", $y::class, PHP_EOL);
    printf("  natija: %d%s", xabarTarqat($y, $manzillar, 'Test'), PHP_EOL);
}

// diqqat: bu sinf `final` EMAS - aks holda meros ishlamas edi
class Eski
{
    public function hisobla(int $a, int $b): int
    {
        return $a + $b;
    }
}

interface Yangi
{
    public function qosh(array $sonlar): int;
}

// Meros bilan: adapter moslashtirilayotgan sinfning vorisi
final class MerosAdapter extends Eski implements Yangi
{
    public function qosh(array $sonlar): int
    {
        $jami = 0;
        foreach ($sonlar as $s) {
            $jami = $this->hisobla($jami, $s);
        }
        return $jami;
    }
}

$a = new MerosAdapter();
echo $a->qosh([1, 2, 3, 4, 5]), PHP_EOL;
echo $a->hisobla(10, 5), PHP_EOL;   // eski metod ham ochiq

// Tashqi API shunday javob beradi
$apiJavobi = '{"data":{"user_id":42,"full_name":"Malika Ergasheva",'
    . '"reg_ts":1735689600,"is_active":1}}';

// Bizning tizim esa shunaqa obyekt kutadi
final readonly class Foydalanuvchi
{
    public function __construct(
        public int $id,
        public string $ism,
        public DateTimeImmutable $royxatdanOtgan,
        public bool $faol,
    ) {}
}

final class ApiAdapter
{
    public function foydalanuvchi(string $json): Foydalanuvchi
    {
        $x = json_decode($json, true, 512, JSON_THROW_ON_ERROR)['data'];

        return new Foydalanuvchi(
            id: (int) $x['user_id'],
            ism: (string) $x['full_name'],
            royxatdanOtgan: (new DateTimeImmutable())
                ->setTimestamp((int) $x['reg_ts'])
                ->setTimezone(new DateTimeZone('UTC')),
            faol: (bool) $x['is_active'],
        );
    }
}

$f = (new ApiAdapter())->foydalanuvchi($apiJavobi);

printf("#%d %s%s", $f->id, $f->ism, PHP_EOL);
printf("royxat: %s%s", $f->royxatdanOtgan->format('Y-m-d H:i'), PHP_EOL);
printf("faol: %s%s", $f->faol ? 'ha' : 'yoq', PHP_EOL);

// Eski uslubdagi sinf - massiv qaytaradi
final class EskiOmbor
{
    public function hammasi(): array
    {
        return [
            ['id' => 1, 'nom' => 'Klaviatura'],
            ['id' => 2, 'nom' => 'Sichqoncha'],
            ['id' => 3, 'nom' => 'Monitor'],
        ];
    }
}

// Adapter uni foreach bilan ishlatiladigan qilib beradi
final class OmborIterator implements IteratorAggregate, Countable
{
    public function __construct(private readonly EskiOmbor $ombor) {}

    public function getIterator(): Generator
    {
        foreach ($this->ombor->hammasi() as $qator) {
            yield $qator['id'] => $qator['nom'];
        }
    }

    public function count(): int
    {
        return count($this->ombor->hammasi());
    }
}

$mahsulotlar = new OmborIterator(new EskiOmbor());

echo 'jami: ', count($mahsulotlar), PHP_EOL;
foreach ($mahsulotlar as $id => $nom) {
    printf("%d. %s%s", $id, $nom, PHP_EOL);
}

// Adapter: interfeys A -> interfeys B
echo 'Adapter:   send(array) -> yubor(string, string)', PHP_EOL;
// Decorator: interfeys A -> o'sha interfeys A, lekin ko'proq ish bilan
echo 'Decorator: yubor() -> yubor() + jurnalga yozish', PHP_EOL;
// Facade: 5 ta sinf -> 1 ta oddiy metod
echo 'Facade:    5 sinf -> buyurtmaniRasmiylashtir()', PHP_EOL;