登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  php教程

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 get_defined_constants true 返回分类键、扩展组和 user 组的静态结构图
图1:说明图。第一层是分类,第二层才是常量名和值;这是静态结构图,不是运行截图。

分类名不是一份可以硬编码成完整清单的固定表。当前 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,但筛选边界不变:先选分类,再匹配名称,最后输出值。

PHP 按扩展或 user 分类选择常量集合并按名称前缀筛选的静态关系图
图2:结构图。分组选择和前缀筛选都作用在已返回的常量集合上;魔术常量不属于这个集合。

默认参数和魔术常量的边界

调用 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 组与扩展组要分开处理;前缀筛选放在具体分组内部;魔术常量不在返回集合中。把这四个边界写清楚,常量诊断代码就不会把分类键、常量键和编译期值混在一起。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>