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.
Support for Slim Framework v3 #446
DD_TRACE_AGENT_ATTEMPT_RETRY_TIME_MSEC and DD_TRACE_AGENT_MAX_CONSECUTIVE_FAILURES used when communicating with the agent #440* and $* wildcards can be set from DD_TRACE_RESOURCE_URI_MAPPING. This feature is disabled by default to reduce cardinality in resource names; to enable this feature set DD_TRACE_URL_AS_RESOURCE_NAMES_ENABLED=true #442Tracer limited mode, stopping span creation when memory use raises to 80% of current PHP memory limit #437
DD_TRACE_AGENT_TIMEOUT and DD_TRACE_AGENT_CONNECT_TIMEOUT when communicating with the agent #150DD_TRACE_REPORT_HOSTNAME reporting of hostname via root span #441E_WARNING in certain contexts of PHP 5 installs when the date.timezone INI setting is not set #435Your coding agent can read these notes before it upgrades. Set up the MCP server →
Usage of `DD_TRACE_APP_NAME` is now deprecated and will be removed in a future release.
NOTE: We changed the way the service name can be configured. Now you must use DD_SERVICE_NAME instead of DD_TRACE_APP_NAME for consistency with other tracers. Usage of DD_TRACE_APP_NAME is now deprecated and will be removed in a future release.
DD_SERVICE_NAME instead of DD_TRACE_APP_NAME #432Official support for PHP 7.3 #429
dd_trace_forward_call() to forward the original call from within a tracing closure #284
dd_trace_forward_call() to forward the original call from within a tracing closure #284parent:: keyword not honored from a subclass when forwarding a call from a tracing closure #284Force tracing or discarding trace via special Span tag (manual.keep and manual.drop) #409
Tracing of functions called using DO_FCALL_BY_NAME opcode #404
Span and SpanContext main implementation uses public fields to share data to allow faster serialization and overall Span overhead #398
DDTrace\Encoders\SpanEncoder::encode() now takes an instance of DDTrace\Data\Span instead of DDTrace\Contracts\Span #398DDTrace\Processing\TraceAnalyticsProcessor::process() now takes an instance of DDTrace\Data\Span instead of DDTrace\Contracts\Span #398NOTE: THIS IS A BREAKING CHANGE RELEASE
NOTE: THIS IS A BREAKING CHANGE RELEASE
This change should not impact most users.
dd_trace_serialize_msgpack() #378getTracesAsArray() method to DDTrace/Contracts/Tracer which returns an array of spans (which are also encoded as an array.) To encode an instance of DDTrace\Contracts\Span as an array, use DDTrace/Encoders/SpanEncoder::encode($span) #378DDTrace/Transport::send() now takes an instance of DDTrace/Contracts/Tracer instead of an array #378DDTrace/Encoder::encodeTraces() now takes an instance of DDTrace/Contracts/Tracer instead of an array #378DDTrace/Encoders/MessagePack. You can still use the JSON encoder by setting the environment variable DD_TRACE_ENCODER=json. It is generally not recommended to use the JSON encoder as parsing JSON payloads at the Agent level is more CPU & memory intensive.Trace Analytics Client Configuration #367
Error traces don't appear in "Total Errors" panel #375
When shutdown hook is executed we disable all tracing to avoid creating unnecessary spans #361
ddtrace.internal_blacklisted_modules_list=some_module,some_other_module #345 & #370dd_trace_disable_in_request function which disables all function tracing until request ends #361Symfony 2.3 web tests for resource name #349
Removed beta references and get ready for GA #339
Ensure Function name is safely copied to avoid freeing persistent string #333
Large number of mysqli spans not containing relevant information #330
Loading of integrations before knowing if the library will be actually used #319
Special thanks to @stayallive for helping us debugging the memory issues in his environment! His help and guidance were of paramount importance.
Special thanks to @stayallive for helping us debugging the memory issues in his environment! His help and guidance were of paramount importance.
$this object prematurely in PHP-FPM VM #3177.x handling of $this pointer passed to the closure causing errors in PHP VM #311
$this pointer passed to the closure causing errors in PHP VM #311Optional extension .so files compiled with "-g" flag #306
Honor ddtrace provided by composer if user provided one #276
Span::setResource as a legit method #287
Zend integration incompatibility with Yii #282
Post-install to link the extension to all installed SAPI's for common configurations #277
Support for global tags via the environment variable DD_TRACE_GLOBAL_TAGS=key1:value1,key2:value2 #273
DD_TRACE_GLOBAL_TAGS=key1:value1,key2:value2 #273$this object and return value handling in PHP 5.6 and 7.x #268WARNING: THIS IS A BREAKING CHANGE RELEASE
WARNING: THIS IS A BREAKING CHANGE RELEASE
This change should not impact most of the users as starting from 0.10.0 it is not required (and not recommended) to
manually set the transport. DDtrace\Transport\Http no longer accepts a logger as the second argument as it uses
the globally registered logger. If you are using the Http class, just remove the second argument from the constructor
invocation.
WARNING: THIS IS A BREAKING CHANGE RELEASE
WARNING: THIS IS A BREAKING CHANGE RELEASE
Refer to the Migration Guide for a detailed description.
At an high level here are the breaking changes we introduced:
OpenTracing\GlobalTracer::get() in your code and still retrieve an OpenTracing compliant tracer, but OpenTracing dependency is now optional.Tracer::startRootSpan() to track the root Scope instance which can be accessed with Tracer::getRootScope() #241phpinfo() and when running $ php -i #242Ability to reset all overrides via dd_trace_reset
dd_trace_resetperformInsert methodPHP code compatibility with PHP 5.4 #194
Update Symfony 3 and 4 docs #184
Support for Lumen via the Laravel service provider #180
Symfony 3.4 and 4.2 sample apps #171
Possibility to enable/disable distributed tracing and priority sampling #160
Guzzle and Curl enabling for Laravel integrations #161
Laravel pipelines tracer supporting configurable handler method #158
Custom PHP info output for ddtrace module #63 - thanks @SammyK
static-analyze to composer scripts #137DDTrace\Tracer returning a DDTrace\NoopSpan in place of OpenTracing\NooSpan when disabled #155Deprecated method Span::setResource() not part of OpenTracing\Span: #141 (Fixes #140)
Fixed:
Span::setResource() not part of OpenTracing\Span: #141 (Fixes #140)getenv() in place of $_ENV to read env variables: #143 - thanks @hinrikMemcached key obfuscation: #132
Fixed
Laravel 4.2 initial support: #130
Added:
Secondary integrations in Laravel 5 integration pointing to non-existing classes: #127
Fixed
Support for PHP 5.6 🎉 #97 , #122
ddtrace extension is not loaded: #98 - thanks @inverseThis is the first version of our official PHP Public Beta. See https://docs.datadoghq.com/tracing/setup/php/ to learn how to setup PHP tracing.
This is the first version of our official PHP Public Beta. See https://docs.datadoghq.com/tracing/setup/php/ to learn how to setup PHP tracing.
exception handling in C extension (PHP 5.6)
ext-ddtrace is no longer required when installing via composerhandling of function return values in PHP 5.6
PHP 5.6 instrumenting method name in mixed case
PHP 5.6 compatibility in Laravel user tracking
Fixed
Laravel template rendering method signature missmatch
Laravel template rendering tracing
ddtrace C extension to allow introspection into running PHP code
ddtrace C extension to allow introspection into running PHP codeUpdate opentracing dependency so it can be installed without modifying minimum-stability.
Update opentracing dependency so it can be installed without modifying minimum-stability.
Incorporate fixes and improvements from 0.1.0, including:
Incorporate fixes and improvements from 0.1.0, including:
Tracer::startActiveSpan... and more.
This pre-release introduces all the bindings for the Datadog PHP Tracer. Here the list of available functionalities:
This pre-release introduces all the bindings for the Datadog PHP Tracer. Here the list of available functionalities:
This beta release contains all breaking changes planned for dd-trace-php 1.0. An upgrade guide can be found at https://github.com/DataDog/dd-trace-php…
This beta release contains all breaking changes planned for dd-trace-php 1.0. An upgrade guide can be found at https://github.com/DataDog/dd-trace-php/blob/1.0.0beta1/UPGRADE-1.0.md.
One column per quarter.