Requisitos de compatibilidad PHP
Esta documentación es para el rastreador de PHP v1.x. Si buscas la documentación del rastreador de PHP v0.x, consulta la documentación de
Requisitos de compatibilidad de PHP heredada.
Política de soporte técnico de tiempo de ejecución de PHP APM
La biblioteca de PHP Datadog Trace es de código abierto - consulta el repositorio GitHub para obtener más información.
Datadog APM para PHP se basa en dependencias definidas en versiones específicas del sistema operativo host, tiempo de ejecución de PHP,
determinadas bibliotecas de PHP y el Datadog Agent o API.
Cuando estas versiones dejan de tener soporte técnico de los responsables de mantenimiento, Datadog APM para PHP también limita su soporte técnico a estas.
Niveles de soporte técnico
| Nivel | Asistencia prestada |
|---|
| Sin soporte técnico | Sin implementación. Ponte en contacto con nuestro equipo de atención al cliente para solicitudes especiales. |
| Beta | Implementación inicial. Puede que aún no contenga todas las funciones. El soporte técnico para nuevas funciones, errores y correcciones de seguridad se proporciona en el mejor de los casos. |
| Disponibilidad general (GA) | Implementación completa de todas las funciones. Soporte completo para nuevas funciones, correcciones de errores y de seguridad. |
| Mantenimiento | Implementación completa de las funciones existentes. No recibe nuevas funciones. Soporte técnico solo para correcciones de errores y seguridad. |
| Heredado | Implementación heredada. Puede tener función limitada, pero no se proporciona mantenimiento. Ponte en contacto con el equipo de asistencia para solicitudes especiales. |
| Final del servicio (EOL) | Sin soporte. La versión todavía se puede utilizar, pero no se proporcionan correcciones de errores. |
PHP APM admite las siguientes versiones de PHP (ZTS y NTS):
Nota:
PHP versión 5.x no es compatible a partir de la versión 1.0.0. Si utilizas PHP 5, puedes seguir utilizando el rastreador de PHP hasta la versión
0.99.
Si estás utilizando la versión PHP 5.x en tu aplicación y tienes una solicitud de función que es crítica para tus necesidades de negocio, ponte en contacto con el
servicio de soporte técnico de Datadog .
Se recomienda utilizar
versiones con soporte técnico oficial de PHP, especialmente 8.0+.
| PHP Versión | Nivel de soporte técnico | Paquete versión |
|---|
| 8.3.x | Disponibilidad general | > 0.93.0+ |
| 8.2.x | Disponibilidad general | > 0.82.0+ |
| 8.1.x | Disponibilidad general | > 0.66.0+ |
| 8.0.x | Disponibilidad general | > 0.52.0+ |
| 7.4.x | Disponibilidad general | Todas |
| 7.3.x | Disponibilidad general | Todas |
| 7.2.x | Disponibilidad general | Todas |
| 7.1.x | Disponibilidad general | Todas |
| 7.0.x | Disponibilidad general | Todas |
| 5.6.x | EOL | < 1.0.0 |
| 5.5.x | EOL | < 1.0.0 |
| 5.4.x | EOL | < 1.0.0 |
PHP APM admite los siguientes SAPI:
| SAPI | Tipo de soporte técnico |
|---|
| apache2handler | Todas las versiones compatibles de PHP |
| cli | Todas las versiones compatibles de PHP |
| fpm-fcgi | Todas las versiones compatibles de PHP |
| cgi-fcgi | Todas las versiones compatibles de PHP |
| FrankenPHP | Todas las versiones compatibles de PHP |
Arquitecturas de procesador compatibles
PHP APM es compatible con las siguientes arquitecturas:
| Arquitecturas de procesadores | Nivel de soporte técnico | paquete versión | Tipo de soporte técnico |
|---|
Linux GNU amd64 (x86-64-linux-gnu) | GA | Todas | Todas las versiones compatibles de PHP |
Linux MUSL amd64 (x86-64-linux-musl) | GA | Todas | Todas las versiones compatibles de PHP |
Linux GNU arm64 (aarch64-linux-gnu) | GA | > 0.78.0 | Todas las versiones compatibles de PHP |
Linux MUSL arm64 (aarch64-linux-musl) | GA | > 0.78.0 | Todas las versiones compatibles de PHP |
Windows amd64 (x86_64-windows) | GA | > 0.98.0 | PHP 7.2+ |
Integraciones
Compatibilidad con marcos web
Por defecto, Datadog es compatible con todos los marcos web de PHP desde el primer momento, ya sea con instrumentación a nivel del marco o rastreo web genérico.
La instrumentación al nivel del marco incluye el rastreo de métodos internos y el etiquetado específico del marco.
El rastreo web genérico incluye un tramo (span) deweb.request para rastrear la latencia y los errores que se originan en la llamada, además de tramos para las bibliotecas compatibles - por ejemplo: base de datos y clientes HTTP.
En la siguiente tabla se enumeran algunos de los marcos y versiones que Datadog rastrea con éxito.
Marcos web:
| Módulo | Versiones | Tipo de soporte técnico | Nivel de instrumentación |
|---|
| CakePHP | 2.x | Todas las versiones compatibles de PHP | Instrumentación al nivel del marco |
| CodeIgniter | 2.x | Todas las versiones compatibles de PHP | Instrumentación al nivel del marco |
| CodeIgniter | 3.x | Todas las versiones compatibles de PHP | Rastreo web genérico |
| Drupal | | Todas las versiones compatibles de PHP | Instrumentación al nivel del marco |
| FuelPHP | 1.1 | Todas las versiones compatibles de PHP | Rastreo web genérico |
| Laminas | | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Laravel | 4.2, 5.x, 6.x | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Laravel 8+ | 8.x, 9.x, 10.x, 11.x (rastreador 0.52.0+) | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Lumen | 5.2+ | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Magento | 1 | Todas las versiones compatibles de PHP | Rastreo web genérico |
| Magento | 2 | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Neos Flow | 1.1 | Todas las versiones compatibles de PHP | Rastreo web genérico |
| Phalcon | 1.3, 3.4 | Todas las versiones compatibles de PHP | Rastreo web genérico |
| RoadRunner | 2.x | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Slim | 2.x, 3.x, 4.x | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Symfony | 2.x, 3.3, 3.4, 4.x, 5.x, 6.x, 7.x | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| WordPress | 4.x, 5.x, 6.x | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Yii | 1.1, 2.0 | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Zend Framework | 1.12, 1.21 | Todas las versiones compatibles de PHP | Instrumentación a nivel del marco |
| Zend Framework | 2.x | Todas las versiones compatibles de PHP | Rastreo web genérico |
Ten en cuenta que aunque no veas tu marco web en este lista, es compatible con la última versión del rastreador.
Datadog está añadiendo continuamente más soporte para el rastreo en profundidad para marcos web de PHP. Para solicitar soporte para metadatos de tramos adicionales e información interna del marco, ponte en contacto con nuestro impresionante equipo de soporte técnico.
Compatibilidad con la biblioteca CLI
El rastreo desde CLI SAPI está desactivado por defecto. Para habilitar el rastreo de los scripts CLI de PHP, configure DD_TRACE_CLI_ENABLED=true.
| Módulo | Versiones | Tipo de soporte técnico |
|---|
| Consola CakePHP | 2.x | Todas las versiones compatibles de PHP |
| Laravel Artisan | 5.x, 8.x, 9.x, 10.x | Todas las versiones compatibles de PHP |
| Symfony CLI | 4.x, 5.x, 6.x | Todas las versiones compatibles de PHP |
Para solicitar soporte para bibliotecas CLI adicionales, ponte en contacto con nuestro magnífico equipo de soporte técnico.
Compatibilidad de almacenes de datos
| Módulo | Versiones | Tipo de soporte técnico |
|---|
| Amazon RDS (utilizando PDO o MySQLi) | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
| Elasticsearch | 1+ | Todas las versiones compatibles de PHP |
| Eloquent | Versiones de Laravel compatibles | Todas las versiones compatibles de PHP |
| Colas de Laravel | Versiones de Laravel compatibles | Todas las versiones compatibles de PHP |
| Memcache | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
| Memcached | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
| MongoDB - a través de la extensión mongo | 1.4.x | Todas las versiones compatibles de PHP |
| MySQLi | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
| PDO | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
| PhpRedis | 3, 4, 5 | Todas las versiones compatibles de PHP |
| Predis | 1.1 | Todas las versiones compatibles de PHP |
| SQLSRV | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
Para solicitar asistencia para otros almacenes de datos, ponte en contacto con nuestro impresionante equipo de asistencia.
Compatibilidad de bibliotecas
| Módulo | Versiones | Tipo de soporte técnico |
|---|
| php-amqplib | 2.x, 3.x | PHP 7.1+ |
| Curl | (Cualquier PHP compatible) | Todas las versiones compatibles de PHP |
| Guzzle | 5.x, 6.x, 7.x | Todas las versiones compatibles de PHP |
| Cola de Laravel | Versiones de Laravel compatibles | Todas las versiones compatibles de PHP |
Para solicitar asistencia para bibliotecas adicionales, ponte en contacto con nuestro magnífico equipo de asistencia.
Stacks tecnológicos de llamadas en profundidad en PHP 5
El stack tecnológico de llamadas está limitada en PHP 5. Consulta la página para solucionar problemas de stacks tecnológicos de llamadas en profundidad para obtener más información.
Generadores
La instrumentación generadores no es compatible con PHP 5 y PHP 7.
PCNTL
Datadog es compatible con el rastreo de procesos de bifurcaciones utilizando pcntl. Cuando se detecta una llamada a pcntl_fork, se crea un tramo dedicado y se instrumenta el proceso de bifurcación. Esto puede desactivarse con DD_TRACE_FORKED_PROCESS. Consulta la página de configuración de bibliotecas para obtener más información.
Si la aplicación invoca pcntl_unshare(CLONE_NEWUSER); y el rastreador está instalado, la aplicación se bloquea fatalmente. Esto ocurre porque unshare con CLONE_NEWUSER requiere que el proceso no sea encadenado, mientras que el rastreador de PHP utiliza un subproceso separado para enviar trazas (traces) al Datadog Agent sin bloquear el proceso principal.
Leer más
Additional helpful documentation, links, and articles:
