PHPackages                             ucp-php-sdk/core - 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/core

ActiveLibrary

ucp-php-sdk/core
================

Core library for the UCP PHP SDK

0.0.5(3w ago)01.7k↑1193.8%1MITPHPPHP ^8.1

Since Jul 13Pushed 3w agoCompare

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

READMEChangelogDependencies (2)Versions (8)Used By (1)

Core Package
============

[](#core-package)

This package is the framework-free heart of the SDK.

Package name: `ucp-php-sdk/core`

It contains:

- immutable UCP models and enums
- capability, payment handler, and adapter contracts
- request context, security, negotiation, validation, and webhook service interfaces
- repository interfaces for SDK infrastructure state
- optional adapter-backed capability implementations for platform integrations
- committed schema artifacts for UCP `2026-04-08`

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

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

Use this package when you want to build UCP support without taking a dependency on Symfony HTTP wiring.

Install:

```
composer require ucp-php-sdk/core:^0.0.1
```

Recommended integration pattern:

1. Either implement capability interfaces directly, or implement platform adapters such as `CatalogAdapterInterface` or `CheckoutAdapterInterface`.
2. If you use adapters, return the public SDK DTOs from those adapters.
3. Wrap the adapters with the provided adapter-backed capabilities only if you want to keep descriptor wiring separate from your platform code.
4. Expose those capabilities through the Symfony bundle or your own transport layer.

Example:

```
$capability = new AdapterBackedOrderCapability(
    new CapabilityDescriptor('dev.ucp.shopping.order', '2026-04-08', 'https://ucp.dev/specification/order/', 'https://ucp.dev/schemas/shopping/order.json'),
    $orderAdapter,
);
```

This package must stay shop-agnostic. Do not put Shopware or other platform entity classes here.

Use `ManagedSigningKey`, `PublicSigningKey`, and `ManagedSigningKeyRepositoryInterface` for signing-key lifecycle work.

SDK-local canonical JSON is exposed through `DeterministicJsonInterface`.

Schema layout notes:

- `resources/schema/pinned` contains the committed upstream schema snapshot with its original folder layout.
- `resources/schema/generated` contains the flattened request and response validator files the runtime loads directly.
- See [resources/schema/README.md](resources/schema/README.md) for the exact split.

Internal runtime code under `src/Internal` is covered by the dead-code and coverage QA gates. Public contracts and DTOs are not treated as dead code just because the repo does not instantiate them directly.

For technical structure, stable API notes, and agent examples, see [AGENTS.md](AGENTS.md).

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance95

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 83.3% 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 (2 commits)")

### Embed Badge

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

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

###  Alternatives

[laravel/socialite

Laravel wrapper around OAuth 1 & OAuth 2 libraries.

5.7k118.2M1.0k](/packages/laravel-socialite)[shopware/platform

The Shopware e-commerce core

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

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

769306.5k56](/packages/civicrm-civicrm-core)[leantime/leantime

Open source project management system for non-project managers. Simple like Trello, powerful like Jira. Built with neurodiversity in mind.

11.3k4.0k](/packages/leantime-leantime)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

605.9M716](/packages/shopware-core)[shopware/administration

Administration frontend for the Shopware Core

414.6M146](/packages/shopware-administration)

PHPackages © 2026

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