PHPackages                             datadog/dd-trace - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. datadog/dd-trace

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

datadog/dd-trace
================

PHP APM Client

1.17.0(1mo ago)54720.5M—2.2%173[85 issues](https://github.com/DataDog/dd-trace-php/issues)[65 PRs](https://github.com/DataDog/dd-trace-php/pulls)15BSD-3-ClausePHPPHP ^7.0 || ^8.0.0CI passing

Since Apr 17Pushed 1mo ago114 watchersCompare

[ Source](https://github.com/DataDog/dd-trace-php)[ Packagist](https://packagist.org/packages/datadog/dd-trace)[ RSS](/packages/datadog-dd-trace/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (1004)Used By (15)Security (1)

DD Trace PHP
============

[](#dd-trace-php)

[![CircleCI](https://camo.githubusercontent.com/c24406c6a849c654b5aa25a61c4ff669737eb69ce98c22f77ccdbbfe2d479509/68747470733a2f2f636972636c6563692e636f6d2f67682f44617461446f672f64642d74726163652d7068702f747265652f6d61737465722e7376673f7374796c653d737667)](https://circleci.com/gh/DataDog/dd-trace-php/tree/master)[![CodeCov](https://camo.githubusercontent.com/02a869bc7d5742d46693cf2bb3a581c9380fb0be4cec47b1450d73a5de0ec70d/68747470733a2f2f636f6465636f762e696f2f67682f44617461446f672f64642d74726163652d7068702f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d6558696f384837767746)](https://codecov.io/gh/DataDog/dd-trace-php)[![OpenTracing Badge](https://camo.githubusercontent.com/0c34d42089573bfc38911b30f4fd5c7d3ef20dd05d0849b390643ccbf19695da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4f70656e54726163696e672d656e61626c65642d626c75652e737667)](http://opentracing.io)[![OpenTelemetry Badge](https://camo.githubusercontent.com/040c482a17f340e598d41a4aad6893f145d3be3de76cd2784a3e49e09a11d883/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4f70656e54656c656d657472792d656e61626c65642d626c75652e737667)](https://opentelemetry.io)[![Minimum PHP Version](https://camo.githubusercontent.com/5c3072425e67297c8ef63d17acd2c86a0d2ef324f19249f2280bd7de902f63a2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230372e302d3838393242462e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/b3775a2de17853a90995faa104f941eef3ad3c40cc89e34b8b1eaea014614d4e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d425344253230332d2d436c617573652d626c75652e737667)](LICENSE)[![Packagist Version](https://camo.githubusercontent.com/6f4b5bb66dcc54b84ee5913aa02c1d5a613b66a840d3381da8603ad9e05bd2d1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64617461646f672f64642d74726163652e737667)](https://packagist.org/packages/datadog/dd-trace)[![Total Downloads](https://camo.githubusercontent.com/6791c8647959bc9804fed3577ce0ff5da20d9dad4231e7a08f12f5710ce5578a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f64617461646f672f64642d74726163652e737667)](https://packagist.org/packages/datadog/dd-trace)

Getting Started
---------------

[](#getting-started)

[![bits php](https://user-images.githubusercontent.com/22597395/203064226-b8e84320-87b3-4c38-8305-9933c4ab4996.svg)](https://user-images.githubusercontent.com/22597395/203064226-b8e84320-87b3-4c38-8305-9933c4ab4996.svg)

The Datadog PHP Tracer (**ddtrace**) brings [APM and distributed tracing](https://docs.datadoghq.com/tracing/) to PHP.

### Installing the extension

[](#installing-the-extension)

Datadog’s PHP Tracing Library supports many of the most common PHP versions, PHP web frameworks, datastores, libraries, and more. Prior to installation, please check our latest [compatibility requirements](https://docs.datadoghq.com/tracing/setup_overview/compatibility_requirements/php/).

Visit the [PHP tracer documentation](https://docs.datadoghq.com/tracing/languages/php/) for complete installation instructions.

#### Installation from PECL (datadog\_trace) or from source

[](#installation-from-pecl-datadog_trace-or-from-source)

Compilation of the tracer and the profiler requires cargo to be installed. Ensure that cargo is minimum version 1.84.1, otherwise follow the [official instructions for installing cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html).

### Advanced configuration

[](#advanced-configuration)

For more information about configuring and instrumenting **ddtrace**, view the [configuration documentation](https://docs.datadoghq.com/tracing/setup/php/#configuration).

### OpenTracing

[](#opentracing)

The **ddtrace** package provides an [OpenTracing-compatible tracer](https://docs.datadoghq.com/tracing/custom_instrumentation/php/?tab=tracingfunctioncalls#opentracing).

Contributing
------------

[](#contributing)

Before contributing to this open source project, read our [CONTRIBUTING.md](CONTRIBUTING.md).

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

If you have found a security issue, please contact the security team directly at .

###  Health Score

77

—

ExcellentBetter than 100% of packages

Maintenance87

Actively maintained with recent releases

Popularity71

Solid adoption and visibility

Community47

Growing community involvement

Maturity88

Battle-tested with a long release history

 Bus Factor4

4 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~13 days

Recently: every ~24 days

Total

211

Last Release

56d ago

Major Versions

0.99.1 → 1.0.0beta12024-04-16

PHP version history (6 changes)0.1.0PHP ^5.6||^7.0

0.1.1PHP ^5.6 || ^7.0

0.10.0PHP ^5.4 || ^7.0

0.11.0PHP ~5.4.0 || ~5.6.0 || ^7.0

0.49.0PHP ^5.4 || ^7.0 || ^8.0.0

1.0.0beta1PHP ^7.0 || ^8.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4e1a65eabcf727a80b89a54f9590500b5cbbfa78f01716b351e652826e6d82f0?d=identicon)[DataDog](/maintainers/DataDog)

![](https://www.gravatar.com/avatar/f6db63ad594446f67d79532b75c69439fd0df779cc90868b43c187c02a4221ef?d=identicon)[bwoebi](/maintainers/bwoebi)

---

Top Contributors

[![labbati](https://avatars.githubusercontent.com/u/2952352?v=4)](https://github.com/labbati "labbati (1324 commits)")[![SammyK](https://avatars.githubusercontent.com/u/578780?v=4)](https://github.com/SammyK "SammyK (887 commits)")[![morrisonlevi](https://avatars.githubusercontent.com/u/253316?v=4)](https://github.com/morrisonlevi "morrisonlevi (722 commits)")[![pawelchcki](https://avatars.githubusercontent.com/u/812891?v=4)](https://github.com/pawelchcki "pawelchcki (653 commits)")[![bwoebi](https://avatars.githubusercontent.com/u/3154871?v=4)](https://github.com/bwoebi "bwoebi (575 commits)")[![PROFeNoM](https://avatars.githubusercontent.com/u/42672104?v=4)](https://github.com/PROFeNoM "PROFeNoM (376 commits)")[![realFlowControl](https://avatars.githubusercontent.com/u/14161194?v=4)](https://github.com/realFlowControl "realFlowControl (271 commits)")[![cataphract](https://avatars.githubusercontent.com/u/496394?v=4)](https://github.com/cataphract "cataphract (269 commits)")[![Anilm3](https://avatars.githubusercontent.com/u/929854?v=4)](https://github.com/Anilm3 "Anilm3 (247 commits)")[![estringana](https://avatars.githubusercontent.com/u/1459126?v=4)](https://github.com/estringana "estringana (171 commits)")[![wconti27](https://avatars.githubusercontent.com/u/58711692?v=4)](https://github.com/wconti27 "wconti27 (112 commits)")[![chuck](https://avatars.githubusercontent.com/u/52718?v=4)](https://github.com/chuck "chuck (86 commits)")[![iamluc](https://avatars.githubusercontent.com/u/1539731?v=4)](https://github.com/iamluc "iamluc (77 commits)")[![Leiyks](https://avatars.githubusercontent.com/u/55387832?v=4)](https://github.com/Leiyks "Leiyks (66 commits)")[![mabdinur](https://avatars.githubusercontent.com/u/62392438?v=4)](https://github.com/mabdinur "mabdinur (58 commits)")[![pierotibou](https://avatars.githubusercontent.com/u/22597395?v=4)](https://github.com/pierotibou "pierotibou (49 commits)")[![krakjoe](https://avatars.githubusercontent.com/u/2236138?v=4)](https://github.com/krakjoe "krakjoe (44 commits)")[![nccatoni](https://avatars.githubusercontent.com/u/222672590?v=4)](https://github.com/nccatoni "nccatoni (38 commits)")[![jcchavezs](https://avatars.githubusercontent.com/u/3075074?v=4)](https://github.com/jcchavezs "jcchavezs (37 commits)")[![rachelyangdog](https://avatars.githubusercontent.com/u/175132284?v=4)](https://github.com/rachelyangdog "rachelyangdog (34 commits)")

---

Tags

apmappsecasmdatadogopen-telemetryopentracingphpprofilingtracingphpDataDogtracing

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/datadog-dd-trace/health.svg)

```
[![Health](https://phpackages.com/badges/datadog-dd-trace/health.svg)](https://phpackages.com/packages/datadog-dd-trace)
```

###  Alternatives

[laracraft-tech/laravel-xhprof

Easy XHProf setup to profile your laravel application!

235321.4k](/packages/laracraft-tech-laravel-xhprof)[bavix/laravel-xhprof

Quick profiling of your code for Laravel

22156.6k](/packages/bavix-laravel-xhprof)[h4cc/phpqatools

A meta composer package for PHP QA Tools.

6418.6k1](/packages/h4cc-phpqatools)[thehocinesaad/laravel-error-ai

This package adds Ask AI button to the error page.

2214.4k](/packages/thehocinesaad-laravel-error-ai)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
