CHANGELOG.md

Changelog

5.1.0 (2026-01-23)

Features

• Support for PHP 8.5 (#128) (241e9c5)

5.0.0 (2025-12-04)

⚠ BREAKING CHANGES

• Engine: Use context-based evaluation engine (#126)

Features

• Engine: Evaluate from EvaluationContext (#108) (4cb3481)
• Engine: Use context-based evaluation engine (#126) (91b0a3b)
• get-version-from-composer-and-pass-it-in-headers (#112) (ae35794)
• Local evaluation: Use the new context-based engine (#109) (66435a6)

Bug Fixes

• Engine: Evaluate multivariates from segment overrides (#120) (88fcf5f)
• Implicit identity key not supported for % Split operator (#115) (a9d1e23)

Docs

• removing hero image from SDK readme (#95) (de30e67)

Refactoring

• Engine: nits from context work review (#117) (1eaa8e4)

Other

• add root CODEOWNERS (#106) (28a1063)
• versioned test data (#97) (ce56815)

v4.5.1 - 2025-03-31

What's Changed

• ci: update actions versions by @matthewelwell in #91
• fix: Fix generateIdentitiesCacheKey by @fgiova in #90
• Fix nullable parameter by @VincentLanglet in #88

New Contributors

• @fgiova made their first contribution in #90

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.5.0...v4.5.1

Changes

v4.5.0 - 2024-10-02

What's Changed

• Add ext- requirements to composer.json by @misakstvanu in #76

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.4.0...v4.5.0

Changes

v4.4.0 - 2024-08-28

What's Changed

• feat: Support transient identities and traits by @khvn26 in #78
• ci: stop testing against <8.1 by @matthewelwell in #80
• ci: remove pr filters by @matthewelwell in #81
• Flagsmith instance clonning by @misakstvanu in #75
• feat: offline mode by @matthewelwell in #79
• deps: drop support for php<8.1 by @matthewelwell in #82

New Contributors

• @misakstvanu made their first contribution in #75

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.3.1...v4.4.0

Changes

v4.3.1 - 2024-05-24

What's Changed

• Regex segment local evaluation with int trait by @floranpagliai in #72

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.3.0...v4.3.1

Changes

v4.3.0 - 2024-04-19

What's Changed

• feat: Identity overrides in local evaluation mode by @khvn26 in #69

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.2.1...v4.3.0

Changes

v4.2.1 - 2024-03-19

What's Changed

• fix(identity-cache-key): Use hashed identifier by @gagantrivedi in #68

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.2.0...v4.2.1

Changes

v4.2.0 - 2024-03-15

What's Changed

• Fix method getEnvironment return type by @tm1000 in #63
• (feat): Add back withUseCacheAsFailover by @tm1000 in #61
• chore: remove examples by @dabeeeenster in #65
• Change cache key for getIdentityFlagsFromApi by @tm1000 in #62
• build: release 4.2.0 by @dabeeeenster in #66

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.1.2...v4.2.0

Changes

v4.1.2 - 2023-11-07

What's Changed

• Fix invalid cache value by @VincentLanglet in #58
• chore: bump version by @gagantrivedi in #59

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.1.1...v4.1.2

Changes

v4.1.1 - 2023-09-01

What's Changed

• Avoid deprecation about dynamic properties by @VincentLanglet in #55
• Fix workflow php version by @VincentLanglet in #56
• Fix local evaluation when values are null by @floranpagliai in #53

New Contributors

• @floranpagliai made their first contribution in #53

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.1.0...v4.1.1

Changes

Version 4.1.0 (v4.1.0) - 2023-07-25

What's Changed

• Ensure example application works by @matthewelwell in #47
• feat: add segment IN operator by @khvn26 in #51

New Contributors

• @khvn26 made their first contribution in #51

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v4.0.0...v4.1.0

Changes

Version 4.0.0 (v4.0.0) - 2023-06-15

What's Changed

• BREAKING CHANGE: Use django id if present for percentage split evaluations by @matthewelwell in #48

WARNING: We modified the local evaluation behaviour. You may see different flags returned to identities attributed to your percentage split-based segments after upgrading to this version.

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.1.4...v4.0.0

Changes

Version 3.1.4 (v3.1.4) - 2023-06-08

What's Changed

• Add @throws annotation by @VincentLanglet in #39
• Add PHP version 8.2 to CI tests by @matthewelwell in #45
• Bump version v3.1.4 by @matthewelwell in #46

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.1.3...v3.1.4

Changes

Version 3.1.3 (v3.1.3) - 2023-05-24

What's Changed

• chore/bump version by @dabeeeenster in #42
• fix/correct example by @dabeeeenster in #40

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.1.2...v3.1.3

Changes

Version 3.1.2 (v3.1.2) - 2023-04-14

What's Changed

• Create .gitattributes to ignore test folder by @VincentLanglet in #38
• PSR/simple-cache upgrade by @BartoszBartniczak in #37

New Contributors

• @BartoszBartniczak made their first contribution in #37

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.1.1...v3.1.2

Changes

Version 3.1.1 (v3.1.1) - 2023-03-14

What's Changed

• Solve php 8.2 deprecation by @VincentLanglet in #34
• Release 3.1.1 by @matthewelwell in #35

New Contributors

• @VincentLanglet made their first contribution in #34

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.1.0...v3.1.1

Changes

Version 3.1.0 (v3.1.0) - 2022-11-01

What's Changed

• Add modulo operator by @matthewelwell in #32
• Add IS_SET and IS_NOT_SET operators by @matthewelwell in #33
• Release 3.1.0 by @matthewelwell in #31

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.0.2...v3.1.0

Changes

Version 3.0.2 (v3.0.2) - 2022-07-13

What's Changed

• Mocking routes directly from file by @doppiogancio in #26
• Fix random styling issues by @matthewelwell in #29
• Use feature name for analytics by @matthewelwell in #28
• Release 3.0.2 by @matthewelwell in #27

New Contributors

• @doppiogancio made their first contribution in #26

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v3.0.1...v3.0.2

Changes

Version 3.0.1 (v3.0.1) - 2022-06-07

Changes

Version 3.0.0 (v3.0.0) - 2022-06-07

What's Changed

• Pass third declared param on set through by @tm1000 in #13
• Added example directory with docker environment and a README by @fzia in #14
• Github Actions Workflow by @fzia in #16
• Feature - Flag Engine by @fzia in #17
• Feature - Client side Re-evaluation by @fzia in #18
• Prevent initialisation with local evaluation without server key by @fzia in #20
• Expose segments by @fzia in #22
• feat(semver): Add semver support to segment/traits by @fzia in #21
• Fix segment priorities by @matthewelwell in #24
• Release 3.0.0 by @matthewelwell in #19

New Contributors

• @fzia made their first contribution in #14
• @matthewelwell made their first contribution in #24

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v2.1.1...v3.0.0

Changes

Version 2.1.1 (v2.1.1) - 2022-02-01

What's Changed

• Remove Guzzle from require by @tm1000 in #12

Changes

Version 2.1.0 (v2.1.0) - 2022-01-31

What's Changed

• Fix for PHP v8.0+ by @dabeeeenster in #11

Changes

Version 2.0.2 (v2.0.2) - 2021-11-18

What's Changed

• FIX: Make initialValue nullable #8 by @JustinBack in #9

New Contributors

• @JustinBack made their first contribution in #9

Full Changelog: https://github.com/Flagsmith/flagsmith-php-client/compare/v2.0.1...v2.0.2

Changes

Version 2.0.1 (v2.0.1) - 2021-10-29

Changes

Version 2.0 (v2.0.0) - 2021-10-21

Implements PSRs as per #4

Changes

Flagsmith Rename (v1.0.0) - 2021-05-04

• Refactored Bullet Train > Flagsmith
• New Packagist name
• You can now override the API URL for self hosted API installations.

Changes