如何让 ini_get_all() 不区分扩展名大小写

千雪吖_7200

千雪吖_7200

2026-11-16

271人浏览

原创

在 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 页面

▲ 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 投票结果邮件

▲ 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 实现合并请求

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」(页面原文拼写如此),没有任何已发布版本包含这一改动,现有版本的行为以本文「现象」一节描述的为准。

ClipDrop
ClipDrop

ClipDrop是一款提供抠图、清理、放大、补光和图像生成的 AI 图片工具套件。

下载

关键信息

项目 内容
类目 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

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

13004

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7441

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2275

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4708

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5414

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4271

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

6197

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4862

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12582

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
《20天入门精通PHP》视频教程
《20天入门精通PHP》视频教程

共200课时 | 49.6万人学习