PHP Agent Support Matrix
warning
- Unofficial or unlisted extensions/modules are not supported. These modules may conflict with the agent, please thoroughly validate in test environment before deploying to production; if support is needed, please submit an adaptation request.
- PHP modules that use the same hooking technology as the agent may have conflict risks, such as certain encryption/decryption modules or low-level extensions. If conflicts occur, please reproduce and troubleshoot in the test environment first.
- Changes in agent versions may affect support for Apache graceful restarts (i.e., some agent versions may not be compatible with Apache's graceful restart behavior), please validate before going live.
- For Alpine/musl, special distributions, or very old systems (such as early Ubuntu/RedHat versions), it is recommended to perform compatibility testing in the target environment first.
- When using multi-threading/asynchronous extensions (such as Swoole, etc.), please refer to the agent documentation and the extension's compatibility notes to avoid undefined behaviors.
- Only the minimum and maximum minor versions of each major version have been tested and verified.
| Item | Support Details |
|---|---|
| Operating System | CentOS 6.0+ |
| RedHat 5.1+ | |
| Ubuntu 10.4+ | |
| SUSE 12.1+ | |
| Debian 5.0+ | |
| openSUSE 12.1+ | |
| Kylin System (Galaxy Kylin V10) | |
| PHP Versions | PHP 5.2.14+ |
| PHP 5.3+ | |
| PHP 5.4+ | |
| PHP 5.5+ | |
| PHP 5.6+ | |
| PHP 7.0+ | |
| PHP 7.1+ | |
| PHP 7.2+ | |
| PHP 7.3+ | |
| PHP 7.4+ | |
| PHP 8.0+ | |
| PHP 8.1.7 (supported starting from phpagent-7.6.0, corresponding to smartagent 7.2.0) | |
| Containers | Apache 2.2+ (thread-safe and non-thread-safe) |
| Nginx + PHP-FPM | |
| Alpine 3.7.3-3.18.2 | |
| Databases | MySQL (mysql.so, mysqli.so, pdo_mysql.so) |
| SQLite (pdo_sqlite, sqlite3) | |
| Oracle (oci8.so-2.2.0, pdo_oci.so) | |
| PostgreSQL (pgsql.so, pdo_pgsql.so) | |
| NoSQL | Redis (redis.so: 5.3.7, predis: 2.0.0) |
| MongoDB (mongodb.so: 1.1.8 ~ 1.13.0, mongo.so: 1.6.16) | |
| Memcached (memcached.so-1.0.18, memcache.so) | |
| Remote Calls | HTTP (curl.so, fopen, file_get_contents) |
| MQ | RdKafka: 1.0.0 ~ 6.0.1, AMQP: 2.9 ~ 3.1.2 |
| Supported Frameworks | ThinkPHP |
| Laravel | |
| Yii | |
| Others | Solr 2.5.1 (solr.so) |
| Swoole (swoole.so-V4.5.2, 4.8.1) JavaScript injection not supported |