PHP运行中出现Call to undefined constant错误，本质是代码调用了尚未定义的常量，这类问题在开发和维护阶段都可能出现，需要结合具体场景排查原因。
常见错误触发场景
1. 常量名称拼写错误
定义常量时使用的名称和调用时的名称不一致，是最常见的原因。比如定义时写的是USER_NAME，调用时写成了USER_NAMW。
2. 常量未提前定义
调用常量的代码执行时，对应的常量定义语句还没有执行，比如在函数内部调用全局常量，但常量定义在函数调用之后。
3. 作用域不匹配
类常量、接口常量等需要在对应的类或接口作用域内调用，如果脱离作用域直接调用就会触发错误。比如调用ClassA::CONST_NAME时，ClassA类中并没有定义CONST_NAME常量。
4. 未加载定义常量的文件
常量定义在其他文件中，当前脚本没有通过require或include加载该文件，导致常量未被定义。
错误排查步骤
可以按照以下步骤逐步定位问题：
- 首先查看错误提示的具体信息，确认未定义的常量名称是什么，以及错误发生的文件和行号。
- 全局搜索项目代码，确认该常量是否在整个项目中有定义，检查定义处的名称是否和调用处完全一致，注意大小写是否匹配，PHP常量默认是大小写敏感的。
- 查看常量定义的代码是否在调用代码之前执行，如果定义语句在调用之后，需要调整代码执行顺序。
- 确认调用常量的作用域是否正确，类常量需要用
类名::常量名的方式调用，普通常量直接写常量名即可。 - 检查当前脚本是否加载了定义该常量的文件，如果未加载需要添加对应的引入语句。
正确的常量定义方式
普通常量定义
使用define()函数定义普通常量，语法如下：
<?php
// 定义普通常量，默认大小写敏感
define('SITE_NAME', '我的个人站点');
// 定义不区分大小写的常量，第三个参数传true
define('SITE_URL', 'https://ipipp.com', true);
// 调用常量
echo SITE_NAME; // 输出 我的个人站点
echo site_url; // 输出 https://ipipp.com，因为定义时设置了不区分大小写
?>
类常量定义
类常量需要在类内部使用const关键字定义，不能通过define()在类外部定义类常量：
<?php
class User {
// 定义类常量
const ROLE_ADMIN = 1;
const ROLE_USER = 2;
public function getRole() {
// 类内部调用类常量
return self::ROLE_USER;
}
}
// 类外部调用类常量
echo User::ROLE_ADMIN; // 输出 1
?>
特殊注意事项
需要注意几个容易踩坑的点：
- PHP中未定义的常量会被当做字符串处理，同时触发
E_NOTICE级别的错误，如果错误报告级别开启，就会显示Call to undefined constant提示，所以不要依赖这种隐式转换。 - 常量一旦定义就不能被重新定义或者取消定义，重复定义同一个常量会触发错误。
- 如果使用
defined()函数判断常量是否存在，可以避免调用未定义常量的错误：
<?php
if (defined('SITE_NAME')) {
echo SITE_NAME;
} else {
echo '常量未定义';
}
?>
按照上述方法排查和处理，基本可以解决所有Call to undefined constant相关的问题，日常开发中建议规范常量的定义和使用，减少这类错误的出现。
PHPundefined_constant常量定义错误排查修改时间：2026-07-04 17:00:25