logtrace/logtrace-php

PHP client for the Logtrace API

v0.0.1 2026-06-04 07:54 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-json: *

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

README

PHP client for the Logtrace API. Requires PHP ≥ 8.1.

Install

composer require logtrace/logtrace-php

Usage

use Logtrace\Client;
use Logtrace\CreateEventRequest;

$client = new Client(getenv('LOGTRACE_API_KEY'));

$client->createEvent(new CreateEventRequest(
    actionName:      'user.signup',
    userId:          '123',
    metadata:        ['plan' => 'pro'],
));

$client->createSession(new CreateSessionRequest(...));
$client->createAuditLog(new CreateAuditLogRequest(...));

PSR-15 middleware

Automatically attaches request context (IP, method, endpoint, headers, status code) to every call made inside a handler.

use Logtrace\Middleware;

$app->add(new Middleware($client));

Inside any handler:

$rc = $request->getAttribute(Middleware::ATTRIBUTE);

$rc->createEvent(new CreateEventRequest(
    actionName: 'order.placed',
    // ...
));

Error handling

use Logtrace\LogtraceException;

try {
    $client->createEvent($req);
} catch (LogtraceException $e) {
    echo $e->statusCode; // HTTP status
    echo $e->getMessage();
}