PHP Agent 支持矩阵

注意

1. 非官方或未列出的扩展/模块不在支持范围内。 这些模块可能与探针冲突，部署到生产前请在测试环境充分验证；如需支持，请提交适配单。
2. 与探针使用相同 hook 技术的 PHP 模块可能存在冲突风险，例如某些加解密模块、底层扩展、与其他厂商的探针、xdebug调试模块等。遇到冲突请优先在测试环境复现并排查。
3. 探针版本变动可能导致对 Apache graceful 的支持发生变化（即某些探针版本下可能无法兼容 Apache 的 graceful 重启行为），上线前请验证。
4. 对于 Alpine / musl、特殊发行版或非常旧的系统（例如某些早期 Ubuntu/RedHat 版本），建议先在目标环境中做兼容性测试。
5. 在使用多线程/异步扩展（如 Swoole 等）时，请参考探针文档与扩展本身的兼容说明，避免未定义行为。
6. 自动监控 PHP 应用需要系统中存在有效的 php.ini 配置文件。 可通过以下命令检查 PHP 配置文件是否存在及其加载路径： php --ini 如果命令输出中包含有效的 Loaded Configuration File 路径，且对应的 php.ini 文件存在，则满足自动监控的配置要求。
7. 仅测试验证了每个大版本的最低小版本号和最大小版本号。

操作系统

系统类型	支持版本
CentOS	6.0+
RedHat	5.1+
Ubuntu	10.4+
SUSE	12.1+
Debian	5.0+
openSUSE	12.1+
麒麟系统	银河麒麟 V10

---

PHP版本

类型	支持版本
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 从 phpagent-7.6.0 开始支持，对应 smartagent 7.2.0

---

容器

容器类型	支持版本
Apache	2.2+（线程安全与非线程安全）
Nginx + PHP-FPM
Alpine	3.7.3 ~ 3.18.2

---

数据库

类型	支持版本
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

---

远程调用

类型	支持版本
HTTP	curl.so、fopen、file_get_contents

---

MQ

类型	支持版本
RdKafka	1.0.0 ~ 6.0.1
AMQP	2.9 ~ 3.1.2

---

支持的框架

框架类型
ThinkPHP
Laravel
Yii

---

其他

功能	说明
Solr	2.5.1（solr.so）
Swoole	swoole.so-V4.5.2、4.8.1 不支持 JS 注入