Разработка каталога: от простого к сложному на PHP

Как организовать каталог с данными в JSON?

Для небольших статических каталогов с редкими изменениями удобно хранить данные в JSON-файле. Реализация проста, не требует базы данных.

class JsonCatalog {
    private string $filePath;
    private array $items;

    public function __construct(string $filePath) {
        $this->filePath = $filePath;
        $this->items = $this->load();
    }

    private function load(): array {
        if (!file_exists($this->filePath)) {
            return [];
        }
        $json = file_get_contents($this->filePath);
        return json_decode($json, true) ?? [];
    }

    public function getItems(): array {
        return $this->items;
    }

    public function getItemById(int $id): ?array {
        foreach ($this->items as $item) {
            if ($item['id'] == $id) {
                return $item;
            }
        }
        return null;
    }

    public function filter(string $field, $value): array {
        return array_filter($this->items, function($item) use ($field, $value) {
            return isset($item[$field]) && $item[$field] == $value;
        });
    }
}

Цель: быстрое прототипирование и простые проекты с малым объемом данных. Случаи использования: лендинги, небольшие сайты-визитки.

Как использовать XML для каталога?

XML предоставляет строгую структуру данных, поддерживает XPath для выборки. Подходит для обмена данными с другими системами.

class XmlCatalog {
    private SimpleXMLElement $xml;

    public function __construct(string $filePath) {
        $this->xml = simplexml_load_file($filePath);
    }

    public function getItems(): array {
        $items = [];
        foreach ($this->xml->item as $item) {
            $items[] = [
                'id' => (int)$item->id,
                'name' => (string)$item->name,
                'price' => (float)$item->price
            ];
        }
        return $items;
    }

    public function filterByPrice(float $maxPrice): array {
        $result = $this->xml->xpath("//item[price <= $maxPrice]");
        // ... преобразование
    }
}

Цель: интеграция с системами, использующими XML. Случаи использования: обмен данными с 1С, экспорт/импорт.

Как внедрить ORM для каталога?

ORM (например, Doctrine) позволяет работать с объектами, а не с SQL-запросами. Упрощает поддержку и расширение.

// Сущность Item (аннотации или атрибуты)
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
#[ORM\Table(name: 'items')]
class Item {
    #[ORM\Id, ORM\Column(type: 'integer'), ORM\GeneratedValue]
    private int $id;

    #[ORM\Column(type: 'string')]
    private string $name;

    // getters/setters
}

// Репозиторий
class ItemRepository extends ServiceEntityRepository {
    public function findByCategory(int $categoryId): array {
        return $this->createQueryBuilder('i')
            ->where('i.category = :cat')
            ->setParameter('cat', $categoryId)
            ->getQuery()
            ->getResult();
    }
}

Цель: большие проекты с множеством сущностей и сложной логикой. Случаи использования: полноценные CMS, ERP-системы.

Какие готовые решения упрощают создание каталога?

Существуют библиотеки, предоставляющие готовую реализацию каталога, например, cocur/catalog или компоненты Symfony.

composer require cocur/catalog

use Cocur\Catalog\Catalog;
use Cocur\Catalog\Item;

$catalog = new Catalog();
$item = new Item('1', 'Товар', 100.0);
$catalog->addItem($item);
$items = $catalog->getItems();

Цель: быстрая разработка без необходимости писать все с нуля. Случаи использования: прототипы, проекты с ограниченными требованиями.