README

PHP SDK for flagr.dev — evaluate feature flags with a direct API call. No dependencies beyond ext-curl and ext-json.

Install

composer require flagr/sdk

Requires PHP 8.1+, ext-curl, ext-json.

Quick start

use Flagr\FlagrClient;

$flagr = new FlagrClient(sdkKey: $_ENV['FLAGR_ENV_KEY']);

if ($flagr->isEnabled('new-checkout', tenantId: $userId)) {
    // show new checkout
}

Usage

isEnabled

$enabled = $flagr->isEnabled(
    flagKey:  'new-checkout',
    tenantId: $userId,   // optional, default "" — omit for flags that don't use partial rollout
    default:  false,     // returned if flag is unknown or request fails
);

tenantId is optional. For partially_enabled flags, an empty tenantId always returns false.

Every call makes a single HTTP POST to /evaluate. No local cache, no background connection.

Flag states

Exceptions

Lifecycle

The FlagrClient reuses a single cURL handle across calls — instantiate once and reuse within a request. The handle is closed automatically on destruction.