samuelnogueira/cache-datastore-newrelic

Reports calls to any psr/simple-cache or psr/cache implementation as a custom New Relic Datastore

1.2.0 2025-01-02 18:54 UTC

Requires

• php: ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0
• ext-newrelic: >=7.5.0
• psr/cache: ^3.0
• psr/simple-cache: ^3.0

Requires (Dev)

• phpstan/phpstan: 1.12.7
• phpstan/phpstan-strict-rules: 1.6.1
• phpunit/phpunit: 9.6.16
• squizlabs/php_codesniffer: 3.10.3
• symfony/cache: 6.0.19
• thecodingmachine/phpstan-strict-rules: 1.0.0

Provides

• psr/cache-implementation: 3.0
• psr/simple-cache-implementation: 3.0

MIT

• Samuel Nogueira

• cache
• Simple
• newrelic
• psr
• datastore
• new
• relic

README

Report calls to any psr/simple-cache or psr/cache implementation as a custom New Relic Datastore.

Uses the newrelic_record_datastore_segment function to record calls to an unsupported database.

Requirements

Requires New Relic PHP Agent version >= 7.5.0.

Usage

Decorate your existing:

1. \Psr\Cache\CacheItemPoolInterface
2. \Psr\SimpleCache\CacheInterface

with respectively:

1. \Samuelnogueira\CacheDatastoreNewrelic\CacheItemPoolDecorator
2. \Samuelnogueira\CacheDatastoreNewrelic\SimpleCacheDecorator

Example with PSR-6: Caching Interface:

use Psr\Cache\CacheItemPoolInterface;
use Samuelnogueira\CacheDatastoreNewrelic\CacheItemPoolDecorator;
use Samuelnogueira\CacheDatastoreNewrelic\DatastoreParams;

/** @var CacheItemPoolInterface $cache */

return new CacheItemPoolDecorator(
    $cache, // your cache adapter
    new DatastoreParams('My Database Product'),
);

Example with PSR-16: Common Interface for Caching Libraries (aka Simple Cache):

use Psr\SimpleCache\CacheInterface;
use Samuelnogueira\CacheDatastoreNewrelic\SimpleCacheDecorator;
use Samuelnogueira\CacheDatastoreNewrelic\DatastoreParams;

/** @var CacheInterface $cache */

return new SimpleCacheDecorator(
    $cache, // your cache adapter
    new DatastoreParams('My Database Product'),
);