omnireach / plausible

1.x-dev 2026-10-26 05:24 UTC

Requires

• php: >=8.2
• omnisense/omnireach: ^1.0@dev
• symfony/http-client-contracts: ^3.0

Requires (Dev)

• phpunit/phpunit: ^11.0
• symfony/http-client: ^6.4|^7.0|^8.0

MIT

• Marco Meyer

• analytics
• Audience
• privacy
• framework-agnostic
• plausible
• stats-api
• omnireach

Published on Packagist.org on 2026-10-26 10:05 UTC

README

omnisense/omnireach's Plausible, under any PHP host: visitors, visits, pageviews, bounce rate and visit duration of a site, by page, entry page, source, country, device or day, combined as needed, through Plausible's Stats API v2 - plausible.io or a self-hosted Community Edition.

use Omnireach\Plausible\PlausibleFactory;
use Omnireach\Registry;
use Symfony\Component\HttpClient\HttpClient;

$registry = new Registry([new PlausibleFactory(HttpClient::create())], [
    'stats' => ['factory' => 'plausible', 'options' => ['api_key' => '...', 'site' => 'example.org']],
]);

Options: api_key (a Stats API key), site (the domain as Plausible knows it), url (https://plausible.io).

The API

POST /api/v2/query (https://plausible.io/docs/stats-api) with a bearer key: site_id, metrics, date_range, dimensions (event:page, visit:entry_page, visit:source, visit:country, visit:device, time:day), filters (["is", dimension, [value]]), pagination (10,000 results a page at most). Plausible gives the bounce rate in percent: it is divided by 100. Plausible itself refuses some mixes (session metrics with event dimensions); its message comes back in a ProviderException.

Terms (https://plausible.io/terms): 600 requests an hour per API key by default. Reuse: no PHP client of the Stats API v2 was found to reuse.

Verified, and not

• Verified (the core's harness, PHP 8.4): entry pages with a filter, a daily history by device, pages of results up to the limit, what Plausible cannot answer, a refused key - against answers composed in the shape the Stats API v2 documents, not recorded; every class loading with the package's requirements alone (BareTest).
• Not verified live: no Plausible key was used.

Licence

MIT. An unofficial client, affiliated with Plausible Analytics in no way.