近期将项目升级 PHP8.0+ 版本后，很多人会遇到一个经典的致命报错：
PHP Fatal error: Array and string offset access syntax with curly braces is no longer supported
这个报错是PHP8 破坏性变更导致的，旧项目直接运行会直接瘫痪，本文带你从零读懂报错原因、快速修复、批量全局替换、避坑指南，一次性彻底解决问题。
一、报错核心原因
在 PHP5 / PHP7 中，支持两种下标取值写法：
- 方括号写法：
$str[0]、$arr[1]（标准、通用写法） - 大括号写法：
$str{0}、$arr{1}（旧版兼容写法）
而 {}PHP8.0 及以上版本彻底废弃了大括号 访问数组、字符串下标的语法，只要代码中存在该写法，直接抛出致命错误，程序终止运行。
二、错误写法 VS 正确写法
❌ 废弃写法（必须全部替换）
以下写法在 PHP8+ 完全失效，是报错的根源：
// 字符串下标取值
$str{0};
// 数组下标取值
$arr{1};
// 动态下标取值
$var{$key};✅ 兼容所有版本的正确写法
统一替换为方括号 []，兼容 PHP5/7/8 全版本：
// 字符串下标取值
$str[0];
// 数组下标取值
$arr[1];
// 动态下标取值
$var[$key];三、重点避坑：这些大括号不用改！
很多同学批量替换时会误改代码，这里重点区分：只有【下标取值的大括号】需要替换，以下场景的大括号完全不受影响，无需修改：
- 变量变量解析：
${$name} - 代码逻辑代码块：
if(){}、foreach(){}、函数、类的大括号 - 字符串变量解析：
"{$name} 测试"
只需专注替换 $变量{下标} 格式的代码即可。
四、项目批量全局修复方案
如果项目代码量大，手动修改效率极低，推荐两种批量替换方案，全覆盖无遗漏。
1、编辑器全局正则替换（推荐：VSCode/PhpStorm）
开启项目全局查找替换，使用正则匹配，精准匹配下标大括号，不误伤其他代码：
- 查找内容：
\{(\d+)\} - 替换内容：
[$1]
作用：仅匹配 {数字} 格式的下标，精准替换为方括号，安全无副作用。
2、Linux 服务器一键批量替换（适合线上项目）
进入项目根目录，执行以下命令，递归替换所有 PHP 文件的错误语法：
find ./ -name "*.php" -exec sed -i 's/\([$a-zA-Z0-9_]\){\([0-9]*\)}/\1[\2]/g' {} \;执行完成后，所有文件的大括号下标取值会全部批量修复。
五、临时应急方案（不推荐长期使用）
如果项目暂时没时间适配 PHP8，可临时降级 PHP 版本至 7.4，PHP7.x 完全兼容大括号下标语法。
注意：PHP7 已停止官方维护，存在安全漏洞，仅作为临时应急手段，长期建议统一改成方括号写法，适配新版 PHP。
六、总结
- 报错本质：
{}PHP8+ 废弃 数组/字符串下标取值语法，仅支持[]方括号； - 修复核心：全局将
$var{数字}替换为$var[数字]； - 避坑重点：逻辑代码块、变量解析的大括号无需修改；
- 最优方案：批量正则替换，适配 PHP8+，舍弃旧版兼容写法。
修复后项目可完美运行在 PHP8.0、PHP8.1、PHP8.2、PHP8.3 所有新版本环境中。
