嵌套 foreach 中变量名必须带层级语义以防止覆盖：外层用 $order/$section_name，内层用 $line_item/$option_key；引用变量需 unset 或封装进独立作用域；配合静态分析与断言保障落地。
直接用相同变量名（如 $item、$key、$value）在多层 foreach 中嵌套，是引发逻辑穿透 Bug 的高频原因——外层变量被内层意外覆盖，导致后续判断错乱、数据写入错误、甚至跳过关键分支。规范命名不是“写得好看”，而是切断变量污染链的最有效防线。
变量名必须带层级语义，禁止泛化复用
外层和内层循环变量名需体现数据结构层级与业务含义，不能仅靠注释补救：
- ❌ 错误示范：
foreach ($orders as $item) {<br> foreach ($item['items'] as $item) { // 同名覆盖！$item 变成子项，原订单信息丢失<br> echo $item['sku'];<br> }<br>} - ✅ 正确做法：
foreach ($orders as $order) {<br> foreach ($order['line_items'] as $line_item) {<br> echo $line_item['sku'];<br> }<br>}
其中$order表示单笔订单，$line_item明确指向订单明细行，语义隔离清晰。
键名变量也要分层命名，避免 $key/$value 直接裸用
关联数组遍历时，$key 和 $value 是最易被重复覆盖的“幽灵变量”：
- ❌ 危险写法：
foreach ($config as $key => $value) {<br> foreach ($value as $key => $value) { // $key/$value 全部被重写，外层上下文彻底丢失<br> process($key, $value);<br> }<br>} - ✅ 推荐方式：
foreach ($config as $section_name => $section_data) {<br> foreach ($section_data as $option_key => $option_value) {<br> process($option_key, $option_value);<br> }<br>}
每个变量名自带“归属感”，一眼可知其来源层级和用途。
对引用变量执行强制解除，防止残留引用污染
若某层使用了引用（&$item），即使命名规范，未 unset 仍会导致下一次循环或后续代码中该变量持续绑定旧内存地址：
- 务必在引用循环结束后立即
unset($item)； - 更稳妥的做法：把引用操作封装进独立作用域（如函数或匿名函数），利用作用域自动清理；
- 检查日志或调试时发现“某个值总是等于上一轮最后一个元素”，大概率就是引用未释放。
静态分析+运行时断言双保险
命名规范需配合工具验证才能落地：
- 启用 PHPStan 或 Psalm，配置规则检测同作用域内重复变量声明；
- 在关键嵌套入口加断言：
assert(!isset($order_id), '外层$order_id 不应存在于内层作用域'); - CI 流程中加入 PHPCS 检查，拦截
$key => $value出现在嵌套第二层及以后的代码。
