phattarachai / watchtower-core

v1.2.0 2026-10-10 10:56 UTC

Requires

• php: ^8.4
• ext-json: *
• ext-mbstring: *
• ext-zlib: *

Requires (Dev)

• laravel/pint: ^1.24
• pestphp/pest: ^4.0

MIT

• Phattarachai Chaimongkol

• sentry
• envelope
• Fingerprint
• watchtower
• error-tracking
• exception-tracking

Published on Packagist.org on 2026-10-10 10:56 UTC

README

Framework-agnostic building blocks shared by the Watchtower server and its client packages. Pure PHP — no Laravel container, no service provider, nothing to register.

Install

composer require phattarachai/watchtower-core

What's inside

Class	Purpose
Sentry\AuthHeader	Parses the X-Sentry-Auth header into version / key / client / secret.
Sentry\EnvelopeParser	Parses a Sentry envelope v7 body into a header plus EnvelopeItems.
Sentry\EnvelopeItem	One envelope item: raw headers plus a decoded array or raw string payload.
Ingest\MessageNormalizer	Collapses the variable parts of exception, PHP engine error and SQL messages.
Ingest\Fingerprinter	Computes the stable issue-group fingerprint and title for an event payload.
Ingest\EventScrubber	Redacts secret headers and keys in request, extra, tags and breadcrumb data; optionally strips row values out of SQL error messages (redactSqlValues: true).
Ingest\EventNormalizer	Keeps only allow-listed top-level fields and context keys; strips NUL bytes.
Ingest\EventTruncator	Trims an event to a JSON byte budget, Sentry-style: caps strings, keeps the last 100 breadcrumbs, then drops breadcrumb data, extra, the request body, frame locals and deep-stack middles until it fits. Tags a trimmed event watchtower.truncated.
Ingest\EventPipeline	scrub → normalize → truncate, plus the fingerprint and title. Run it before queueing an event so secrets and unbounded payloads never reach the queue backend; it is idempotent, so the worker can run it again.
Alerts\LevelRanker	Compares Sentry severity levels against a minimum threshold.
Support\Gzip	Decodes a request body that may carry Content-Encoding: gzip. Pass $maxBytes to cap the inflated size — wire-size limits only see the compressed body.
Support\DsnParser	Parses scheme://public_key@host[:port]/<project id> into its parts plus a relay URL.

Ingest example

use Phattarachai\WatchtowerCore\Ingest\{EventNormalizer, EventPipeline, EventScrubber, EventTruncator};
use Phattarachai\WatchtowerCore\Support\Gzip;

$body = Gzip::decodeBody($rawBody, $contentEncoding, maxBytes: 20 * 1_048_576);

$pipeline = new EventPipeline(
    new EventScrubber($headerKeys, $bodyKeys, redactSqlValues: true),
    new EventNormalizer($allowedEventFields, $allowedContextKeys),
    new EventTruncator(maxEventBytes: 200_000, maxStringBytes: 8_192),
);

$event = $pipeline->prepare($payload);      // queue this, not $payload
$fingerprint = $pipeline->fingerprint($event);

Testing

composer test

License

MIT

ผู้พัฒนา

พัฒนาและดูแลโดย บริษัท ภัทรชัย อาร์ทิซาน จำกัด (Phattarachai Artisan) บริษัทที่ปรึกษาและพัฒนาเว็บ ที่เรียนรู้และแบ่งปันกับชุมชน Laravel แพ็กเกจนี้แบ่งปันให้ชุมชนนำไปใช้และต่อยอดได้อย่างอิสระ

ดูแพ็กเกจอื่นของเราได้ที่ phattarachai.dev/open-source และติดต่อเราได้ที่ phattarachai.dev