NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
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.
Move ddtrace-appsec-body to the root workspace, fixing cargo vendoring #4437
Make the sidecar more robust: gracefully handle shared memory errors such as ENOSPC instead of stopping, move messages larger than the socket buffer l
DDTrace\install_line_hook() API to hook source lines and line ranges #4275, #4411DD_DATA_STREAMS_ENABLED=true #4380DD_TRACE_STATS_ADDITIONAL_TAGS to add tag dimensions to client-side stats #4404DD_FLAGGING_EVALUATION_COUNTS_ENABLED #4288DD_TRACE_DEBUG=1 #4327DD_DBM_TRACE_PREPARED_STATEMENT=1 #4211 (thank you @bray-lula for the pull request!)php_network_connect_socket() failed on EINTR #4375$locals, which broke serialization of captured exceptions such as in the Symfony profiler #4389 (thank you @jaugustin for the report!)_dd.base_service on internal spans for client-side stats aggregation, matching the agent DataDog/libdatadog#2554memory_limit and recover from out-of-memory conditions; parsed bodies are now sent to the helper as MessagePack directly #4361Your coding agent can read these notes before it upgrades. Set up the MCP server →
Use the alternate signal stack for the remote config SIGVTALRM handler #4355 (thank you @mstegmeyer!)
Call exit handlers when FrankenPHP shuts down #4350
#[DDTrace\Trace] attributes on preloaded functions #4324DD_ENTITY_ID to DogStatsD metrics sent by the extension #4328 (thank you @lcobucci!)Update the default query string obfuscation regex, fixing a security vulnerability, as described in https://github.com/DataDog/dd-trace-php/security/a…
datadog-setup.php now reports that macOS is not supported #4284 (thank you @staabm for the report!)dlclose() and process exit #4229ot.th/ot.rv tracestate) in distributed tracing #4177atexit after ddtrace was unloaded #4197, in the zend extension shutdown #4218, and in remote config shutdown #4220HookData #4236peer.service sources in the Predis and PDO connect integrations #4285, #4286 (thank you @redpanda for the reports!)http.status_code for Guzzle requests that throw on non-2xx responses, and fix DD_TRACE_HTTP_CLIENT_ERROR_STATUSES handling #4287 (thank you @fbaumann-ph for the report!)http.endpoint takes precedence over http.route again, and deeply nested SQL can no longer exhaust the stack during obfuscation DataDog/libdatadog#2582, DataDog/libdatadog#2441_dd.sdk.otlp_export marker to trace chunks #4240poll readiness, fread/fwrite byte counts, RELRO protection after GOT patching, and loader bounds checks #4156Fix SSI MSHUTDOWN on PHP 7.3 with opcache #4169
Support the stable OpenTelemetry deployment.environment.name resource attribute, mapped to DD_ENV (in addition to the legacy deployment.environment) #
deployment.environment.name resource attribute, mapped to DD_ENV (in addition to the legacy deployment.environment) #4148DD_API_KEY and OTLP exporter header values from configuration telemetry #3961drupal.theme.render spans on Drupal >= 11.3 and under early-returning renders #4145Ensure files and directories created by the installer remain readable when installation runs under a restrictive umask #4138
Fix potential crash on crashtracker startup with musl. DataDog/libdatadog#2379
Repair the macOS crashtracking sidecar connector #4069
module_entry across SSI loader shutdown, which could crash on reload #4087vsnprintf off-by-one buffer sizing across appsec/logging/telemetry call sites #4115DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT (continue/restart/ignore) to control how upstream distributed-trace context is extracted, matching other Datadog tracers #3997DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT_MS to bound Dynamic Instrumentation capture time #4003DD_EXPERIMENTAL_FLAGGING_PROVIDER_SPAN_ENRICHMENT_ENABLED (default off) #3996out.host/peer.hostname/peer.service/server.address #4102interrupt_count checks by using a relaxed atomic outside of REQUEST_LOCALS #4074server.response.body.raw WAF address for raw (unparsed) HTTP response body inspection #4055_dd.apm.enabled:0 is present on every span so it is reliably encountered during APM-standalone billing processing #4054DD_APPSEC_AGENTIC_ONBOARDING in configuration telemetry #4053Restore OPcache restart hook on shutdown
Prevent application error handlers from replacing successful OpenFeature evaluation values with code defaults #4071
Fix unbounded telemetry-buffer growth in RoadRunner, FrankenPHP, and other user-request-mode runtimes #4061
Surface SSI incompatible runtime (Xdebug, OPcache JIT) as incompatible_runtime injection metadata, so diagnostics can explain why profiles appear but
incompatible_runtime injection metadata, so diagnostics can explain why profiles appear but traces are missing #4021curl_multi_exec parent spans when the span limit is already reached #4030svc.user/svc.auto process tags #3921, DataDog/libdatadog#2053OTEL_* SDK-sourced configs #4005>This release adds experimental heap live profiling to the profiler. This is off by default. Enable it with the environment variable DD_PROFILING_EXPE
[!NOTE] This release adds experimental heap live profiling to the profiler. This is off by default. Enable it with the environment variable
DD_PROFILING_EXPERIMENTAL_HEAP_LIVE_ENABLED =1or INI settingdatadog.profiling. experimental_heap_live_enabled =1.
SpanStack::$active unset corruption #3962jit_trace_num #3964SpanStack state corruption when tracing objects with deep clone operations #3976request_exec being issued between requests #3939tracing_sample_rate missing/null deserialization DataDog/libdatadog#2102_dd.svc_src span tag per Service Override Source Attribution RFC #3948DD_PROFILING_EXPERIMENTAL_HEAP_LIVE_ENABLED (requires allocation profiling to be active) #3623O_CLOEXEC missing) causing child processes to hang, NULL file dereference in timeline error observer on PHP 8.0, and async signal delivery to helper threads causing a segfault on ZTS builds #3364lazy_static with std::sync::LazyLock and optimize Sapi/RefCellExt #3990DD_APPSEC_HELPER_RUST_REDIRECTION=false) #3991waf.error and rasp.error error tracking metrics #3963_assume_utf8 against potential out-of-bounds access #4009The sidecar is now always spawned unconditionally, regardless of configuration #3912
dynamic_service DBM propagation mode as a convenience alias for service mode with base hash injection; this mode will replace service on the long term #3940DD_DBM_ALWAYS_APPEND_SQL_COMMENT to unconditionally append SQL comments in DBM regardless of sampling #3954DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED #3934DD_TRACE_HTTP_POST_DATA_PARAM_ALLOWED #3931:void return type overwriting the instrumented function's actual return value #3920top_level span detection #3916php.compilation.total_time_ms reporting values 1000x too large (microseconds labeled as milliseconds) #3915 (thank you @dortort!)_Atomic field) #3945tracer/ directory within the extension #3912language:native tag DataDog/libdatadog#2080, DataDog/libdatadog#2079, DataDog/libdatadog#2083x-datadog-endpoint-scan and x-datadog-security-test security testing headers as span tags on HTTP entry spans, independent of DD_TRACE_HEADER_TAGS and AppSec enablement #3925HashTable loop in the AppSec backtrace collection path #3933Properly reset SSI loader global state on shutdown to cleanly support reloading #3881
DD_LOGS_OTEL_ENABLED=true, disabled by default) #3748dbname DSN value in PDO integration #3885blocked_request metric tag detection in AppSec helper #3863block tag to rasp.rule.match metric #3870Restrict the accepted amount of extracted tags and baggage #3854
Fix catastrophic backtracking in PDO integration #3848 - thanks for reporting @Strentz-Paul
> This version has catastrophic backtracking in the PDO Integration. Please use 1.19.1 instead.
[!WARNING] This version has catastrophic backtracking in the PDO Integration. Please use 1.19.1 instead.
process_tags.serialized refcounting on shared inter-thread string #3831APM_MULTI_CONFIG remote configuration and fix missing data for exception replay #3791instanceof type aliases for PHP 7.x in live debugger DSL (integer/double vs int/float) #3813:name placeholder parameters in PDO queries for correct DBM correlation #3801DD_TRACE_GENERATE_ROOT_SPAN) instead of INI dot notation #3783Update and shrink build images, migrate to clang 19 #3771
DD_APPSEC_HELPER_RUST_REDIRECTION=false)Fix SSI crashing on apache reload; add SSI int tests for appsec #3724, #3733
> This version may have performance issues with Symfony, Laravel or Wordpress. Please use 1.17.1 instead.
[!WARNING] This version may have performance issues with Symfony, Laravel or Wordpress. Please use 1.17.1 instead.
_dd.p.ksr propagated tag for Knuth sampling rate #3701Fix http_response_header deprecation in installer #3553
## Profiler ### Fixed - Revert unsafe optimization
Fix panic after bailout in previous request #3537
bump tracing-core from 0.1.33 to 0.1.35 #3516
getenv calls #3528code_origin_for_spans_enabled naming inconsistency #3494NULL guard clause in sidecar reconnect callback #3499$_GET #3501security_response_id is being release before displaying it #3493duration_ext metric #3507_iovec_writer_flush and enforce limits on $_POST #3495client_ip on request_init #3496Upgrade to libdatadog v24.0.2 #3492 #3498
Implement APM endpoint resource renaming #3415
Fix closed resource handling in live debugger #3437
Reduce integrations overhead #3380
Fix double free at sidecar connection
Add injection metadata fields to telemetry forwarder #3359
Implement new SSI configuration telemetry #3301
Add injection information to phpinfo output for the SSI loader #3271
Update config telemetry to support stable config #3198
Checks for more ioncube extension names in SSI loader #3204
## Application Security Management ### Fixed - Bug collecting client IPs
Defer dropping the exec span to close time
Add support for file based configuration (library-config) #3068
Avoid using db.statement in favor of sql.query
Fallback to writing shared memory files to /tmp, if shm_open() returns ENOTSUP Datadog/libdatadog#910
/tmp, if shm_open() returns ENOTSUP Datadog/libdatadog#910DD_TAGS support #3121Handle EINTR in blocking ipc sender Datadog/libdatadog#900
>This release adds experimental I/O profiling to the profiler. This is off by default. Enable it with the environment variable DD_PROFILING_EXPERIMENT
[!NOTE] This release adds experimental I/O profiling to the profiler. This is off by default. Enable it with the environment variable
DD_PROFILING_EXPERIMENTAL_IO_ENABLED=1or INI settingdatadog.profiling.experimental_io_enabled=1.
Add track_error: false on ignored caught exceptions #3074
DD_TRACE_AGENT_URL #3050Block signals for sqlsrv_connect function #3035
Fix stats computation of background sender
> This version may cause metrics to not be computed and services to be hidden in the Datadog Interface. Please upgrade to `1.6.2`.
[!WARNING] This version may cause metrics to not be computed and services to be hidden in the Datadog Interface. Please upgrade to
1.6.2.
SpanLink::fromHeaders() crash with no or invalid propagated tags #3025PHP 8.4 deprecations #2981 (thanks @JeppeKnockaert)
[!WARNING] This version can crash when calling
SpanLink::fromHeaders()in the tracer with no or invalid propagated tags and may cause metrics to not be computed and services to be hidden in the Datadog Interface. Please upgrade tov1.6.2or newer. You can read about the technical details in #3025
8.4 supported version in datadog-setup.php #2984 (thanks @greg0ire)library_entrypoint.start metric #3009> This version can crash on PHP 8.4 with profiling enabled, when using a web server (CLI is unaffected). Please upgrade to `v1.6.0` or newer. You can
[!WARNING] This version can crash on PHP 8.4 with profiling enabled, when using a web server (CLI is unaffected). Please upgrade to
v1.6.0or newer. You can read about the technical details in #3019
> There is a known issue with the Application Security Management module on aarch64 architectures in this release. If you use datadog.appsec.enabled=0
[!WARNING] There is a known issue with the Application Security Management module on aarch64 architectures in this release. If you use
datadog.appsec.enabled=0, this won't affect you. Otherwise it might happen that the datadog-ipc-helper process crashes immediately.
[!WARNING] This version can crash on PHP 8.4 with profiling enabled, when using a web server (CLI is unaffected). Please upgrade to
v1.6.0or newer. You can read about the technical details in #3019
Disable sidecar sending on lambda #2904
Fix: MongoDBIntegration condition typo #2884
Mongodb: Deprecated exception in v1.20+ #2870
The default value for datadog.trace.cli_enabled is now set to true (except for composer), meaning that CLI processes will be traced by default.
Fix crash with git metadata injection #2862
> This version can crash with git source code integration when the .git/ folder is in an inconsistent state. To mitigate set datadog.trace.git_metadat
[!WARNING] This version can crash with git source code integration when the
.git/folder is in an inconsistent state. To mitigate setdatadog.trace.git_metadata_enabled=0(or environment variableDD_TRACE_GIT_METADATA_ENABLED=0) or upgrade to v1.3.2.
> This version can crash with git source code integration when the .git/ folder is in an inconsistent state. To mitigate set datadog.trace.git_metadat
[!WARNING] This version can crash with git source code integration when the
.git/folder is in an inconsistent state. To mitigate setdatadog.trace.git_metadata_enabled=0(or environment variableDD_TRACE_GIT_METADATA_ENABLED=0) or upgrade to v1.3.2.
The default value for datadog.log_backtrace is now set to true, meaning that on compatible systems, a segmentation fault will cause the process's backtrace to be printed in the log.
--extension-dir is used #2789json extension #2805⚠️ This version can crash with git source code integration when the .git/ folder is in an inconsistent state. To mitigate set datadog.trace.git_metada
⚠️ This version can crash with git source code integration when the .git/ folder is in an inconsistent state. To mitigate set datadog.trace.git_metadata_enabled=0 (or environment variable DD_TRACE_GIT_METADATA_ENABLED=0) or upgrade to v1.3.2.
This release adds beta support for PHP Single Step Instrumentation, allowing the instrumentation of your PHP applications without the manual installation of the dd-trace-php extension.
Read https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/single-step-apm/ for more details.
Implement OTel config remapping #2691
thread id label on every sample #2692This release introduces some minor breaking changes. An upgrade guide can be found at https://github.com/DataDog/dd-trace-php/blob/1.0.0/UPGRADE-1.0.m…
This release introduces some minor breaking changes. An upgrade guide can be found at https://github.com/DataDog/dd-trace-php/blob/1.0.0/UPGRADE-1.0.md.
This changeset is on top of 1.0.0beta1.
One column per quarter.