PHPackages                             ucp-php-sdk/symfony-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. ucp-php-sdk/symfony-bundle

ActiveLibrary

ucp-php-sdk/symfony-bundle
==========================

Symfony bundle for the UCP PHP SDK

0.0.5(3w ago)01.8k↑2700%MITPHPPHP ^8.1

Since Jul 13Pushed 3w agoCompare

[ Source](https://github.com/agentic-commerce-alliance/ucp-php-sdk-symfony-bundle)[ Packagist](https://packagist.org/packages/ucp-php-sdk/symfony-bundle)[ RSS](/packages/ucp-php-sdk-symfony-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (22)Versions (8)Used By (0)

Symfony Bundle
==============

[](#symfony-bundle)

This package exposes the core SDK through Symfony services and HTTP endpoints.

Package name: `ucp-php-sdk/symfony-bundle`

It contains:

- bundle registration and configuration
- routes and controllers for discovery, catalog, cart, checkout, tokenization, OAuth, order read, A2A, and embedded surfaces
- request-context and idempotency listeners
- protocol JSON mapping
- default storage adapters based on Doctrine DBAL
- signing key and storage cleanup console commands

How To Use It
-------------

[](#how-to-use-it)

Use this package when the host app is Symfony and you want the SDK wired into HTTP endpoints quickly.

Install:

```
composer require ucp-php-sdk/symfony-bundle:^0.0.1
```

The default bundle stack gives you:

- runtime config resolution
- request signing and replay protection
- profile building and discovery signing keys
- idempotency handling
- cached remote platform-profile fetches

Basic bundle config:

```
$container->extension('ucp_sdk', [
    'base_uri' => 'https://merchant.example',
    'allowed_profile_hosts' => ['merchant.example'],
    'allowed_agent_domains' => ['merchant.example'],
    'profile_fetching_development_mode' => false,
    'signature_policy' => 'log',
    'transports' => ['rest', 'a2a', 'embedded'],
    'enabled_capabilities' => [
        'dev.ucp.shopping.catalog',
        'dev.ucp.shopping.cart',
    ],
    'transport_endpoints' => [
        'a2a' => 'https://merchant.example/ucp/a2a',
        'embedded' => 'https://merchant.example/ucp/embedded',
    ],
    'storage' => [
        'dsn' => 'sqlite:///%kernel.project_dir%/var/ucp_sdk.sqlite',
    ],
]);
```

Valid `signature_policy` values are `off`, `log`, and `strict`. Valid `transports` values are `rest`, `mcp`, `a2a`, and `embedded`; REST is the default. `enabled_capabilities` is an allowlist of capability descriptor names; the default empty list keeps every registered capability enabled. When `mcp` is enabled, `transport_endpoints.mcp` is required because the shared SDK advertises MCP metadata only and does not provide a default `/ucp/mcp` runtime endpoint. Remote profile fetching is default-deny until `allowed_profile_hosts` is configured. Set `profile_fetching_development_mode` to `true` only for localhost/plain-HTTP development.

Storage Schema
--------------

[](#storage-schema)

The default DBAL repositories do not install or migrate tables automatically. If you use the bundled DBAL storage adapter, call the schema bootstrapper from your install, update, deployment, or startup lifecycle before handling UCP traffic:

```
use Ucp\Sdk\Symfony\Bridge\DoctrineDbal\SchemaBootstrapper;

final readonly class InstallUcpStorage
{
    public function __construct(private SchemaBootstrapper $bootstrapper)
    {
    }

    public function __invoke(): void
    {
        $this->bootstrapper->ensureSchema();
    }
}
```

`SchemaBootstrapper::ensureSchema()` is idempotent and updates only SDK-owned tables. It leaves unrelated application tables untouched.

Replace the default storage adapter by binding repository interfaces to your own services.

The default DBAL-backed repositories are only storage adapters for SDK state. They are not the required integration model for Shopware or any other platform.

The bundle runtime classes are part of the dead-code QA scope. Coverage and internal reference checks focus on bridge code, listeners, commands, controllers, and the realistic merchant example instead of the exported SDK contracts.

For service tags, config shape, and replacement rules, see [AGENTS.md](AGENTS.md).

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance94

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 76.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

7

Last Release

25d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b591df8b79b7942658ffde41e06c9b01feec27a6165634e5be1144dc4aa283e3?d=identicon)[AgenticCommerceAlliance](/maintainers/AgenticCommerceAlliance)

---

Top Contributors

[![BrocksiNet](https://avatars.githubusercontent.com/u/3763023?v=4)](https://github.com/BrocksiNet "BrocksiNet (10 commits)")[![lukasrump](https://avatars.githubusercontent.com/u/32124669?v=4)](https://github.com/lukasrump "lukasrump (3 commits)")

### Embed Badge

![Health badge](/badges/ucp-php-sdk-symfony-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/ucp-php-sdk-symfony-bundle/health.svg)](https://phpackages.com/packages/ucp-php-sdk-symfony-bundle)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

605.9M717](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.4k1.4M241](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.7M3.2k](/packages/contao-core-bundle)[shopware/storefront

Storefront for Shopware

684.9M309](/packages/shopware-storefront)[shopware/administration

Administration frontend for the Shopware Core

414.6M146](/packages/shopware-administration)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)