PHP get_defined_constants 怎样按扩展分组查看常量
来源:17golang原创
时间:2026-11-18 02:56:33 242浏览 收藏
get_defined_constants(true) 的关键变化是返回结构:第一层不再直接放常量名,而是先按扩展名或 user 分组,第二层才是“常量名 => 常量值”。因此,按扩展查看常量时要先选择分类,再遍历分类里的键值对;不能把第一层键误当成常量名。
这个函数适合做开发环境的常量目录和配置诊断。PHP 官方手册地址:https://www.php.net/manual/en/function.get-defined-constants.php。需要特别记住的是,扩展注册的常量和通过 define() 创建的用户常量会进入结果,但编译期解析的魔术常量不在这个集合里。
categorize=true 返回的结构
函数签名是 get_defined_constants(bool $categorize = false): array。默认值为 false 时,返回的是扁平的“名称 => 值”数组;传入 true 后,结果变成多维数组,第一层键代表注册来源或类别,第二层才保存常量。
| 层级 | 常见内容 | 读取方式 |
|---|---|---|
| 第一层 | Core、pcre、user 等分类 | $groups['pcre'] |
| 第二层 | 常量名称和对应值 | $groups['pcre']['PREG_SET_ORDER'] |
| 排除项 | 魔术常量 | 不在返回集合中 |

分类名不是一份可以硬编码成完整清单的固定表。当前 PHP 进程加载了哪些扩展,会影响可见的扩展分组;而 user 组通常用于放置用户通过 define() 定义的常量。写诊断代码时,应把分类当作运行环境数据来处理。
先选择分类,再读取其中的常量
如果只想查看某个扩展的常量,先检查分类键是否存在,并确认对应值确实是数组。这样可以把“扩展没有加载”与“常量值为空”区分开:
$value) {
// 第二层的键才是常量名,值可能是整数、字符串或布尔值。
printf("%s = %s\n", $name, var_export($value, true));
}
这里的读取顺序有两个要点:$groups 是分类集合,$groups[$category] 才是某个分类里的常量表;另外,不要假设每个扩展都存在,更不要用不存在的分类去做无提示的下标访问。
user 组和扩展组要分开理解
通过 define() 创建的普通用户常量,通常会出现在 user 分类下;扩展提供的常量则归入对应扩展或核心分类。两者混在一起看时,容易把应用配置和运行环境能力误判为同一种来源。
$value) {
// 诊断输出只展示当前分类的键值,不跨组拼接来源。
printf("%s = %s\n", $name, var_export($value, true));
}
}
如果目标是盘点应用自己的配置,优先查看 user 组;如果目标是确认某个扩展提供了哪些常量,则查看对应扩展组。这个分组结果帮助你保留来源信息,但它不会替代扩展加载状态检查或配置管理。
在分组内按常量名前缀筛选
常量目录可能很大,直接全部打印不利于定位。可以在已经选定的分类里,用 str_starts_with() 按名称前缀筛选。前缀筛选作用于第二层的常量名,不作用于第一层的分类名:
$value) {
// 只对常量名做前缀判断,保留原始值供后续诊断使用。
if (str_starts_with($name, $prefix)) {
$matched[$name] = $value;
}
}
foreach ($matched as $name => $value) {
// var_export 能让字符串、布尔值和数字在诊断输出中保持可区分。
printf("%s = %s\n", $name, var_export($value, true));
}
如果需要兼容不提供 str_starts_with() 的旧运行环境,可以换成 strncmp($name, $prefix, strlen($prefix)) === 0,但筛选边界不变:先选分类,再匹配名称,最后输出值。

默认参数和魔术常量的边界
调用 get_defined_constants() 时不传参数,得到的是扁平数组;这适合做全量搜索,但丢失了扩展和 user 来源。需要保留来源时,应显式传入 true,并在代码中按照两层结构遍历。
魔术常量则是另一条边界。像 __FILE__、__LINE__ 这类值由 PHP 在编译阶段解析,不是通过扩展或 define() 注册到常量目录里,因此不会因为打开分类选项而出现在结果中。若业务需要记录当前文件或行号,应直接使用对应魔术常量,而不是从 get_defined_constants(true) 反查。
同样不要把这段代码当成“列出所有 PHP 常量来源”的绝对清单:结果取决于当前进程的内置能力、已加载扩展和用户定义状态。它最适合在开发诊断、配置排查和扩展能力确认中使用,生产日志则应限制输出范围,避免把不必要的环境信息写入日志。
常见问题
get_defined_constants(true) 的第一层是常量名吗?
不是。传入 true 后,第一层键是分类或扩展来源,第二层键才是常量名;如果不需要分组,省略参数得到的是扁平名称和值映射。
为什么找不到自己定义的常量?
先确认常量是在当前 PHP 进程中通过 define() 创建的,再检查 user 分类是否存在。不要把类常量或其他编译期语义当成 define() 常量来查。
可以用它判断扩展是否安装吗?
它可以帮助你观察某些扩展注册的常量,但不应把“某个常量存在”当成完整的扩展状态检测。需要判断扩展是否加载时,应使用更直接的扩展检查方式。
魔术常量为什么不在结果里?
魔术常量在编译阶段解析,不属于通过扩展或用户定义注册的常量集合。需要文件名、行号等信息时,直接引用对应魔术常量。
小结
按扩展分组查看 PHP 常量时,核心写法是 get_defined_constants(true):第一层选择来源,第二层读取名称和值;user 组与扩展组要分开处理;前缀筛选放在具体分组内部;魔术常量不在返回集合中。把这四个边界写清楚,常量诊断代码就不会把分类键、常量键和编译期值混在一起。
-
125 收藏
-
371 收藏
-
455 收藏
-
191 收藏
-
490 收藏
-
196 收藏
-
333 收藏
-
106 收藏
-
299 收藏
-
198 收藏
-
351 收藏
-
112 收藏
-
498 收藏
-
447 收藏
-
170 收藏
-
408 收藏
-
303 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习