快速定位php常量未定义错误：先确认define()/const是否漏写、作用域是否正确、加载顺序是否合理；再用defined()验证存在性并检查拼写、大小写、命名空间前缀；注意define()运行时生效，const编译时解析，类常量需作用域访问。
常量未定义错误怎么快速定位
PHP 报 Notice: Use of undefined constant XXX - assumed 'XXX' 或 Fatal error: Uncaught Error: Undefined constant 'XXX'，本质是 PHP 在解析时把没声明的标识符当作了裸字符串（PHP 7.2+ 默认报 Fatal），而不是你本意的常量。最直接的排查路径是：先确认是否漏写了 define() 或 const，再检查作用域和加载顺序。
检查常量是否在使用前已定义
PHP 常量不具备“变量提升”特性，必须在使用前完成定义。常见疏漏点：
-
define('API_TIMEOUT', 30)写在了if分支里，但实际执行路径跳过了该分支 - 常量定义在某个函数或类方法内部（
const FOO = 1;在函数里是语法错误；define()在函数里虽可运行，但作用域仅限该次调用） - 定义语句被注释、条件编译（如
if (false) { define(...); }）或被早期return阻断 - 文件引入顺序错误：使用常量的代码在
require/include定义文件之前执行
验证常量是否存在且拼写正确
别靠肉眼扫，用代码实锤：
var_dump(defined('DB_HOST')); // bool(true) or bool(false)
echo defined('DB_HOST') ? DB_HOST : 'not defined';注意：defined() 只接受字符串字面量或变量，不能传表达式；大小写敏感（除非用 define('FOO', 'bar', true) 启用忽略大小写，但不推荐）。
立即学习“PHP免费学习笔记（深入）”；
拼写错误高频场景：
- 下划线/大小写混淆：
MAX_RETRY写成MAX_RETRY_COUNT或max_retry - 环境前缀遗漏：
PROD_API_URL在开发环境未定义，却没做兜底 - 命名空间干扰：在命名空间内直接写
MY_CONST，实际应为\MY_CONST（全局常量需加反斜杠前缀）
区分 define()、const 和 class const 的行为差异
三者不可混用，尤其注意作用域和执行时机：
-
define('A', 1)：运行时执行，可在任意位置（包括条件语句中），定义的是全局常量 -
const A = 1;（文件作用域）：编译时解析，必须在顶层作用域，不能在函数/循环里 -
class C { const B = 2; }：属于类作用域，访问需用C::B，不能直接B
常见陷阱：const VERSION = '1.0'; 写在某个 .php 文件里，但该文件没被加载；或者误以为 class const 是全局的，直接写 VERSION 导致未定义。
最易被忽略的是加载顺序和条件逻辑——哪怕定义语句存在，只要没被执行到，就等于没定义。调试时优先加 var_dump(__FILE__, __LINE__); 到定义语句前后，确认它真的跑过了。
