Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel,
n'hésitez pas à nous contacter.
Compatibility
The PHP Datadog Trace library is open source - view the GitHub repository for more information.
PHP APM supports the following PHP versions:
| Version | Support type |
|---|
| 8.1.x | Fully Supported (tracer 0.66.0+) |
| 8.0.x | Fully Supported (tracer 0.52.0+) |
| 7.4.x | Fully Supported |
| 7.3.x | Fully Supported |
| 7.2.x | Fully Supported |
| 7.1.x | Fully Supported |
| 7.0.x | Fully Supported |
| 5.6.x | Fully Supported |
| 5.5.x | Fully Supported (tracer 0.49.0+) |
| 5.4.x | Fully Supported |
PHP APM supports the following SAPI’s:
| SAPI | Support type |
|---|
| apache2handler | Fully Supported |
| cli | Fully Supported |
| fpm-fcgi | Fully Supported |
| cgi-fcgi | Fully Supported |
Integrations
Web framework compatibility
By default, Datadog supports all PHP web frameworks out of the box, with either framework-level instrumentation, or generic web tracing.
Framework-level instrumentation includes tracing of internal methods and framework specific tagging.
Generic web tracing includes a web.request span to track latency and errors that originated from the call, in addition to spans for supported libraries — for example: database and HTTP clients.
The following table enumerates some of the frameworks and versions Datadog successfully traces.
Web frameworks:
| Module | Versions | Support Type | Instrumentation level |
|---|
| CakePHP | 2.x | All supported PHP versions | Framework-level instrumentation |
| CodeIgniter | 2.x | PHP 7+ | Framework-level instrumentation |
| CodeIgniter | 3.x | PHP 7+ | Generic web tracing |
| Laravel | 4.2, 5.x, 6.x | All supported PHP versions | Framework-level instrumentation |
| Laravel 8 | 8.x (tracer 0.52.0+) | All supported PHP versions | Framework-level instrumentation |
| Lumen | 5.2+ | All supported PHP versions | Framework-level instrumentation |
| Symfony 3 | 3.3, 3.4 | All supported PHP versions | Framework-level instrumentation |
| Symfony 4 | 4.x | All supported PHP versions | Framework-level instrumentation |
| Symfony 5 | 5.x (tracer 0.50.0+) | All supported PHP versions | Framework-level instrumentation |
| WordPress | 4.x, 5.x | PHP 7+ | Framework-level instrumentation |
| Zend Framework | 1.12 | All supported PHP versions | Framework-level instrumentation |
| Zend Framework | 2.x | All supported PHP versions | Generic web tracing |
| Yii | 1.1, 2.0 | All supported PHP versions | Framework-level instrumentation |
| Drupal | | All supported PHP versions | Generic web tracing |
| Magento | 1, 2 | All supported PHP versions | Generic web tracing |
| Phalcon | 1.3, 3.4 | All supported PHP versions | Generic web tracing |
| Slim | 2.x, 3.x, 4.x | All supported PHP versions | Framework-level instrumentation |
| Neos Flow | 1.1 | All supported PHP versions | Generic web tracing |
| FuelPHP | 1.1 | PHP 7+ | Generic web tracing |
Note that even if you don’t see your web framework in this list, it is supported out of the box with the latest release of the tracer.
Datadog is continuously adding more support for in-depth tracing for PHP web-frameworks. To request support for additional span metadata and framework internals, contact our awesome support team.
CLI library compatibility
Tracing from the CLI SAPI is disabled by default. To enable tracing of PHP CLI scripts, set DD_TRACE_CLI_ENABLED=true.
| Module | Versions | Support Type |
|---|
| CakePHP Console | 2.x | Fully Supported |
| Laravel Artisan | 5.x | Fully Supported |
To request support for additional CLI libraries, contact our awesome support team.
Datastore compatibility
| Module | Versions | Support Type |
|---|
| Amazon RDS (using PDO or MySQLi) | (Any Supported PHP) | Fully Supported |
| Elasticsearch | 1.x | Fully Supported |
| Eloquent | Laravel supported versions | Fully Supported |
| Memcached | (Any Supported PHP) | Fully Supported |
| MongoDB - via mongo extension | 1.4.x | Fully Supported |
| MySQLi | (Any Supported PHP) | Fully Supported |
| PDO (MySQL, PostgreSQL, MariaDB) | (Any Supported PHP) | Fully Supported |
| PhpRedis | 3, 4, 5 | PHP 7, 8 |
| Predis | 1.1 | Fully Supported |
To request support for additional datastores, contact our awesome support team.
Library compatibility
| Module | Versions | Support Type |
|---|
| Curl | (Any Supported PHP) | Fully Supported |
| Guzzle | 5.x | Fully Supported |
| Guzzle | 6.x | Fully Supported |
To request support for additional libraries, contact our awesome support team.
Deep call stacks on PHP 5
The call stack is limited on PHP 5. See the deep call stack troubleshooting page for more details.
Generators
Instrumenting generators is not supported on PHP 5 and PHP 7.
PCNTL
Datadog does not offer support for tracing processes forked using pcntl. When a call to pcntl_fork is detected, tracing is disabled in the forked process. The main process can still be traced.
If the application invokes pcntl_unshare(CLONE_NEWUSER); and the tracer is installed, the application fatally crashes. This happens because unshare with CLONE_NEWUSER requires the process not to be threaded, while the PHP tracer uses a separate thread to send traces to the Datadog Agent without blocking the main process.
Further Reading
Documentation, liens et articles supplémentaires utiles:
