localzet/personal-analytics

Framework-agnostic single-project web analytics collector and reporting library

v0.2.0 2026-08-04 20:15 UTC

Requires

• php: ^8.2
• ext-json: *
• ext-mbstring: *
• ext-pdo: *

Requires (Dev)

• phpunit/phpunit: ^11.0 || ^12.0

AGPL-3.0-or-later

• Ivan Zorin

Published on Packagist.org on 2026-08-04 20:16 UTC

README

Framework-neutral, single-project analytics collector and reporting library for PHP 8.2+ and MySQL 8.

composer require localzet/personal-analytics

Apply database/mysql.sql, create a PDO connection and construct the analytics facade:

use Localzet\PersonalAnalytics\Analytics;
use Localzet\PersonalAnalytics\Config;

$analytics = new Analytics($pdo, new Config(
    projectToken: $_ENV['ANALYTICS_TOKEN'],
    allowedHost: 'app.example.com',
    allowedOrigins: ['https://app.example.com'],
));

Route collector JSON to $analytics->collector->collectJson(). Protect reporting endpoints with the host application's authentication and authorization. A complete minimal adapter is available in ../examples/plain-php.

The package stores lifecycle events, safe interactions, UTM attribution, goals, heatmaps and compressed replay chunks. Sensitive values must never be passed as custom properties; the collector also redacts common sensitive keys.

License

Copyright (C) 2025-2026 Zorin Projects S.P.. Created and maintained by Ivan Zorin.

Licensed under AGPL-3.0-or-later. Preserve the included NOTICE when redistributing the package.