WeakMap 类仅在 PHP 8.0+ 中存在，低于该版本会触发致命错误；必须通过 class_exists('WeakMap') 运行时验证，仅依赖 PHP_VERSION 判断不可靠。
WeakMap 类存在性必须 runtime 验证，不能只看 PHP_VERSION
WeakMap 是 PHP 8.0+ 原生 final 类，低于该版本直接 fatal error，程序启动即失败。仅检查 PHP_VERSION >= '8.0.0' 不可靠——CLI 和 Web SAPI（如 PHP-FPM）可能使用不同 PHP 二进制，Docker 容器内 phpinfo() 显示的版本也可能与实际加载的 Zend 扩展不一致。
真正有效的验证方式是运行时执行：php -r "var_dump(class_exists('WeakMap'));"。返回 true 才代表可用；若为 false，哪怕 php -v 显示 8.2，也说明当前执行环境未启用该特性。
- 常见误判：本地开发是 PHP 8.2，但 Nginx + PHP-FPM 实际跑的是 7.4 → 报错
Class "WeakMap" not found - Composer 加载了含
new WeakMap()的老版依赖（如某 Laravel 7.x 组件）→ 解析阶段就失败，代码甚至没机会执行 - GitHub Actions 测试通过，预发环境失败 → CI 缓存了旧镜像，未触发完整重编译
联合类型语法在 PHP 7.x 中直接报 Parse error，必须改写
string|int 这类联合类型是 PHP 8.0 引入的语法级特性，在 PHP 7.4 或更低版本中根本无法解析，会立即触发 Parse error: syntax error，不是警告，也不可降级执行。
降级写法核心是移除联合类型声明，改用动态类型校验 + PHPDoc 注释补全语义：
立即学习“PHP免费学习笔记（深入）”；
- 函数签名从
function handle(string|int $input): bool改为function handle($input): bool - 开头加运行时判断：
if (!is_string($input) && !is_int($input)) { throw new InvalidArgumentException('Expected string or int'); } - 补全 PHPDoc：
/** @param string|int $input */，确保 IDE 和静态分析工具仍能识别 - 同步处理配套语法：如
??=要展开为if (!isset($var)) { $var = $default; }，命名参数调用必须改为位置传参
命名参数在低版本中不是“不生效”，而是根本无法解析
像 implode(separator: ',', array: $arr) 这种写法，在 PHP 7.x 中不是跳过或忽略，而是词法解析失败，直接 Fatal error: Uncaught Error。它不是功能缺失，是语法不被识别——连 autoloader 都不会触发。
安全适配只能靠运行时逻辑分支，不能依赖 polyfill：
- 用
version_compare(PHP_VERSION, '8.0.0', '>=')和function_exists()双重判断 - 封装兼容函数，例如：
safe_implode($glue, $pieces)内部按版本分路径调用 - 第三方组件或低代码平台导出的代码，必须搜索项目中所有
:出现在函数调用括号内的位置（如new Form(name: $n)），这类代码需隔离或重构 -
symfony/polyfill-php80对命名参数完全无效，它只模拟函数，不修改解析器
?-> 空安全运算符无法模拟，必须显式判断对象有效性
$user?->getProfile()?->getAvatar() 在 PHP 7.4 中会直接报 Parse error: syntax error, unexpected '?'。这不是运行时问题，是 PHP 解析器在词法阶段就拒绝该语法，脚本根本不会进入执行流程。
替代方案没有捷径，只能靠 is_object() 显式判断中间结果：
- 避免滥用
isset()—— 它对false、0、空字符串也返回false，但这些可能是合法值 - 三层以上链式访问建议提前中断：
if (!$user || !is_object($profile = $user->getProfile()) || !is_object($avatar = $profile->getAvatar())) { return null; } - 可封装轻量工具函数：
safe_call($obj, 'getProfile')，但注意嵌套过深会降低可读性 - 关键点：
?->只处理null，不处理false、0、空数组等，误以为它“防一切空”是常见误用根源
真正容易被忽略的，是那些看似“只影响新功能”的语法变更——它们往往在部署后静默中断整个请求生命周期，连错误日志都不留痕迹。比如一行 ??= 或一个尾逗号缺失，在 PHP 8.0 下可能让整个 ThinkPHP 应用返回 status=78，而你查遍 nginx error_log 都找不到线索。
