Installation

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

Requirements

PHP ^8.2 — tested in CI against 8.2, 8.3, and 8.4, on both --prefer-lowest and --prefer-stable dependency resolutions
The curl, json, and mbstring extensions
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

convertcom/php-sdk is a single package. The repository is a monorepo internally, but everything the SDK needs — every ConvertSdk\* namespace and the generated OpenAPI\Client types — ships inside this one Composer package. There are no convertcom/php-sdk-* sub-packages to install.

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	Interface package	Purpose	Implementation
PSR-3	`psr/log ^3.0`	Logging interface	Yours — pass PSR-3 loggers via `logger.customLoggers`
PSR-16	`psr/simple-cache ^3.0`	Simple cache (config + visitor data)	Defaults to the in-memory `ArrayCache`; pass your own for persistence
PSR-17	`psr/http-factory ^1.0`	HTTP message factories	Auto-discovered (Guzzle by default)
PSR-18	`psr/http-client ^1.0`	HTTP client	Auto-discovered (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
`psr/http-client`	`^1.0`	PSR-18 HTTP client interface
`psr/http-factory`	`^1.0`	PSR-17 message factory interfaces
`psr/http-message`	`^1.1 \|\| ^2.0`	PSR-7 HTTP message interfaces
`php-http/discovery`	`^1.19`	Auto-discovers the PSR-18 HTTP client and PSR-17 factories
`lastguest/murmurhash`	`^2.1`	MurmurHash3 — the bucketing hash shared with every other Convert SDK
`guzzlehttp/guzzle`	`^7.3`	Default PSR-18 HTTP client (see Swapping the PSR-18 Client above)
`guzzlehttp/psr7`	`^1.7 \|\| ^2.0`	PSR-7 message implementation used by Guzzle

Plus the ext-curl, ext-json, and ext-mbstring PHP extensions.

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