PHP: SDK botmetria/ucp

WooCommerce и витрина из фида — 15 минут · SDK — около часа · 4 способа · работает не только на WordPress

Самописный магазин или Laravel — агентская коммерция подключается Composer-пакетом и ~50 строками адаптера. MIT, ноль зависимостей, PHP ≥ 8.1.

Packagist → GitHub →

Установка

composer require botmetria/ucp

Быстрый старт

Две строки в самом верху фронт-контроллера (index.php), до роутинга приложения:

use Botmetria\Ucp\Ucp;
use Botmetria\Ucp\ArrayProductProvider;

$ucp = new Ucp([
    'store_name' => 'My Shop',
    'store_url'  => 'https://my-shop.com/',
    'currency'   => 'EUR',
    'products'   => new MyProducts(),  // ProductProviderInterface
    // 'cart'    => new MyCart(),      // CartProviderInterface: agent checkout
]);
$ucp->run(); // serves /.well-known/ucp and /ucp/v1/*

Два уровня — один пакет

Витрина (только каталог)

Реализуйте ProductProviderInterface — агенты видят каталог, манифест честно сообщает checkout:false.

Полный чекаут

Добавьте CartProviderInterface::fill() — агент собирает корзину, покупатель оплачивает в вашем родном чекауте.

Фреймворки

Laravel — middleware в глобальный стек; Slim/Mezzio — PSR-15 middleware; чистый PHP — $ucp->run() в фронт-контроллере. Примеры — в README пакета.

Аналитика на PHP

Для учёта ИИ-ботов вставьте PHP-коллектор из кабинета (раздел «Подключение»). Честно: на PHP коллектор считает трафик, но не блокирует — блокировка работает в плагине WooCommerce и Node-коллекторе.

Проверка

Манифест на вашем домене плюс живое демо покупки:

curl https://your-store.com/.well-known/ucp

Пакет и исходники: Packagist · GitHub · Спецификация UCP и self-hosting