NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #900 most downloaded on Packagist
PHP APM Client
Latest stable
1.27.1
Last release 16 days ago
06 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
233 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
WARNING: this version presents a known bug and you should update to 0.64.1+
WARNING: this version presents a known bug and you should update to 0.64.1+
WARNING: With this release the file _generated.php is not used anymore and files _generated_api.php and _generated_internal.php are generated instead. This only impacts users having a very custom installation procedure that requires custom builds and manual copy of files.
WARNING: this version presents a known bug and you should update to 0.64.1+
WARNING: this version presents a known bug and you should update to 0.64.1+
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add linux/securebits.h to CentOS docker container, to have it present in linux build artifacts #1286
linux/securebits.h to CentOS docker container, to have it present in linux build artifacts #1286Add ZAI component for reading headers #1256
Add \DDTrace\get_current_context #1227
Breaking change: Users that are not explicitly setting or using json encoding are not impacted but this breaking change. Users either requiring json e…
Breaking change: Users that are not explicitly setting or using json encoding are not impacted but this breaking change. Users either requiring json encoding for special purposes to send traces to their own custom targets or relying on the Stream class (that was not part of the public api in src/api) will have to manually clone the classes from the previous release SHA and register themselves. This is discouraged because as of today, json causes a fallback to blocking sync transmission to the Datadog agent, while using messagepack we support the unblocking async transport to our agent.
[ZAI SAPI] Zai\trigger_error() SAPI function #1212
Zai\trigger_error() SAPI function #1212_tmp suffix from development buster images #1217components/ #1216Makefile::test_all #1218[ZAI SAPI] Add test helpers #1208
generated:: prefix for unnamed routes #1198Add curl_multi scenarios to randomized tests #1171 #1173
ext/openssl/tests/bug54992.phpt (#1197)Add randomized testing to test hundreds of different scenarios #1131
curl_multi_init() for distributed tracing #1159Add support for redis cluster #1137
Support distributed tracing for calls to curl_multi_exec() #1119
Add function to correctly extract trace id in all contexts #1125
/ paths #1122Use the observer API on PHP 8 #1089
Support service split by host in PHPRedis integration #1084
Experimental support for PHP 8.0.0 RC 2 & RC 3 (Provided for testing only and not intended for use on production) #1039 #1053 #1054 #1076
DDTrace\Tracer made root spans on PHP 7 #1040Add .gdbinit files from released PHP versions #996
Fix sigsegv in deferred loading #1022. Thanks @walf443 for reporting this with an excellent reproduction case. This affects users calling these method
DD_TRACE_ENABLED=0):
Redis::__constructPredis\Client::__constructElasticsearch\Client::__constructPlease upgrade to 0.48.2 or 0.48.3 if you are on 0.48.0 or 0.48.1, especially if you use Redis, Predis, or Elasticsearch as #1013 fixes a segmentation
Please upgrade to 0.48.2 or 0.48.3 if you are on 0.48.0 or 0.48.1, especially if you use Redis, Predis, or Elasticsearch as #1013 fixes a segmentation fault that can occur.
Symfony HttpException with status less than 500 should not be considered an error #995, #1002 (thanks, @franek!)
The legacy API for custom instrumentation dd_trace() is now a no-op in this release. See the upgrade guide for instructions on upgrading.
The legacy API for custom instrumentation dd_trace() is now a no-op in this release. See the upgrade guide for instructions on upgrading.
The way PHP 5.4 and 5.6 hook into the engine has changed. Please read deep call stacks on PHP 5 for more information on potential issues.
All calls to DDTrace\trace_function or DDTrace\trace_method functions need to happen before the first invocation of the target e.g. DDTrace\trace_function('foo', ...) should be done before foo is called for the first time. In the future this may need to be done before the target is even defined. This was previously noted in 0.45.0, but is now enforced for all PHP versions.
ddtrace.strict_mode INI setting #955zend_execute_ex + zend_execute_internal #970_generated.php with PECL #980Deprecation notice: The following environment variable names have changed. The old names are deprecated. See #969 for more details.
Deprecation notice: The following environment variable names have changed. The old names are deprecated. See #969 for more details.
| Old Name | New Name |
|---|---|
DD_<INTEGRATION>_ANALYTICS_ENABLED |
DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED |
DD_<INTEGRATION>_ANALYTICS_SAMPLE_RATE |
DD_TRACE_<INTEGRATION>_ANALYTICS_SAMPLE_RATE |
DD_INTEGRATIONS_DISABLED |
DD_TRACE_<INTEGRATION>_ENABLED |
DD_TRACE_AGENT_URL environment support #926 (thank you @nurcahyo!) #962DD_TRACE_<INTEGRATION>_<SUFFIX> env vars #969DD_ENV and DD_VERSION to children spans #963Setting service name via DD_SERVICE_NAME is now deprecated and will be removed in a future release. Use DD_SERVICE instead for consistency with other…
Deprecation notice:
DD_SERVICE_NAME is now deprecated and will be removed in a future release. Use DD_SERVICE instead for consistency with other Datadog tracers and services.DD_TRACE_GLOBAL_TAGS is now deprecated and will be removed in a future release. Use DD_TAGS instead (with the same format) for consistency with other Datadog tracers and services.DD_TRACE_RESOURCE_URI_MAPPING is deprecated now that it has been split into DD_TRACE_RESOURCE_URI_MAPPING_INCOMING and DD_TRACE_RESOURCE_URI_MAPPING_OUTGOING.dd_trace and dd_trace_forward_call are deprecated and will be made a no-op in the next release. See #924 for how to migrate.DD_ENV, make sure to remove any existing env:* references from DD_TAGS/DD_TRACE_GLOBAL_TAGS.DD_TRACE_STARTUP_LOGS=0) #935include __DIR__ . '...' in files #943If you use the OpenTracing API, the OpenTracing compatible tracer will no longer be returned from OpenTracing\GlobalTracer::get automatically. See #89
If you use the OpenTracing API, the OpenTracing compatible tracer will no longer be returned from OpenTracing\GlobalTracer::get automatically. See #899 or the documentation for more details.
On PHP 7, dd_trace will no longer work on internal functions e.g. curl_exec; use dd_trace_method or dd_trace_function instead. Additionally, when targeting internal functions they also need to be added to the environment variable DD_TRACE_TRACED_INTERNAL_FUNCTIONS which is a comma separated list e.g. DD_TRACE_TRACED_INTERNAL_FUNCTIONS=array_sum,mt_rand,DateTime::add. These two changes enable a significant performance optimization.
auto_prepend_file #907Be compatible with psr4 composer autoloading now that we have non-psr4 config functions #889
Fix uncaught exceptions with auto flushing enabled #882
If you are using dd_trace, dd_trace_function, or dd_trace_method then you need to call these functions before the first invocation of the target e.g.
If you are using dd_trace, dd_trace_function, or dd_trace_method then you need to call these functions before the first invocation of the target e.g. dd_trace('foo', ...) should be done before foo is called for the first time. In the future this may need to be done before the target is even defined.
Revert "Merge pull request #815 from DataDog/levi/ddtrace_moment" #859 This fixes issue #855.
WARNING: use 0.44.1: this version presents a bug in specific builds of PHP and we recommend using version 0.44.1+ instead.
WARNING: use 0.44.1: this version presents a bug in specific builds of PHP and we recommend using version 0.44.1+ instead.
cgi-fcgi SAPI #835This release removes support for the already deprecated environment variables ddtrace_app_name and DD_TRACE_APP_NAME. Use DD_SERVICE_NAME instead.
WARNING: use 0.44.1: this version presents a bug in specific builds of PHP and we recommend using version 0.44.1+ instead.
ddtrace_app_name and DD_TRACE_APP_NAME. Use DD_SERVICE_NAME instead.DD_SERVICE_MAPPING=pdo:payments-db,mysqli:orders-db #801, #817DD_TRACE_AUTO_FLUSH_ENABLED=1 (PHP 7) #819, #826DD_TRACE_GENERATE_ROOT_SPAN=0 #834Close open sandboxed spans on exit (PHP 5) #780
Fix background sender logging for ZTS #783
Deprecate manual usage of legacy Symfony bundles and Laravel provider #772
Background sender debug info in dd-doctor #758
Traces are flushed when in limited mode #745
Important: There was an error made while creating this release; please use 0.39.2 instead.
Important: There was an error made while creating this release; please use 0.39.2 instead.
Bring background sender to feature parity #738
MessagePack serialization with a reference #730
Official support for PHP 7.4 #723
Set global tags in internal spans #716
Target a specific PHP version during install by setting DD_TRACE_PHP_BIN #604
DD_TRACE_PHP_BIN #604curl_getinfo() as span tags #642error_get_last() issue) #694error_get_last() #709Support OpenTracing contexts as parent contexts #695
Note environment variable DD_SAMPLING_RATE as been deprecated. Use DD_TRACE_SAMPLE_RATE instead.
Note environment variable DD_SAMPLING_RATE as been deprecated. Use DD_TRACE_SAMPLE_RATE instead.
Health metrics: track segmentation faults #621
PHP notice of undefined indexes REQUEST_METHOD and REQUEST_URI when running the request init hook on unsupported SAPI's #637
REQUEST_METHOD and REQUEST_URI when running the request init hook on unsupported SAPI's #637Enable tracing when no autoloaders used by setting DD_TRACE_NO_AUTOLOADER=true #627
DD_TRACE_NO_AUTOLOADER=true #627DDTrace\SpanData #613Trace origin support (Synthetics support) #615
Preview CodeIgniter v2 integration #588
Please report any issues you encounter with these two preview integrations.
mysqli_connect() span from closing twice #610Nothing published for this version
Add container id header to http transport (Container Tagging) - #552
curl_copy_handle function #502Ensure the request init hook is bound by the open_basedir INI directive #579
open_basedir INI directive #579ADVISORY: This release circumvents `open_basedir` in the `request_init_hook`. If you rely on the `open_basedir` INI directive, we highly recommended y
ADVISORY: This release circumvents open_basedir in the request_init_hook. If you rely on the open_basedir INI directive, we highly recommended you upgrade to 0.30.2.
$this object as soon as it stops being used #536ADVISORY: This release circumvents `open_basedir` in the `request_init_hook`. If you rely on the `open_basedir` INI directive, we highly recommended y
ADVISORY: This release circumvents open_basedir in the request_init_hook. If you rely on the open_basedir INI directive, we highly recommended you upgrade to 0.30.2.
X-Datadog-Trace-Count header #525zend_execute_ex override and trace ZEND_DO_UCALL #519SERVICE NAME CHANGE NOTICE: If the tracer is configured with `DD_TRACE_HTTP_CLIENT_SPLIT_BY_DOMAIN=true`, the hostnames will now be prefixed with `hos
SERVICE NAME CHANGE NOTICE: If the tracer is configured with DD_TRACE_HTTP_CLIENT_SPLIT_BY_DOMAIN=true, the hostnames will now be prefixed with host-. If there are any monitors set up for service names by host, those will need to be updated.
host- to ensure compatibility with the Agent #490Race condition when reading configuration from within writer thread context #486
Officially support Symfony 3.0 and 4.0 #475
Valgrind configuration to perform more thorough memory consistency verification #472
Memory leak when garbage collecting span stacks #469
Set the hostname of a URL as the service name for curl and Guzzle requests when DD_TRACE_HTTP_CLIENT_SPLIT_BY_DOMAIN=true #459
DD_TRACE_HTTP_CLIENT_SPLIT_BY_DOMAIN=true #459mt_rand() (32-bit) with one call to dd_trace_generate_id() which implements MT19937-64 and returns a 63-bit unsigned integer as a string #449mt_rand() #449Initial implementation of flushing spans via background thread #450
One column per quarter.