metricpanel / php

v0.1.0 2026-10-16 16:04 UTC

Requires

• php: ^8.2
• ext-curl: *
• ext-json: *

MIT

Published on Packagist.org on 2026-10-16 16:05 UTC

README

PHP 8.2+ server SDK. Requires cURL and JSON. See the iGaming guide for the contract and reporting.

composer require metricpanel/php:^0.1

$client = new \MetricPanel\Client($serverToken);
$client->igaming($immutableOutboxPayload);

Persist the event ID, timestamp and entire payload in the payment transaction's outbox. Invoke the client from a delivery worker. The client makes one attempt with a two-second connection and ten-second total timeout; the outbox owns retries. DeliveryException exposes retryable, status, errorCode and retryAfterSeconds without exposing credentials or financial payloads. HTTP 409 is a permanent conflict, not a duplicate acknowledgement.

Amounts use exact minor-unit strings and explicit currency precision. The Money value object validates this representation. No method converts floats into money. event() and goal() use the existing general events API; revenue() uses the positive-integer commerce API. They do not share the dedicated iGaming ledger's durable deduplication contract.

Install locally through a Composer path repository with an explicit development version:

{
  "repositories": [
    {
      "type": "path",
      "url": "/path/to/metricpanel/packages/php",
      "options": { "versions": { "metricpanel/php": "0.1.0" } }
    }
  ],
  "require": { "metricpanel/php": "0.1.0" }
}

Run php tests/run.php. Tests use only an in-memory fake HTTP transport and make no network or database requests. Applications can inject their own Transport implementation.