rudderstack/rudder-php-sdk

2.2.0 (2026-07-16)

Features

• implement retry handling in PHP SDK (5043a75)

Bug Fixes

• sdk-4947 align maximum retry delay (497d615)
• sdk-4947 report curl errors before retry delay (5d06481)
• sdk-4947 report terminal socket errors consistently (66adc06)

Miscellaneous

• apply security best practices from step security (#132) (b9b3813)
• sdk-4947 align socket tests with retry behavior (c5f3e30)
• sdk-4947 cover socket retry handling (6e92a5d)
• sdk-4947 harden retry integration coverage (9064658)

Documentation

• sdk-4947 remove retry-after option from readme (e6cf72a)

Features

• implement retry handling in PHP SDK (5043a75)

Bug Fixes

• sdk-4947 align maximum retry delay (497d615)
• sdk-4947 report curl errors before retry delay (5d06481)
• sdk-4947 report terminal socket errors consistently (66adc06)

Miscellaneous

• apply security best practices from step security (#132) (b9b3813)
• sdk-4947 align socket tests with retry behavior (c5f3e30)
• sdk-4947 cover socket retry handling (6e92a5d)
• sdk-4947 harden retry integration coverage (9064658)

Documentation

• sdk-4947 remove retry-after option from readme (e6cf72a)

2.1.2 (2026-06-24)

Miscellaneous

• ci: add release-please workflow (ba5e436)
• ci: add release-please workflow (d827510)
• vuln: scope workflow permissions to least privilege (SEC-167) (bdeb2d3)

Miscellaneous

• ci: add release-please workflow (ba5e436)
• ci: add release-please workflow (d827510)
• vuln: scope workflow permissions to least privilege (SEC-167) (bdeb2d3)

What's Changed

Bug Fixes

• skip curl_close() on PHP 8.0+ where it has no effect (#125)

Full Changelog: v2.1.0...v2.1.1

Bug Fixes

• skip curl_close() on PHP 8.0+ where it has no effect (#125)

What's Changed

Features

• enable event ordering for batches with single event on single instance setups or setups with sticky sessions

Full Changelog: v2.0.1...v2.1.0

Features

• enable event ordering for batches with single event on single instance setups or setups with sticky sessions

What's Changed

Bug Fixes

• fix: allow minor version range on ramsey/uuid dependency

Full Changelog: v2.0.0...v2.0.1

Bug Fixes

• allow minor version range on ramsey/uuid dependency

What's Changed

Features

• Add new consumer configurable options: curl_timeout, curl_connecttimeout, max_item_size_bytes, max_queue_size_bytes
• Add an exception class so we can have rudder-specific exceptions
• More sensible error handling, don't try to catch exceptions that are never thrown
• API Endpoint updates
• Update Batch Size Check
• Remove messageID override capabilities
• Set messageID to be a UUID v4
• Update flush sleep waiting period
• Retry Network errors
• Add Limits to message, batch and memory usage
• Add Configurable flush parameters
• Add ability to use custom consumer
• Add ability to set file permissions
• Modify max queue size setting
• Add ability to set userid as zero

Bug Fixes

• Fix socket return response
• usleep in flush() causes unexpected delays on page loads
• Correct Payload size check of 512kb
• Fix curl error handler
• Fix timestamp implementation for microseconds
• Fix deprecations for PHP 8.2

Chores

• PSR-12 coding standard with Slevomat and phcs extensions
• Namespace and file rearrangement to follow PSR-4 naming scheme and more logical separation
• Extensive linting and static analysis using phpcs, psalm, phpstan, and PHPStorm to spot issues
• Provide strict types for all properties, parameters, and return values
• Add dependencies on JSON extension
• Add dependency on the Roave security checker

BREAKING CHANGES

• Since the library already required a minimum of PHP 7.4, make use of PHP 7.4+ features and avoid compat issues with 8.0
• Support PHP 8
• Remove Support for PHP 7.2 and below

New Contributors

• @ishachopra0401 made their first contribution in #4
• @bardisg made their first contribution in #8
• @dependabot made their first contribution in #9

Full Changelog: v1.0.1...v2.0.0

Features

• Add new consumer configurable options: curl_timeout, curl_connecttimeout, max_item_size_bytes, max_queue_size_bytes
• Add an exception class so we can have rudder-specific exceptions
• More sensible error handling, don't try to catch exceptions that are never thrown
• API Endpoint updates
• Update Batch Size Check
• Remove messageID override capabilities
• Set messageID to be a UUID v4
• Update flush sleep waiting period
• Retry Network errors
• Add Limits to message, batch and memory usage
• Add Configurable flush parameters
• Add ability to use custom consumer
• Add ability to set file permissions
• Modify max queue size setting
• Add ability to set userid as zero

Bug Fixes

• Fix socket return response
• usleep in flush() causes unexpected delays on page loads
• Correct Payload size check of 512kb
• Fix curl error handler
• Fix timestamp implementation for microseconds
• Fix deprecations for PHP 8.2

Chores

• PSR-12 coding standard with Slevomat and phcs extensions
• Namespace and file rearrangement to follow PSR-4 naming scheme and more logical separation
• Extensive linting and static analysis using phpcs, psalm, phpstan, and PHPStorm to spot issues
• Provide strict types for all properties, parameters, and return values
• Add dependencies on JSON extension
• Add dependency on the Roave security checker

BREAKING CHANGES

• Since the library already required a minimum of PHP 7.4, make use of PHP 7.4+ features and avoid compat issues with 8.0
• Support PHP 8
• Remove Support for PHP 7.2 and below

• Data plane URL input validated.
• Data plane URL input supports both with and without protocol URL.
• Segment references removed.
• Version bumped.