This package is abandoned and no longer maintained. No replacement package was suggested.

A PHP Prometheus client library

v0.4.0 2022-01-10 21:21 UTC

This package is auto-updated.

Last update: 2023-06-29 10:25:58 UTC


Since Tweede Golf does not use / maintain this library anymore (for several years already) - this repository is archived. If you like like to maintain this - please contact us at

Tweede Golf Prometheus PHP Client

A PHP Client for prometheus, providing several storage backends. This client mostly follows the guidelines as specified in the prometheus docs.

This library currently does not implement the Summary metric type. For users of Symfony a prometheus client bundle is available.


This library uses Composer. Simply run the following command to add it as a dependency to your project:

composer require tweedegolf/prometheus-client


To start, you must create a CollectorRegistry. To this registry you may register any number of metric collectors. To create a collector registry you must specificy a storage adapter. For easy setup you may want to try the APC or APCU Storage adapters. See the example below:

use TweedeGolf\PrometheusClient\CollectorRegistry;
use TweedeGolf\PrometheusClient\Storage\ApcuAdapter;

$registry = new CollectorRegistry(new ApcuAdapter());
$registry->createCounter('requests', [], null, true);
$registry->createGauge('traffic', ['endpoint'], 'Active traffic per endpoint', true);

Next on some event (like a request entering your application) you can modify the existing metrics. An example is shown below:

$registry->getGauge('traffic')->set(10, ['/home']);

Finally your application should expose some endpoint where metrics can be scraped by Prometheus:

use TweedeGolf\PrometheusClient\Format\TextFormatter;

$formatter = new TextFormatter();
header('Content-Type', $formatter->getMimeType());
echo $formatter->format($registry->collect());