README

Curlmetry

🌀 PSR-18 / PSR-7 OpenTelemetry trace exporter for PHP 5.6 — powered by curl

Curlmetry is a lightweight tracing library for legacy PHP applications (5.6+).
It exports spans to SigNoz or Jaeger via HTTP, and provides a native PSR-18 client using plain curl.

No Guzzle. No Symfony. No Composer autoload hell. Just PSR + curl.

✨ Features

• 📦 PSR-18 client (native curl-based)
• 📡 Exports spans to:
  • OTLP (SigNoz via HTTP JSON)
  • Jaeger (via /api/traces)
• 🔧 Span / Tracer / Scope system (OpenTelemetry-style)
• 🧵 Context management (attach(), detach(), Scope)
• 🕵️ Exception + status reporting
• 🐘 Works with PHP 5.6

📦 Installation

composer require sarigue/curlmetry

Or just clone and require 'vendor/autoload.php';

🚀 Example: OTLP export

use Curlmetry\Tracer;
use Curlmetry\Exporter\OtlpExporter;
use Curlmetry\Processor\SimpleSpanProcessor;

$exporter = new OtlpExporter('http://localhost:4318/v1/traces');
$processor = new SimpleSpanProcessor($exporter, 'curlmetry-demo');
$tracer = new Tracer($processor);

$tracer->startActiveSpan('http.request', function ($span) {
    $span->setAttribute('http.method', 'GET');
    $span->addEvent('processing', ['step' => 'controller']);
    usleep(5000);
});

🌐 PSR-18 usage

use Curlmetry\Psr\CurlHttpClient;
use Curlmetry\Psr\Request;

$client = new CurlHttpClient();

$request = new Request(
    'POST',
    'http://localhost:4318/v1/traces',
    ['Content-Type' => ['application/json']],
    json_encode(['resourceSpans' => [...]])
);

$response = $client->sendRequest($request);
echo $response->getStatusCode();

📚 Docs

• demo.php — standard usage
• demo-psr.php — manual PSR request
• demo-jaeger.php — Jaeger JSON exporter

🛠 Roadmap

• OTLP export (HTTP JSON)
• Jaeger export
• PSR-18 Curl client
• Scope context
• Trace context propagation (W3C)
• Batch processor
• Middleware integration

📝 License

Apache 2.0 — © 2025 Sarigue