unleash/openfeature-provider

The official Unleash OpenFeature provider for PHP.

v0.1.0 2026-07-29 12:35 UTC

Requires

• php: ^8.4
• ext-json: *
• nyholm/psr7: ^1.8
• open-feature/sdk: ^2.2
• symfony/cache: ^7.0
• symfony/http-client: ^7.0
• unleash/client: ^2.10.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^12.0

Apache-2.0

• Unleash

Published on Packagist.org on 2026-07-29 12:40 UTC

README

The official Unleash OpenFeature provider for PHP.

Requirements

• PHP 8.4+
• Composer

Install

composer require unleash/openfeature-provider

For local development:

composer install

Usage

use OpenFeature\OpenFeatureAPI;
use Unleash\Client\UnleashBuilder;
use Unleash\OpenFeature\Provider\UnleashFlagProvider;

$builder = UnleashBuilder::create()
    ->withAppUrl('https://app.unleash-hosted.com/demo/api')
    ->withInstanceId('default:development.example-token')
    ->withAppName('my-php-app')
    ->withHeader('Authorization', 'default:development.example-token');

OpenFeatureAPI::getInstance()->setProvider(new UnleashFlagProvider($builder));

If you cloned without submodules, initialize the verifier harness:

git submodule update --init --recursive

Build

composer build

Test

composer test

The contract tests use the verifier submodule. To refresh it:

git submodule update --remote --merge verifier

Lint

composer lint
composer format