NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2895 most downloaded on Packagist
ConfigCat is a feature flag, feature toggle, and configuration management service. That lets you launch new features and change your software configuration remotely without actually (re)deploying code. ConfigCat even helps you do controlled roll-outs like canary releases and blue-green deployments.
Latest stable
v9.2.1
Last release 10 months ago
19 Jan 2026
Ships unpredictably
gaps range from 2 weeks to 1.7 years
Most releases are documented
notes for 26 of 37 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
37 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
### Changed - Release for #57
Support for Guzzle v6 due to switching to PSR-18 ClientInterface, which is only supported in Guzzle v7. #49
v6 due to switching to PSR-18 ClientInterface, which is only supported in Guzzle v7. #49In-memory cache layer to custom cache implementations.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
When an error occurs and there is a related Throwable object, pass it to the onError hook handlers.
New features and improvements:
Throwable object, pass it to the onError hook handlers. (#46)forceRefresh fails and there is a related Throwable object, expose it in RefreshResult via the new getErrorException property.forceRefresh method (to stop potential unhandled exceptions thrown by the evaluation logic from bringing down the consumer's application).Breaking changes:
getError property to getErrorMessage in RefreshResult. (Low impact expected.)?Throwable to the onError hook handlers. (Low impact expected.)event_id in the log message but leave it up to the actual logger implementation to choose the log message format. (Affects consumers using custom logging only.)Breaking changes (listed in the order of expected impact):
New features and improvements:
Throwable object, expose it in EvaluationDetails via the new getErrorException property.Bug fixes:
Breaking changes (listed in the order of expected impact):
getError property to getErrorMessage in EvaluationDetails.getMatchedEvaluationRule property to getMatchedTargetingRule and the getMatchedEvaluationPercentageRule property to getMatchedPercentageOption in EvaluationDetails.ConfigCat\Attributes to the ConfigCat\ConfigJson namespace and update them to support config JSON schema v6.…configuration options have been marked as deprecated. Options for Guzzle are available through the \ConfigCat\Http\GuzzleFetchClient::create() method:…
Ability to override the default Guzzle HTTP client with a custom one:
\ConfigCat\Http\FetchClientInterface to give the SDK a custom \Psr\Http\Client\ClientInterface implementation.namespace ConfigCat\Http;
interface FetchClientInterface
{
public function getClient(): \Psr\Http\Client\ClientInterface;
public function createRequest(string $method, string $uri): \Psr\Http\Message\RequestInterface;
}
\ConfigCat\ClientOptions::FETCH_CLIENT configuration option where the SDK accepts a custom \ConfigCat\Http\FetchClientInterface implementation. This option defaults to \ConfigCat\Http\GuzzleFetchClient.\ConfigCat\ClientOptions::REQUEST_OPTIONS and \ConfigCat\ClientOptions::CUSTOM_HANDLER configuration options have been marked as deprecated. Options for Guzzle are available through the \ConfigCat\Http\GuzzleFetchClient::create() method:$client = new \ConfigCat\ConfigCatClient('<SDK-KEY>', [
\ConfigCat\ClientOptions::FETCH_CLIENT => \ConfigCat\Http\GuzzleFetchClient::create([
\GuzzleHttp\RequestOptions::CONNECT_TIMEOUT => 5,
]),
]);
guzzlehttp/guzzle was not removed yet due to minor upgrade backward compatibility. It can be moved to suggest at the next major version bump.php-cs-fixer linter and phpstan static analyzer to the CI workflow. The whole project was reformatted and analyzed, this is why this PR is bigger than usual.
error_log(). It's still replaceable with any psr/log implementation.Standardized config cache key generation algorithm and cache payload format to allow shared caches to be used by SDKs of different platforms.
getFetchTimeUnixSeconds() getter of EvaluationDetails was renamed to getFetchTimeUnixMilliseconds() and now returns the fetch time in float Unix milliseconds.getVariationId() / getAllVariationIds() methods. Alternative: getValueDetails() / getAllValueDetails()Wrong return value of getValueDetails() if a non-existent flag was requested.
getValueDetails() if a non-existent flag was requested.The URL passed via the BASE-URL option was always overridden by the CDN URL from the downloaded config.json.
BASE-URL option was always overridden by the CDN URL from the downloaded config.json.Fixed monolog dependency version for #29
X-ConfigCat-UserAgent HTTP header.Deprecated getVariationId() and getAllVariationIds() methods in favor of getValueDetails() and getAllValueDetails().
getVariationId() and getAllVariationIds() methods in favor of getValueDetails() and getAllValueDetails().LogLevel::NO_LOG cannot be used
setDefaultUser(user) / clearDefaultUser() methods to set / remove a default user object used when there's no user passed to getValue() / getValueDetai
setDefaultUser(user) / clearDefaultUser() methods to set / remove a default user object used when there's no user passed to getValue() / getValueDetails() / getAllValues() / getAllVariationIds() methods.setOffline() / setOnline() methods to indicate whether the SDK is allowed to make HTTP calls or not. In 'offline' mode the SDK works from the cache only.onConfigChanged([String => Setting]) / onFlagEvaluated(EvaluationDetails) / onError(String) hooks. Subscription is possible on the hooks() property of ConfigCatClient.getValueDetails() method to retrieve evaluation details along with the feature flag / setting value. It returns the same details that is passed to onFlagEvaluated(EvaluationDetails) on each evaluation.forceRefresh() method returns with a result object to indicate whether the refresh succeeded or not.ArrayCache has a global static array now that caches the entries between each ConfigCatClient instance. The only differentiator is the sdkKey, so each client instance with the same sdkKey will use the same cache entry.Contents of #22 (Improve testability of implementations using ConfigCatClient as a dependency)
Increased the minimum required PHP version to 7.1
// Cache:
abstract protected function get(string $key); -> abstract protected function get(string $key): ?string;
abstract protected function get(string $key); -> abstract protected function set(string $key, string $value): void;
// ConfigCatClient:
function getValue($key, $defaultValue, User $user = null) -> function getValue(string $key, $defaultValue, User $user = null)
function getVariationId($key, $defaultVariationId, User $user = null) -> function getVariationId(string $key, $defaultVariationId, User $user = null)
function getAllVariationIds(User $user = null) -> function getAllVariationIds(User $user = null): array
function getKeyAndValue($variationId) -> function getKeyAndValue(string $variationId): ?Pair
function getAllKeys() -> function getAllKeys(): array
function getAllValues(User $user = null) -> function getAllValues(User $user = null): array
function forceRefresh() -> function forceRefresh(): void
Fix unserialize deprecation error. #19
unserialize deprecation error. #19The evaluation logs are staying on info level but they are now combined into a single log entry.
info level but they are now combined into a single log entry.WARNING.NO_LOG log level was added to turn off the logging.flag-overrides configuration option was added to support the reading of flags & settings from a local file or an associative array.getAllValues() function was added for evaluating all available flags.Update comments related to additional configuration options.
Update comments related to additional configuration options.
Fix wrong request option parameter handling for guzzle: connect-timeout ➡️ connect_timeout.
Fix wrong request option parameter handling for guzzle: connect-timeout ➡️ connect_timeout.
Fixed wrong error message reported when the config.json download failed and simultaneously the cache was also empty. #13
Fixed wrong error message reported when the config.json download failed and simultaneously the cache was also empty. #13
Added two extra client configuration options for logging:
Added two extra client configuration options for logging:
| Name | Type | Example | Description |
|---|---|---|---|
| log-level | int | 'log-level' => \ConfigCat\Log\LogLevel::DEBUG |
Sets the logging severity for the ConfigCat SDK. It must be a value from the constants of the \ConfigCat\Log\LogLevel class. |
| exceptions-to-ignore | array | 'exceptions-to-ignore' => [InvalidOperationException::class] |
A list of exception class types that should be excluded from logging. |
Nothing published for this version
Set this parameter to be in sync with the Data Governance preference on the Dashboard. Breaking change:
Addressing global data handling and processing trends via Data Governance feature. Customers can control the geographic location where their config JSONs get published to. See the docs. We are introducing a new DataGovernance initialization parameter. Set this parameter to be in sync with the Data Governance preference on the Dashboard. Breaking change:
Added variation id related functions to support integration with analytical tools:
Added variation id related functions to support integration with analytical tools:
getVariationId()getAllVariationIds()getKeyAndValue()Nothing published for this version
Breaking change: Renamed API Key to SDK Key.
Breaking change: Renamed API Key to SDK Key.
Nothing published for this version
Moving from config_v3.json to config_v4.json.
Moving from config_v3.json to config_v4.json.
Supporting sensitive comparators in targeting rules.
Supporting sensitive comparators in targeting rules.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.