Validator Hook constructs that provide means to execute validation against resolved feature flag values.
This package also builds on various PSRs (PHP Standards Recommendations) such as the Logger interfaces (PSR-3) and the Basic and Extended Coding Standards (PSR-1 and PSR-12).
$ composer require open-feature/validators-hook // installs the latest version
The following validator hook constructs are available, but more are being worked on over time:
RegexpValidatorHoook
use OpenFeature\Hooks\Validators\RegexpValidatorHook;
$alphanumericValidator = new RegexpValidatorHook('/^[A-Za-z0-9]+$/');
$hexadecimalValidator = new RegexpValidatorHook('/^[0-9a-f]+$/');
$asciiValidator = new RegexpValidatorHook('/^[ -~]$/');
// hooks can be applied to the global API, clients, providers, and resolution invocations
// all feature flag resolutions will use this validator
$api = OpenFeatureAPI::getInstance();
$api->addHooks($asciiValidator);
// invocations from this client will use this validator also
$client = $api->getClient('example');
$client->setHooks([$alphanumericValidator]);
// this specific invocation will use this validator also
$client->resolveBooleanValue('test-flag', 'deadbeef', null, new EvaluationOptions([$hexadecimalValidator]));For more examples, see the examples.
This library targets PHP version 7.4 and newer. As long as you have any compatible version of PHP on your system you should be able to utilize the OpenFeature SDK.
This package also has a .tool-versions file for use with PHP version managers like asdf.
Install dependencies with composer install. composer install will update the composer.lock with the most recent compatible versions.
We value having as few runtime dependencies as possible. The addition of any dependencies requires careful consideration and review.
Run tests with composer run test.