PHP魔术常量是编译时快照，值绑定于定义位置而非调用上下文；__FILE__、__DIR__等返回字面量所在文件路径，__FUNCTION__等返回定义处名称，获取调用方信息需用debug_backtrace()。
PHP 魔术常量不是“写一次就到处通用”的静态值，它们的值严格绑定于出现位置——用错地方，__FILE__ 就会返回被包含文件的路径，__LINE__ 会指向调用函数内部的行号，而不是你期望的日志触发点。
为什么 __FILE__ 和 __DIR__ 在 require 文件里返回的不是主脚本路径
这是最常踩的坑：把日志封装成函数后，在函数体内直接用 __FILE__，结果所有日志都标着“来自 log.php”，而不是实际出问题的业务文件。
-
__FILE__和__DIR__是编译时确定的，永远指向**该常量字面量所在文件**的位置，和调用栈无关 - 如果你在
helpers.php里定义了log_error($msg)，并在里面写echo __FILE__;，那它输出的永远是helpers.php的路径 - 想获取“调用方”的位置，必须用
debug_backtrace()提取file和line字段，例如：$bt = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2); $caller = $bt[1] ?? $bt[0]; $file = $caller['file'] ?? 'unknown'; $line = $caller['line'] ?? 0;
__FUNCTION__、__METHOD__ 和 __CLASS__ 的大小写与作用域陷阱
这些常量返回的是**定义处**的名称，不是调用时的上下文。尤其在继承或 trait 中容易误判。
-
__FUNCTION__在匿名函数里返回{closure}，不是字符串名；在方法内使用，返回的是该方法名，不是调用它的函数名 -
__METHOD__格式固定为ClassName::methodName，但若在 trait 中定义并被多个类使用，它仍返回 trait 内部定义时的类名（即空或父类名），不是实际使用的子类名 -
__CLASS__在static方法中不反映运行时实际类，而是编译时声明所在的类；要获取真实调用类，得用get_called_class() - 所有这三者在 PHP 4 中强制小写，PHP 5+ 开始严格保留定义时的大小写——如果你依赖
strtolower(__CLASS__)做判断，PHP 4 兼容场景下可能重复转换
__NAMESPACE__ 和 __TRAIT__ 的编译期行为与命名空间拼接风险
这两个常量在编译阶段就被固化，无法动态感知别名（use AB as C）或运行时命名空间切换。
立即学习“PHP免费学习笔记（深入）”；
-
__NAMESPACE__返回当前文件顶部namespace声明的值，如果文件没声明命名空间，返回空字符串，不是；注意它**不带末尾反斜杠**，拼接类名时得手动加：__NAMESPACE__ . '\MyClass' -
__TRAIT__只在 trait 文件内部有效，且返回的是 trait 定义时的完整限定名（如AppTraitsRetryable），一旦 trait 被 use 到类中，它不会变成AppModelsOrder::Retryable—— 这种“归属感”是开发者脑补的，PHP 不提供 - 在自动加载器中用
__NAMESPACE__拼路径时，务必检查是否为空，否则可能生成/src//SomeClass.php这种非法路径
预定义常量如 PHP_OS、PHP_SAPI、PHP_EOL 的实际兼容性盲区
它们看起来安全，但部分值在不同构建方式或 SAPI 下可能缺失或不可靠。
-
PHP_SAPI在嵌入式 SAPI（如 libphp）或某些容器化 PHP 环境中可能为unknown或空，不能单靠它判断 CLI/Web；更稳妥的是组合判断：php_sapi_name() === 'cli' || !empty($_SERVER['argv']) -
PHP_OS返回的是编译时目标系统，不是运行时宿主系统（例如在 Linux 容器里跑 Windows 编译的 PHP，PHP_OS仍是WINNT）；跨平台路径处理应优先用DIRECTORY_SEPARATOR，而非硬判PHP_OS -
PHP_EOL确实可靠，但仅用于文本输出；写二进制文件或协议通信时，绝不能用它替代PHP_EOL在 Windows 下会破坏协议
真正难的不是记住每个魔术常量怎么写，而是意识到它们全都是“快照”：拍下的是定义那一刻的上下文，不是执行那一刻的现场。调试时想定位问题源头，得主动绕过这些快照，用 debug_backtrace() 拉取调用栈；做环境适配时，别迷信 PHP_OS，而要用运行时探测 + 显式 fallback。
