NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2659 most downloaded on Packagist
The Statsig php SDK for multi-user, server side environments.
Latest stable
3.7.2
Last release 1 years ago
06 Nov 2025
Release timing varies
gaps range from 2 weeks to 6 months
Nearly every release is documented
notes for 27 of 30 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
30 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
previous attempt to use cdn for download_config_specs had a bug.
Fixes:
https://github.com/statsig-io/php-sdk/issues/13
Included In This Release
- b3e8ce03a0fa78c24f5cb584c0b2b72ca71ee46f Xin Li
- fix: use cdn for config specs (#112)
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.7.1...3.7.2
Fixes:
Included In This Release
- b3e8ce0 Xin Li
- fix: use cdn for config specs (#112)
Full Changelog: 3.7.1...3.7.2
Fixes boolean custom fields to be converted to "true" and "false" instead of "1" and "0" for string comparisons
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Included In This Release
- 3b61c0f92dd08f906682b711358de75acf3d7837 sroyal-statsig
- Merge pull request #113 from statsig-io/fix-boolean-custom-fields
- b0164dde075134f318cbcf303cf6d583e72bcfde Stephen Royal
- Fix Boolean Custom Fields
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.7.0...3.7.1
Included In This Release
Full Changelog: 3.7.0...3.7.1
Timestamp handling: Fixed an issue where values equal to 10_000_000_000 were incorrectly interpreted as milliseconds instead of seconds. This could ca
Included In This Release
- f76fd409b490115518e91c349ffcf54da43598ac tore-statsig
- fix: normalize timestamps for eval comparison (#109)
- a6e7993159f5d96bae5f0058cb88289801cc6a80 tore-statsig
- Update kong.yml (#110)
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.6.3...3.7.0
Included In This Release
Full Changelog: 3.6.3...3.7.0
Switch to using cdn url for dcs
Included In This Release
- ae789d2d4f6b95f2a427684c04bf1b64c198d401 sroyal-statsig
- Merge pull request #107 from statsig-io/use-cdn-dcs
- c378f48de016a7889aafcd55d066d09d54b36504 Stephen Royal
- Use CDN URL for DCS
- 4c8c40f0f76a98e40657fe75f0de0d65ab1a5958 sroyal-statsig
- Merge pull request #106 from statsig-io/update-ua-parser-version
- ce45622dacf22803a6bdf69c8cdb88eaade9761a Stephen Royal
- update
- 76a95fb4f97ee30fb1517d6647fe1ec6b0390609 Stephen Royal
- Update UA Parser Version
- d7c905efd291dce97d4555e76207426e17f2529a sroyal-statsig
- Merge pull request #105 from statsig-io/handle-null-gate-name
- 25fe96e04c259a449d01443f72cd05f70f531932 Stephen Royal
- update
- 91f0340a14258995b844b2f3ad3f4c5f38071956 Stephen Royal
- Handle Null Gate Name
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.6.2...3.6.3
Included In This Release
- ae789d2 sroyal-statsig
- Merge pull request #107 from statsig-io/use-cdn-dcs
- c378f48 Stephen Royal
- Use CDN URL for DCS
- 4c8c40f sroyal-statsig
- Merge pull request #106 from statsig-io/update-ua-parser-version
- ce45622 Stephen Royal
- update
- 76a95fb Stephen Royal
- Update UA Parser Version
- d7c905e sroyal-statsig
- Merge pull request #105 from statsig-io/handle-null-gate-name
- 25fe96e Stephen Royal
- update
- 91f0340 Stephen Royal
- Handle Null Gate Name
Full Changelog: 3.6.2...3.6.3
Adds session id to statsig metadata when logging events
Included In This Release
- 7b29c2e6e260b5fe4b39996b2f2ed81112e8a888 sroyal-statsig
- Merge pull request #102 from statsig-io/add-session-id-to-statsig-metadata
- 8f6060df17f651e02581910c7f8d2e444987989b Stephen Royal
- update
- 81ebe76220872244584b0934a899f96ed360ad7f Stephen Royal
- Add SessionID to Statsig Metadata
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.6.1...3.6.2
Included In This Release
Full Changelog: 3.6.1...3.6.2
Adds passed field for dynamic configs to get client initialize response
Included In This Release
- a20131ed0cd0eb99552ccb717faa9947cbff6d14 sroyal-statsig
- Merge pull request #100 from statsig-io/gcir-dc-passed
- e1c0a8cf54308bb784cbcab42c45f5fe2ae6b0ec Stephen Royal
- Add Passed for Dynamic Configs to GCIR
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.6.0...3.6.1
Included In This Release
Full Changelog: 3.6.0...3.6.1
Adds additional metadata to dynamic config exposure events
Included In This Release
- 43c476591f4cf934e1d2218f5747aa2de60d7e40 sroyal-statsig
- Merge pull request #98 from statsig-io/php-array-string-ops
- 2a07f2d2c01f0b4d5726a177929eb992f116bcf2 Stephen Royal
- Stringify Arrays for String Operators
- 0c2fafa4e26a42aaf22911d0e3bf5efcc1e24b13 sroyal-statsig
- Merge pull request #97 from statsig-io/dynamic-config-rule-passed
- 10dfab758e6e8c283609600d8a401f42f17eb657 Stephen Royal
- Add RulePassed to Exposure Metadata
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.5.2...3.6.0
Included In This Release
Full Changelog: 3.5.2...3.6.0
Add IDType to getClientInitializeResponse
IDType to getClientInitializeResponseIncluded In This Release
- 34c9708ac8d2b9256cb48cd52a9ae1613843f28a sroyal-statsig
- Merge pull request #95 from statsig-io/add-id-type-gcir
- f70e9bfe81b96b4bd5765a3597d22c009a1277d8 Stephen Royal
- Add IDType to GCIR Response
- 47a2ceb2cce63e9762adb3705de2fee49a5acebb Weihao Ding
- Merge pull request #94 from statsig-io/eval-optimize
- 4f0bdb9fa6e7e829bd6712b9f0212275ea4a79df weihao-statsig
- optimize: eval pass percent
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.5.1...3.5.2
IDType to getClientInitializeResponseIncluded In This Release
Full Changelog: 3.5.1...3.5.2
Makes the fromJSON function on ConfigSpecs public so it can be used by custom data adaptors.
Included In This Release
- 56d6c3d6395004391e4e975d1de95c0dcfdeee58 sroyal-statsig
- Merge pull request #92 from statsig-io/expose-config-specs-from-json
- 1838bc1b5d8ce7a4361d130d4812ef3d179feec4 Stephen Royal
- Expose Config Spec fromJSON Function
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.5.0...3.5.1
Included In This Release
Full Changelog: 3.5.0...3.5.1
Adds support for array comparison operators
Included In This Release
- c967832473808184d2974bd85f7d76e54935c1bb tore-statsig
- fix: normalize user for gcir (#90)
- 83277bd50e856aa2106a2a14877099badc0d5ed1 sroyal-statsig
- Merge pull request #88 from statsig-io/array-condition-operators
- 300b2387dc30a46256d5612564c7ba69e3b84231 sroyal-statsig
- Merge pull request #87 from statsig-io/gcir-group-name
- eb5c1132b38eb3eb17c8b91d599cafe9377518d7 Stephen Royal
- PHP Array Condition Operators
- fa0c9073a4df91f264634ac86b8e2c2cc0cf1c78 Stephen Royal
- Add Group Name to GCIR
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.4.0...3.5.0
Included In This Release
- c967832 tore-statsig
- fix: normalize user for gcir (#90)
- 83277bd sroyal-statsig
- Merge pull request #88 from statsig-io/array-condition-operators
- 300b238 sroyal-statsig
- Merge pull request #87 from statsig-io/gcir-group-name
- eb5c113 Stephen Royal
- PHP Array Condition Operators
- fa0c907 Stephen Royal
- Add Group Name to GCIR
Full Changelog: 3.4.0...3.5.0
Adds support for checking things with exposures disabled and also for doing manual exposure logging. Docs: https://docs.statsig.com/server/phpSDK#manu
Included In This Release
- 38db76713c1916f61d0e9309cc72c1135ee424a1 sroyal-statsig
- Merge pull request #85 from statsig-io/manual-exposure-logging
- 554dea259030f016c3e4a9caf44c7dcb9bc4a76b Stephen Royal
- Add Manual Exposure Logging
- 6f44c03bfc96a965f83af0b14fca0f41d09fefa4 sroyal-statsig
- Merge pull request #84 from statsig-io/log-event-failure-logging
- 59067b86a3289ba7634f41e493469e97f554744b Stephen Royal
- Log Event Failure Logging
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.3.1...3.4.0
Removes private attributes from the user object being passed as part of the get_client_initialize_response
Included In This Release
- 16e8a7fce637ef0b503d4193cc17fc5cb63b4ad9 sroyal-statsig
- Merge pull request #82 from statsig-io/remove-private-attributes
- 7e5ae9063c24e3ef2ff294515b992e49f343c336 Stephen Royal
- Remove Private Attributes From GCIR User
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.3.0...3.3.1
Adds evaluation details to exposure logs and objects returned when checking configs and gates
Included In This Release
- aef35a36a59df96f45124b58ff5fd778c5aa31d1 sroyal-statsig
- Merge pull request #80 from statsig-io/event-count-header
- 6f5268cc3814d221f9808a4a31834a8fb2e80b97 Stephen Royal
- Add Event Count Header
- b589f9a42ee21115f46088387527b7bd7ed02f30 sroyal-statsig
- Merge pull request #78 from statsig-io/eval-details
- f38ea976dff723dee0245efbb8b9eaaffa3cf5c9 Stephen Royal
- update
- bc131b8541414785cea573fd03bf00747993d89f Stephen Royal
- Merge branch 'main' into eval-details
- 375d44ca41c98cb69afd10d87855ef721ad8c113 sroyal-statsig
- Merge pull request #79 from statsig-io/hash-secondary-exposures-gcir
- 40ea670d5e53faa2dfc5c69efbd9929cc0c50dde Stephen Royal
- Hash Secondary Exposures for GCIR
- e1d42b453d3b89bbdd15c1512497dad62c576437 Stephen Royal
- Add Evaluation Details
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.2.0...3.3.0
GetClientInitializeResponse changes: This release adds debugging information for which server SDK generated the values, and includes the full user obj
GetClientInitializeResponse changes: This release adds debugging information for which server SDK generated the values, and includes the full user object used to generate the values
Bug fix:
Included In This Release
- ef44df77069181c4263d47a8bdd2f71057a9eb29 sroyal-statsig
- Merge pull request #76 from statsig-io/fix-get-feature-gate-fallback
- f3fa23a1f929132564e4d96d1bc745f12ecafd31 Stephen Royal
- Fix Feature Gate Fallback
- bb95e6331b7d4b51b5b9f1a8c371c7b5464ec1c0 sroyal-statsig
- Merge pull request #75 from statsig-io/clean-secondary-exposures
- 76e84af8190cd52c4baffb7b25398c06d9f51f37 Stephen Royal
- Clean Secondary Exposures
- 2b0f7ebd78265b4eec9e2dbc407875d45c5da9d5 sroyal-statsig
- Merge pull request #73 from statsig-io/get-client-initialize-updates
- c72f0887485548f1fae20bcb45f1a4966743b0c0 Stephen Royal
- Get Client Initialize Updates
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.1.0...3.2.0
This adds a new function getFeatureGate which returns a feature gate object which has additional information about the gate evaluation such as ruleID
This adds a new function getFeatureGate which returns a feature gate object which has additional information about the gate evaluation such as ruleID and IDType
Included In This Release
- 14e692dc4b4e483484a05938419d7dc4ea956bd9 sroyal-statsig
- Merge pull request #71 from statsig-io/get-feature-gate-and-id-type
- a1693d18773c634a6dbff8f4d15a5a2cf49f0d41 Stephen Royal
- Add GetFeatureGate and IDType
- 6b392de213224eaac7b07922894c1aa198b88d08 sroyal-statsig
- Merge pull request #70 from statsig-io/allocated-experiment
- 86b27d546391d6a5f7bcf3d3c8a226ca06abc5c5 Stephen Royal
- Add Allocated Experiment For Layers
Full Changelog: https://github.com/statsig-io/php-sdk/compare/3.0.0...3.1.0
Remove network call to fetch Config Specs or IDList if config spec is stale: meaning, last fetch time exceeds config_freshness_threshold_ms (default v
Changes:
New feature:
Included In This Release
- 1300150bd75f689b84e3064a3cf3e5e3b5d2d262 Xin Li
- Merge pull request #68 from statsig-io/force_dcs
- 49a45fb7be100c483e9a63036d7640aa2485532f Xin Li
- address comments
- 30bc1b0c29c90ffd8e4ea92f27d685e6022c38f0 Xin Li
- Enforce dcs to be set
- 7bf3baf5d967623b7df16b8e97284d6ce986096d Xin Li
- Add output logger
Full Changelog: https://github.com/statsig-io/php-sdk/compare/2.4.0...3.0.0
Add a field for experiment group name on config evaluation results
Add a field for experiment group name on config evaluation results
Included In This Release
- 277bcfc4085b8d560b10a3298d15491e1ae2bdb1 sroyal-statsig
- Merge pull request #64 from statsig-io/group-name
- be9ccc8ea7b3037758b78420a452c77f52c9c28c Stephen Royal
- Adding Group Name
Full Changelog: https://github.com/statsig-io/php-sdk/compare/2.3.0...2.4.0
Adds additional logic to verify bootstrapping values and that values were generated by the correct sdk key
Adds additional logic to verify bootstrapping values and that values were generated by the correct sdk key
Also moves mockery to be a dev dependency
Included In This Release
- fd3ef797ed85b261a7c6484f1e586aa05617e5fc Daniel
- refactor: Updated mockery and made it
require-devonly. (#62)- 735725c53b9797132c8db38214114a860879abea sroyal-statsig
- Merge pull request #60 from statsig-io/move-mockery-to-dev-deps
- 58f094b28e93298f1ef7cb3429973f88c1253027 Stephen Royal
- Move Mockery to Dev Dependencies
- 91c14e2bfe22589d5ef138503033b8738bf2405a sroyal-statsig
- Merge pull request #59 from statsig-io/sdk-key-verification
- 2b9d0b84c3237f99a2038eae30f1e654dfaafb3f Stephen Royal
- SDK Key Verification
- 47a21a915ef88f1ed6e7026cd75515f19a4d7853 Daniel
- Ensure empty objects are sent for "value" not empty arrays (#58)
- 839c50a262f282c380e94fc538e4818906a103e4 sroyal-statsig
- Merge pull request #55 from statsig-io/hashed-sdk-keys-to-app-ids
- 1887c8818460da2033c5d5037a38ea5ade458844 sroyal-statsig
- Hashed SDK Keys to App IDs
- 471377541e218198001b0370445e4f64573fa76e sroyal-statsig
- Merge pull request #54 from statsig-io/bootstrap-user-hash
- 5b1ed9a117516970c2c925334c59318e5c714ba4 sroyal-statsig
- Bootstrap User Hash
- 2f54123f8609f9c7482faa73d461dd01838a56d3 Daniel Loomb
- Merge branch 'main' of https://github.com/statsig-io/php-sdk
- 658f33b68980773f40c4ad10185e8e812f438138 tore-statsig
- Use httpclient for idlist get (#52)
- 93c1e895980d77e17f1faf446b8a50a3375e01c7 Daniel
- Fix crash when ConfigSpecs is null (#40)
Full Changelog: https://github.com/statsig-io/php-sdk/compare/v2.2.1...2.3.0
For evaluating ip -> country conditions, or for parsing a user agent, rather than initialize these depedencies up front (per request), initialize them
For evaluating ip -> country conditions, or for parsing a user agent, rather than initialize these depedencies up front (per request), initialize them when a gate/experiment check requires it only. This improves sdk initialization performance, at the potential cost of degrading gate check/experiment evaluation latency, but total cost for a given request should be constant if required.
Prevents IDList from syncing during getClientInitializeResponse calls if IDList was recently fetched.
getClientInitializeResponse calls if IDList was recently fetched.StatsigOptions::config_freshness_threshold_msFull Changelog: https://github.com/statsig-io/php-sdk/compare/v2.1.0...v2.2.0
New API: getLayer - returns an instance of Layer which you can get layer params via get or getTyped functions getClientInitializeResponse - returns a
New API:
getLayer - returns an instance of Layer which you can get layer params via get or getTyped functions
getClientInitializeResponse - returns a client initialize response for bootstrapping client SDKs
Updates LocalFileConfigAdapter -> LocalFileDataAdapter
event_queue_size is now configurable via StatsigOptions. This controls the maximum number of events to queue before they are flushed.
event_queue_size is now configurable via StatsigOptions. This controls the maximum number of events to queue before they are flushed.
Logic has been updated to use IConfigAdapter and ILoggingAdapter interfaces. This allows developers to write their own custom adapters to work with th
Logic has been updated to use IConfigAdapter and ILoggingAdapter interfaces. This allows developers to write their own custom adapters to work with their own stack. By default, local file storage is used via the LocalFileConfigAdapter and LocalFileLoggingAdapter.
new StatsigUser("an_id") -> StatsigUser::withUserID("an_id")(new StatsigUser())->setCustomIDs(["MyCustomID" => "an_id"]) -> StatsigUser::withCustomIDs(["MyCustomID" => "an_id"])Call setEnvironmentTier on StatsigOptions to set the environment tier
Call setEnvironmentTier on StatsigOptions to set the environment tier
Nothing published for this version
Nothing published for this version
Nothing published for this version
Bug fixes and performance improvements.
Bug fixes and performance improvements.
See the full documentation here:
https://docs.statsig.com/server/phpSDK
Introducing v0.1.0 of the Statsig php SDK!
Introducing v0.1.0 of the Statsig php SDK!
This SDK behaves a bit differently than others to work win php's request lifecycle. You can run sync.php periodically to download your statsig configuration to a file, and evaluate gates/configs/experiments based on that file. Similarly, output logs to a file and periodically run send.php to post logs to statsig servers.
See the full documentation here:
https://docs.statsig.com/server/phpSDK
One column per quarter.