confeature / confeature-php-sdk

v0.1.0 2026-10-16 11:40 UTC

Requires

• php: >=8.1
• guzzlehttp/guzzle: ^7.0
• psr/log: ^3.0
• psr/simple-cache: ^3.0

Requires (Dev)

• configcat/configcat-client: ^9.2
• friendsofphp/php-cs-fixer: ^3.0
• phpunit/phpunit: ^10.0

MIT

• MakerLabs

• configuration
• feature-toggle
• configcat
• feature-flag
• confeature

Published on Packagist.org on 2026-10-16 12:08 UTC

README

confeature/confeature-php-sdk

PHP SDK for Confeature. Drop-in compatible with the upstream configcat/configcat-php-sdk package — class names, factory signatures, option keys, polling modes and override semantics mirror ConfigCat 1:1 (a project rule, checked by its conformance tests).

Install

composer require confeature/confeature-php-sdk

Requires PHP 8.1+.

The package is published from confeature/confeature-php-sdk, a read-only mirror of apps/sdk-php/ in confeature/sdks, where changes are made.

Quickstart

<?php

use Confeature\ConfeatureClient;
use Confeature\PollingMode;
use Confeature\User;

$client = ConfeatureClient::create('configcat-sdk-1/<22 chars>/<22 chars>', [
    'pollingMode' => PollingMode::autoPoll(),
]);

$user = new User('[e-mail]');
$enabled = $client->getValue('feature.dark-mode', false, $user);

$client->close();

SDK key format

Confeature mints SDK keys in ConfigCat's own shape, configcat-sdk-1/<22 chars>/<22 chars> (characters [A-Za-z0-9_-]), so the same key also works in a stock ConfigCat SDK. Keys minted earlier, confeature-sdk-1-<32 chars>-<32 chars>, stay valid until rotated. Confeature\Internal\SdkKey::isValidConfeatureKeyFormat() accepts both; any other string logs an INVALID_SDK_KEY warning (with the key redacted) but the client is still created. SDK keys never appear verbatim in a log line, and cache entries are named after a SHA-256 digest of the key, never the key itself.

Migrating from configcat/configcat-php-sdk

- use ConfigCat\ConfigCatClient as ConfeatureClient;
+ use Confeature\ConfeatureClient;
- $client = new ConfeatureClient('YOUR_SDK_KEY');
+ $client = ConfeatureClient::create('YOUR_SDK_KEY');

Full reference: https://docs.confeature.io/sdks/php/.

Licensed under MIT.