emartech/session-validator-client

PHP client for Emarsys session validator service

4.0.0 2025-03-10 14:43 UTC

Requires

• php: >=8.1
• emartech/escher: ^4.0
• guzzlehttp/guzzle: ^7.4
• psr/log: ^3.0

Requires (Dev)

• phpunit/phpunit: ^10.0
• squizlabs/php_codesniffer: ^3.3

Suggests

• ext-apcu: Needed to support APC cache

MIT

• Emarsys Technologies

README

PHP client for Emarsys session validator service

Install

composer require emartech/session-validator-client

Usage

Create client

Escher example:

$client = Client::create('https://session-validator.gservice.emarsys.net', 'escher_key', 'escher_secret');

mTLS example:

$client = Client::create('http://session-validator-web.security');

Check Session Validity

isValid provides a function to validate user session using either a msId or a sessionDataToken.

Name	Type	Throws	Description
msId	string	-	Deprecated and will be removed in the future
sessionDataToken	string	SessionDataError

var_dump($client->isValid('msid'));

var_dump($client->isValid('session-data-token'));

Batch validating multiple MSIDs

Returns an array of the invalid MSIDs.

Warning: The batch validation is deprecated and will be removed in the future.

var_dump($client->filterInvalid(['msid1', 'msid2']));

Caching results

$client = Client::create('https://session-validator.gservice.emarsys.net', 'escher_key', 'escher_secret');
$cachedClient = CachedClient::create($client);

var_dump($cachedClient->isValid('msid')); // OR
var_dump($cachedClient->isValid('session-data-token'));

Fetch session data

getSessionData provides a function to fetch user session data object using a sessionDataToken.

const sessionData = $client->getSessionData('session-data-token');

Logging

To enable logging, add a PSR-3 compatible logger to the client

use Monolog\Logger;

$client->setLogger(new Logger('name'));

Local development

make install
make test
make style