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, low-level extensions, agents from other vendors, and the Xdebug module. 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.
- Automatic monitoring of PHP applications requires a valid php.ini configuration file on the system.
Check whether the PHP configuration file exists and its load path with the following command:
php --iniIf the command output contains a valid Loaded Configuration File path and the corresponding php.ini file exists, the configuration requirement for automatic monitoring is met. - Only the minimum and maximum minor versions of each major version have been tested and verified.
Operating Systems
| System Type | Supported Versions |
|---|---|
| CentOS | 6.0+ |
| RedHat | 5.1+ |
| Ubuntu | 10.4+ |
| SUSE | 12.1+ |
| Debian | 5.0+ |
| openSUSE | 12.1+ |
| Kylin | Galaxy Kylin V10 |
PHP Versions
| Type | Supported 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
| Container Type | Supported Versions |
|---|---|
| Apache | 2.2+ (thread-safe and non-thread-safe) |
| Nginx + PHP-FPM | |
| Alpine | 3.7.3 ~ 3.18.2 |
Databases
| Type | Supported Versions |
|---|---|
| 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
| Type | Supported Versions |
|---|---|
| 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
| Type | Supported Versions |
|---|---|
| HTTP | curl.so, fopen, file_get_contents |
MQ
| Type | Supported Versions |
|---|---|
| RdKafka | 1.0.0 ~ 6.0.1 |
| AMQP | 2.9 ~ 3.1.2 |
Supported Frameworks
| Framework |
|---|
| ThinkPHP |
| Laravel |
| Yii |
Other
| Feature | Notes |
|---|---|
| Solr | 2.5.1 (solr.so) |
| Swoole | swoole.so-V4.5.2, 4.8.1 JavaScript injection not supported |