PHP 7.4 升级到 8.1 需注意四大变更：mb_strpos 第三个参数禁用 float，需显式转 int；create_function 彻底移除，须改用匿名函数；enum 与类/接口同名即报错，需提前重命名；json_encode 对 NaN/INF 和非法 UTF-8 默认静默处理，易致 API 数据异常。
PHP 7.4 升级到 8.1 时 mb_strpos 的第三个参数类型变化
PHP 8.0 起，mb_strpos 的第三个参数（$offset）不再接受 float 类型，传入浮点数会触发 TypeError。很多老项目用 round() 或除法计算偏移量后直接传入，升级后直接报错。
- 错误写法：
mb_strpos($str, 'x', round(strlen($str) / 2))——round()返回 int，但若上游逻辑混入了 float（比如strpos() / 2），就可能崩 - 安全写法：显式强制转整型，
mb_strpos($str, 'x', (int) round(strlen($str) / 2)) - 更稳妥做法：统一用
mb_strpos($str, 'x', (int) $offset)包一层，避免依赖函数返回值类型隐式推导
PHP 8.0 移除了 create_function，必须改用匿名函数
这个函数早在 PHP 7.2 就被标记为 deprecated，到 8.0 彻底删除。它常出现在动态回调、模板引擎或旧版路由匹配中，不能简单替换为 eval() —— 那更危险。
- 典型错误：
$func = create_function('$a', 'return $a * 2;');→ 运行时报Fatal error: Uncaught Error: Call to undefined function create_function() - 正确替换：
$func = fn($a) => $a * 2;（PHP 7.4+ 箭头函数）或$func = function($a) { return $a * 2; }; - 注意闭包变量捕获：原
create_function是在全局作用域执行的，不自动绑定上下文；改用function时需手动用use传参，比如function($a) use ($multiplier) { return $a * $multiplier; }
PHP 8.1 的 enum 不是“语法糖”，类名冲突要提前清理
如果项目里已有叫 Status、Type 的 class 或 interface，而你又想在 PHP 8.1+ 引入 enum Status，会直接报 Fatal error: Cannot declare enum Status because the name is already in use。这不是警告，是编译期失败。
- 枚举名和类/接口/trait 名字空间完全同级，不允许重名，哪怕在不同文件里
- 检查方式：用
grep -r "class Status" .和grep -r "interface Status" .扫描全项目，再人工确认是否可重命名旧类 - 兼容过渡建议：先给旧类加命名空间前缀（如
LegacyStatus），再新建enum Status；别指望自动 fallback
json_encode 默认行为变更导致 API 响应结构突变
PHP 8.0 开始，json_encode 对 NaN、INF、-INF 默认返回 null（之前是空字符串或报错），且默认启用 JSON_INVALID_UTF8_IGNORE —— 意味着含非法 UTF-8 字节的字符串会被静默截断，前端收到的 JSON 可能突然变短或字段消失。
立即学习“PHP免费学习笔记（深入）”；
- 典型现象：API 返回的某个字段值从
"名字"变成"名字"，或数字字段变成null，但后端日志无报错 - 排查方法：升级后加临时日志，
var_dump(json_last_error(), json_last_error_msg());看是否触发了JSON_ERROR_INF_OR_NAN或JSON_ERROR_INVALID_UTF8 - 修复策略：对敏感字段提前过滤，比如用
mb_convert_encoding($str, 'UTF-8', 'UTF-8')清理编码；对浮点数做is_finite($val) ? $val : null判断
实际迁移中最容易卡住的，不是语法报错，而是这些“静默变更”——它们让数据在某次请求里悄悄变形，等发现时已经影响到下游业务逻辑。建议在 CI 中加入 PHP 8.x 的 lint + 小范围真实流量影子比对，而不是只靠单元测试覆盖。
