tiden/telemetry-php

Tiden error-tracking PHP SDK. Emits the envelope wire format to a Tiden ingest endpoint, with no third-party error-SDK dependency.

v0.1.1 2026-06-10 10:15 UTC

Requires

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

Requires (Dev)

• laravel/pint: ^1.18
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.5

MIT

• php
• sdk
• error-tracking
• tiden

README

Framework-agnostic error-tracking PHP SDK for Tiden. Emits the envelope wire format to a Tiden ingest endpoint — no third-party error-SDK dependency. For Laravel, use the tiden/telemetry-laravel bridge (built on this).

composer require tiden/telemetry-php

use Tiden\Sdk;

Sdk::init([
    'dsn' => getenv('TIDEN_DSN'), // http://<publicKey>@<host:ingestPort>/<projectId>
    'release' => 'my-app@1.2.3',
    'environment' => 'production',
    // 'send_default_pii' => false, // default: scrub likely-PII before send
]);

// With captureGlobals (default), uncaught exceptions + fatals are reported
// automatically. Manual capture:
try {
    risky();
} catch (\Throwable $e) {
    Sdk::captureException($e);
}

Sdk::captureMessage('checkout completed', 'info');
Sdk::addBreadcrumb(new \Tiden\Breadcrumb('cache miss', category: 'cache'));
Sdk::configureScope(fn ($s) => $s->setTag('tenant', 'acme'));

What it does

• Parses the DSN to the edge URL /api/<projectId>/envelope/?tiden_key=….
• Normalizes \Throwable (incl. cause chains) into exception.values[] with stack frames (in_app heuristic, app-relative paths).
• Serializes the envelope and POSTs it via curl (synchronous, never throws; honors HTTP 429 + Retry-After).
• Scrubs likely-PII (auth headers, secret-ish keys) unless send_default_pii.
• before_send hook to mutate or drop events.

Source maps are a browser concern (JS bundles); PHP isn't minified, so there is no source-map counterpart here.

Develop

composer install
composer test

MIT © Qase