Сборка товарной единицы в PHP-каталоге

Расширенные примеры реализации элемента каталога

Полный класс CatalogItem с поддержкой PDO и транзакций

Ниже приведён пример класса, который не только хранит данные, но и выполняет валидацию, использует подготовленные запросы и работает в рамках транзакций.

<?php
declare(strict_types=1);

class CatalogItem {
    private int $id;
    private string $name;
    private float $price;
    private ?string $description;
    private DateTimeImmutable $createdAt;
    private DateTimeImmutable $updatedAt;

    private const VALID_CATEGORIES = ['Одежда', 'Электроника', 'Книги'];

    public function __construct(array $data) {
        $this->id = (int)($data['id'] ?? 0);
        $this->setName($data['name'] ?? '');
        $this->setPrice((float)($data['price'] ?? 0.0));
        $this->description = $data['description'] ?? null;
        $this->createdAt = new DateTimeImmutable($data['created_at'] ?? 'now');
        $this->updatedAt = new DateTimeImmutable($data['updated_at'] ?? 'now');
    }

    public function setName(string $name): void {
        if (mb_strlen($name) < 2) {
            throw new InvalidArgumentException('Название должно содержать минимум 2 символа');
        }
        $this->name = $name;
    }

    public function setPrice(float $price): void {
        if ($price < 0) {
            throw new InvalidArgumentException('Цена не может быть отрицательной');
        }
        $this->price = $price;
    }

    // ... другие сеттеры

    public function save(PDO $pdo): bool {
        // Валидация перед сохранением
        if (empty($this->name) || $this->price <= 0) {
            throw new RuntimeException('Некорректные данные товара');
        }

        $pdo->beginTransaction();
        try {
            if ($this->id > 0) {
                $sql = 'UPDATE items SET name = :name, price = :price, description = :desc, updated_at = :updated WHERE id = :id';
                $stmt = $pdo->prepare($sql);
                $stmt->execute([
                    ':name' => $this->name,
                    ':price' => $this->price,
                    ':desc' => $this->description,
                    ':updated' => $this->updatedAt->format('Y-m-d H:i:s'),
                    ':id' => $this->id
                ]);
            } else {
                $sql = 'INSERT INTO items (name, price, description, created_at, updated_at) VALUES (:name, :price, :desc, :created, :updated)';
                $stmt = $pdo->prepare($sql);
                $stmt->execute([
                    ':name' => $this->name,
                    ':price' => $this->price,
                    ':desc' => $this->description,
                    ':created' => $this->createdAt->format('Y-m-d H:i:s'),
                    ':updated' => $this->updatedAt->format('Y-m-d H:i:s')
                ]);
                $this->id = (int)$pdo->lastInsertId();
            }
            $pdo->commit();
            return true;
        } catch (PDOException $e) {
            $pdo->rollBack();
            throw new RuntimeException('Ошибка сохранения: ' . $e->getMessage());
        }
    }

    public static function findById(PDO $pdo, int $id): ?self {
        $stmt = $pdo->prepare('SELECT * FROM items WHERE id = :id');
        $stmt->execute([':id' => $id]);
        $data = $stmt->fetch(PDO::FETCH_ASSOC);
        return $data ? new self($data) : null;
    }
}

Результат: при вызове CatalogItem::findById($pdo, 3) будет получен объект товара или null.

Использование интерфейсов для разных типов элементов

Если каталог содержит разнородные товары (например, физические и цифровые), можно определить интерфейс:

<?php
interface CatalogElement {
    public function getId(): int;
    public function getDisplayName(): string;
    public function getPrice(): float;
    public function toArray(): array;
}

class PhysicalItem implements CatalogElement {
    // реализация ...
}

class DigitalItem implements CatalogElement {
    // реализация ...
}

// Функция, работающая с любым элементом каталога
function renderItem(CatalogElement $item): string {
    return sprintf('<div>%s - %.2f руб.</div>', $item->getDisplayName(), $item->getPrice());
}

Это позволяет легко добавлять новые типы элементов без изменения кода рендеринга.

Кэширование данных элемента

Для повышения производительности можно кэшировать объекты товаров с помощью статического массива или внешнего кэша (например, Redis).

class CatalogItem {
    private static array $cache = [];

    public static function findById(PDO $pdo, int $id): ?self {
        if (isset(self::$cache[$id])) {
            return self::$cache[$id];
        }
        $stmt = $pdo->prepare('SELECT * FROM items WHERE id = :id');
        $stmt->execute([':id' => $id]);
        $data = $stmt->fetch(PDO::FETCH_ASSOC);
        $item = $data ? new self($data) : null;
        self::$cache[$id] = $item;
        return $item;
    }

    public function clearCache(): void {
        unset(self::$cache[$this->id]);
    }
}

Результат: повторные запросы одного и того же товара не обращаются к базе данных.