Installation

Source Repository: convertcom/php-sdk | Wiki | Packagist

Requirements

PHP 8.2, 8.3, or 8.4
A Convert Experiences account with an SDK key

The SDK ships with Guzzle (guzzlehttp/guzzle ^7) as its default PSR-18 HTTP client, auto-discovered at runtime via php-http/discovery. No adapter code is required. To use a different PSR-18 client, see Swapping the PSR-18 Client below.

Install via Composer

composer require convertcom/php-sdk

This installs the SDK and its external PSR dependencies (psr/log, psr/simple-cache, php-http/discovery, and Guzzle as the default PSR-18 HTTP client).

Swapping the PSR-18 Client

Guzzle is bundled automatically — most users don't need to change anything. To use a different PSR-18 client (e.g., symfony/http-client, php-http/curl-client), remove Guzzle and install the replacement:

composer remove guzzlehttp/guzzle
composer require symfony/http-client

php-http/discovery will then pick up the new client automatically. Any PSR-18 compliant client works.

PSR Standards

Standard	Package	Version	Purpose	Required
PSR-3	`psr/log`	`^3.0`	Logging interface	Bundled
PSR-16	`psr/simple-cache`	`^3.0`	Simple cache (config + visitor data)	Bundled
PSR-17	(auto-discovered)	—	HTTP message factories	Bundled (via Guzzle by default)
PSR-18	(auto-discovered)	—	HTTP client	Bundled (Guzzle by default; swappable)

Dependencies

The following packages are pulled in automatically via Composer:

Package	Version	Purpose
`psr/log`	`^3.0`	PSR-3 logging interface
`psr/simple-cache`	`^3.0`	PSR-16 simple cache interface
`php-http/discovery`	`^1.19`	Auto-discovers PSR-18 HTTP client and PSR-17 factories
`guzzlehttp/guzzle`	`^7.3`	Default PSR-18 HTTP client (see Swapping the PSR-18 Client above)

Fullstack Project Constraints

This SDK is designed for Fullstack projects (server-side A/B testing, feature flags, and feature rollouts). It supports a/b_fullstack and feature_rollout experience types with fullStackFeature variation changes only.

All entities must have a unique identifier key (a string) when defined in the Convert web interface.

Supported Experience Types

Type	Description
`a/b_fullstack`	A standard A/B experience
`feature_rollout`	An experience with only one non-original variation

Supported Feature Variable Types

Type	Description
`boolean`	True/false
`integer`	Whole number
`string`	Text
`json`	JSON object or array

Next Steps

Initialization — SDK Key vs. static config
Configuration — Full config options reference