在 php 里查一个扩展的信息,extension_loaded('pcre')、get_extension_funcs('pcre')、phpversion('pcre') 都能正常返回,唯独 ini_get_all('pcre') 会先抛一条 e_warning 再返回 false——想让第四个函数工作,参数必须写成小写的 'pcre'。2026 年 11 月 16 日,官方投票以 20 票赞成、0 票反对、3 票弃权通过 rfc「case-insensitive extension names in ini_get_all()」,实现已并入 php-src master(目标版本 php 8.7)。本文讲清这个不一致的现象、根因、官方修复内容,以及在 8.7 发布前代码该怎么写。

▲ wiki.php.net RFC 页面
先把这次事件的官方时间线理一遍:投票线程由 Weilin Du 于 10 月 30 日发起、11 月 2 日公告投票于 2026-11-16 00:00:00 UTC 结束;16 日 05:19:21 UTC,php.internals 邮件列表第 133105 号邮件公布结果——「The results are 20 yeas, 0 nays, 3 abstain. The RFC is now accepted.」约两分钟后,wiki.php.net 的 RFC 变更 feed 记录页面状态迁移,Implementation 字段指向 php-src PR #25448;再过两分钟,实现提交落地 master 分支。从公布结果到代码合并,整个过程不到五分钟。

▲ php.internals 投票结果邮件
现象:四个函数对同一个扩展名给出两种答案
RFC 页面用一段对照代码把问题摆得很直白:
extension_loaded('Pcre'); // true
get_extension_funcs('Pcre'); // array of function names
phpversion('Pcre'); // extension version string
ini_get_all('Pcre'); // E_WARNING, then false
前三个函数对大小写都不敏感,唯独 ini_get_all() 要求参数必须是注册时的小写形式,传 'PDO' 会报「Extension "PDO" cannot be found」并返回 false,传 'pdo' 才能拿到配置项列表。本地验证只需一行:php -r 'var_dump(ini_get_all("Pcre"));',当前版本会先输出 Warning 再输出 bool(false)。这个问题不算罕见触发——配置面板、运维脚本、依赖检查工具经常把用户输入或依赖清单里的扩展名原样传进来,大小写稍有不一致就会踩到。
根因:注册表键是小写的,查找却没走小写接口
php-src 中所有已加载扩展登记在全局哈希表 module_registry 里。注册入口 zend_register_module_ex()(Zend/zend_API.c)会先用 zend_str_tolower_copy() 把扩展名整体转成小写,再作为键存入哈希表——这正是 extension_loaded() 一类函数天然大小写不敏感的基础。phpversion() 背后的 zend_get_module_version() 也一直走小写查找接口 zend_hash_str_find_ptr_lc()。而 ini_get_all() 的实现(ext/standard/basic_functions.c)用的是大小写敏感的 zend_hash_find_ptr(),拿 'Pcre' 去查小写键 'pcre' 当然落空,于是走进「cannot be found」的告警分支。也就是说,注册侧早就统一成小写了,只是 ini_get_all() 这一处查询接口没跟上,修复因此只需要一行。
官方修复:一行查找改动加一份回归测试
实现走 PR #25448,2026-11-16 05:23:57 UTC 并入 master,合并提交为 46da0fda907d44ca1705f682a286722e8966ef29。整个 PR 改动 4 个文件、+43/−1 行:核心修复就是把 zend_hash_find_ptr() 换成 zend_hash_find_ptr_lc()——按 Zend/zend_hash.h 的注释,这个接口会自动把传入键转成小写再查找,正好匹配注册表的存键方式;匹配按 ASCII 规则、与当前 locale 无关,$details 两个取值下行为一致。另两个改动是 NEWS 与 UPGRADING 各加一条 PHP 8.7 变更说明,以及新增回归测试 ini_get_all_case_insensitive.phpt,用 'PCRE'、'Pcre'、'pCrE' 三种写法逐一断言结果与 'pcre' 完全一致,同时确认不存在的扩展名仍告警并返回 false。核心改动如下:
ext/standard/basic_functions.c
@@ -1950,7 +1950,7 @@ PHP_FUNCTION(ini_get_all)
zend_ini_sort_entries();
if (extname) {
- if ((module = zend_hash_find_ptr(&module_registry, extname)) == NULL) {
+ if ((module = zend_hash_find_ptr_lc(&module_registry, extname)) == NULL) {
php_error_docref(NULL, E_WARNING, "Extension \"%pS\" cannot be found", extname);
RETURN_FALSE;
}
▲ 补丁片段摘自上述合并提交

▲ php-src 实现合并请求

▲ php-src 合并提交
8.7 发布前代码怎么写
在能升级到包含该修复的 8.7 之前,调用 ini_get_all() 前先 strtolower($extension) 是当前唯一可靠写法——注册表键本身就是小写,传小写名在今天就能命中。反过来要注意的是依赖旧行为的代码:如果有逻辑刻意用「ini_get_all($name) 返回 false 且带告警」来判断扩展名是否合法(例如只接受全小写写法的校验),8.7 起「仅大小写不同」的名字会成功返回数组而不是 false,RFC 已把这条明确列入 Backward Incompatible Changes,升级检查清单里要专门过一遍;本来就能成功返回的调用不受影响。最后提醒一点:该修复目前只存在于 master 分支,RFC 页面状态字段原文写作「Implementated」(页面原文拼写如此),没有任何已发布版本包含这一改动,现有版本的行为以本文「现象」一节描述的为准。
关键信息
| 项目 | 内容 |
|---|---|
| 类目 | RFC 与需求 |
| 级别 | 中 |
| 日期 | 投票结束 2026-11-16 00:00:00 UTC;结果公布 05:19:21 UTC |
| 投票结果 | 20 票赞成 / 0 票反对 / 3 票弃权,RFC 获接受 |
| 关联编号 | RFC: case_insensitive_ini_get_all / PR #25448 |
| 合并提交 | 46da0fda907d44ca1705f682a286722e8966ef29(2026-11-16 05:23:57 UTC 并入 master) |
| 影响范围 | ini_get_all() 的 $extension 参数;目标版本 PHP 8.7(未随任何已发布版本发布) |
| 向后不兼容 | 仅大小写不同的扩展名从「告警并返回 false」变为成功返回 |
| 核验状态 | 双源交叉核实(php.internals 邮件列表 + wiki.php.net RFC/feed) |
来源:https://news-web.php.net/php.internals/133105
来源:https://wiki.php.net/rfc/case_insensitive_ini_get_all
来源:https://github.com/php/php-src/pull/25448
来源:https://github.com/php/php-src/commit/46da0fda907d44ca1705f682a286722e8966ef29











