Flags

A flag (gate) is a boolean that resolves per user against rollout + targeting rules defined in the Shipeasy dashboard.

Read a flag

The user is bound once at new Client($user); getFlag takes only the name and an optional default:

use Shipeasy\Client;

$client  = new Client($currentUser);                 // construct once per callsite
$enabled = $client->getFlag('new_checkout');         // default false
$enabled = $client->getFlag('new_checkout', true);   // default true

Assumes Shipeasy\configure() ran at startup — see Installation.

Boolean semantics + default behaviour

The optional default is returned only when the gate cannot be evaluated — NOT when it simply evaluates false:

• gate is off, or its rules/rollout don't match the user → false (NOT the default)
• gate not in the fetched blob (FLAG_NOT_FOUND) → the default
• SDK never initialized (CLIENT_NOT_READY) → the default

When the second argument is omitted the default is false.

Evaluation detail

getFlagDetail() returns a Shipeasy\FlagDetail with ->value (bool) and ->reason explaining how the flag resolved:

$client = new Client($currentUser);   // construct once per callsite
$d      = $client->getFlagDetail('new_checkout');

$d->value;    // bool
$d->reason;   // e.g. FlagDetail::RULE_MATCH

getFlag() is implemented on top of getFlagDetail(). The usage-telemetry beacon fires exactly once per getFlagDetail() call — and never for an override.