可通过分析扩展头文件中的PHP_VERSION_ID条件判断、ext.json的requires.php字段及ZEND_MODULE_API_NO宏值,反推出PHP核心版本;例如PHP_VERSION_ID>=80200对应PHP 8.2.0,ext.json中"^8.3.0"表明兼容PHP 8.3及以上,ZEND_MODULE_API_NO=20240828则对应PHP 8.4。

当你拿到一份未经编译的PHP源码,又找不到README或php_version.h,但发现ext目录下存在redis、mbstring等扩展子目录时,可通过分析这些扩展的结构特征、宏定义和依赖声明反推出其归属的核心PHP版本。
检查扩展头文件中的PHP_VERSION宏引用
多数扩展在初始化或声明函数时会显式引用PHP_VERSION或PHP_MAJOR_VERSION,这些宏必须由核心头文件提供,因此其存在形式能暴露PHP大版本边界。
进入目标扩展目录,例如ext/mbstring,打开php_mbstring.h文件。
搜索#include "main/php.h"或#include "php.h"所在行——若该行上方紧邻#define PHP_VERSION或PHP_MAJOR_VERSION的条件编译块,则说明该扩展适配PHP 8.0+;若直接包含php_version.h且无中间封装层,则更倾向PHP 7.x或更早。
立即学习“PHP免费学习笔记(深入)”;
若在php_mbstring.h中发现#if PHP_VERSION_ID >= 80200这类判断,可直接提取数字80200,它对应PHP 8.2.0,即【PHP_VERSION_ID值必须与核心版本严格一致,否则编译失败】。
解析ext.json中的PHP版本约束
PHP 8.0起,官方扩展逐步引入ext.json作为结构化元数据载体,其中requires.php字段明确定义了兼容的PHP主版本范围。
方法一:查看是否存在ext.json
在ext/openssl目录下执行ls ext.json,若存在,用cat ext.json | jq -r '.requires.php'提取值,常见格式如"^8.3.0"或=8.2.0 。
方法二:若ext.json缺失,退而检查config.m4中的AC_MSG_CHECKING逻辑
打开ext/openssl/config.m4,查找类似AC_MSG_CHECKING([for PHP version >= 8.2])的语句,其后紧跟的if test "$PHP_VERSION_ID" -ge "80200"; then即为硬编码的版本门槛。
注意:某些第三方扩展(如swoole)可能伪造ext.json内容,务必交叉验证其config.m4中实际使用的PHP_VERSION_ID比较逻辑。
比对ZEND_MODULE_API_NO与扩展内嵌ABI检测
第一步:定位核心ABI标识
打开Zend/zend_modules.h,查找#define ZEND_MODULE_API_NO,记录其数值,例如20240828。
第二步:检查扩展是否主动校验该值
进入ext/curl目录,运行grep -n "ZEND_MODULE_API_NO" config.m4。若返回含PHP_CHECK_PHP_ABI的行,说明该扩展强制要求ABI匹配;若无此调用,但php_curl.h中定义了#if ZEND_MODULE_API_NO != 20240828,则表明开发者已手动锁死兼容版本。
第三步:确认扩展是否启用PHP_FE注册模式
执行grep -r "PHP_FE.*curl_" ext/curl/,若结果中包含PHP_FE(curl_init, arginfo_curl_init)且arginfo_*函数在curl.c中完整实现,则说明该扩展采用PHP 8.0+标准函数注册协议;若仅见ZEND_FE或PHP_NAMED_FE,则大概率属于PHP 7.x分支。
这一步操作起来很简单,直接把文件拖进去就行。
运行时加载测试反向锁定最小兼容版本
① 编译并安装该扩展到一个已知版本的PHP环境中,例如PHP 8.1.25。
② 执行php --ri curl,观察输出是否含curl version => 8.1.25字样——若显示的是扩展自身版本(如libcurl 8.10.1),则跳过此步。
③ 若扩展加载失败并报错undefined symbol: php_register_internal_class_ex,说明该扩展使用了PHP 8.0+废弃的类注册接口,反推其源码基于PHP 8.0或更新。
④ 若加载成功但php -m | grep curl无输出,检查php.ini中是否启用了extension=curl,再执行strace -e trace=openat php -m 2>&1 | grep curl确认动态库路径是否被正确解析。
⑤ 最终以php -d extension=modules/curl.so -r "echo 'loaded';"方式绕过ini加载链,验证扩展二进制本身是否具备向前兼容性。



















