PHPackages                             useburrow/sdk-php - 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. [Utility & Helpers](/categories/utility)
4. /
5. useburrow/sdk-php

ActiveLibrary[Utility & Helpers](/categories/utility)

useburrow/sdk-php
=================

Burrow PHP SDK for plugin integrations.

v0.9.5(2mo ago)0671MITPHPPHP ^8.2

Since Mar 18Pushed 2mo agoCompare

[ Source](https://github.com/useburrow/sdk-php)[ Packagist](https://packagist.org/packages/useburrow/sdk-php)[ Docs](https://github.com/useburrow/sdk-php)[ RSS](/packages/useburrow-sdk-php/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (1)

Burrow PHP SDK
==============

[](#burrow-php-sdk)

Official PHP SDK for integrating WordPress, Craft, Statamic, ExpressionEngine, and other PHP plugin ecosystems or frameworks with the Burrow platform.

What Burrow Does
----------------

[](#what-burrow-does)

Burrow helps plugin teams turn product activity into reliable, structured signals that power onboarding visibility, operational automation, and product analytics.

With Burrow, plugins can:

- discover and link tenant/project context
- publish canonical events across forms, ecommerce, and system channels
- keep historical backfills aligned with real source timestamps
- route data safely with scoped ingestion keys and project guards
- use retry + outbox primitives for durable delivery

Why Use This SDK
----------------

[](#why-use-this-sdk)

This SDK provides a framework-agnostic integration layer so plugin code can stay focused on CMS specifics while Burrow concerns stay centralized:

- typed client for onboarding, contracts, events, and backfill APIs
- canonical event envelope builders and validation helpers
- retry-aware transport and normalized API error classification
- in-memory and SQL outbox building blocks for resilient event dispatch

Installation
------------

[](#installation)

```
composer require useburrow/sdk-php
```

Requirements
------------

[](#requirements)

- PHP 8.2+

Quick Start
-----------

[](#quick-start)

```
use Burrow\Sdk\Client\BurrowClient;
use Burrow\Sdk\Transport\CurlHttpTransport;
use Burrow\Sdk\Transport\RetryPolicy;

$transport = new CurlHttpTransport(
    timeoutSeconds: 8,
    retryPolicy: new RetryPolicy(maxAttempts: 3, baseDelayMilliseconds: 200)
);

$client = new BurrowClient(
    baseUrl: 'https://app.useburrow.com',
    apiKey: 'your-plugin-api-key',
    transport: $transport
);
```

Typical Plugin Flow
-------------------

[](#typical-plugin-flow)

1. Call onboarding discover/link during plugin setup.
2. Submit/fetch forms contracts and persist mapping metadata.
3. Publish real-time canonical events as plugin activity occurs.
4. Run historical backfill after contract setup is finalized.
5. Use outbox delivery for idempotent retries and outage resilience.

Example: Publish an Event
-------------------------

[](#example-publish-an-event)

```
use Burrow\Sdk\Events\EventEnvelopeBuilder;

$event = EventEnvelopeBuilder::build([
    'organizationId' => 'org_123',
    'clientId' => 'cli_123',
    'channel' => 'forms',
    'event' => 'forms.submission.received',
    'timestamp' => gmdate('c'),
    'properties' => ['submissionId' => 'sub_123'],
    'tags' => ['formId' => 'contact'],
]);

$client->publishEvent($event);
```

Development
-----------

[](#development)

```
composer install
composer test
```

License
-------

[](#license)

MIT. See `LICENSE`.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance83

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~3 days

Total

3

Last Release

89d ago

### Community

Maintainers

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

---

Top Contributors

[![siebird](https://avatars.githubusercontent.com/u/10938?v=4)](https://github.com/siebird "siebird (34 commits)")

---

Tags

phpsdkeventspluginsburrow

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[zumba/symbiosis

Symbiosis, event structure for bootstrapping plugins.

1361.1k1](/packages/zumba-symbiosis)

PHPackages © 2026

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