PHP动态构建含变量的多维数组触发语法报错问题求解

问题背景 #

需要在PHP中构建部分元素值、键名包含动态变量的数组，运行代码时PHP持续在if语句的闭合花括号位置抛出语法错误，原始实现代码如下：

$myArr = array();
$i = 1;
$n = 5;
for($i = 1; $i <= $n; $i++) {
  if($i === 1){
      $myArr["k$i"] = array(
          'description' => 'Some special text for the k1 element',
          'type' => 'some type',
          'foo' => 'bar',
      )
  }else{
      $myArr["k$i"] = array(
          'description' => 'This is the number ' . $i . ' element description.'
          'type' => 'some type',
          'foo' => 'bar',
      )
  }
}
return $myArr;

预期生成的数组结构如下：

$myArr = [
  'k1' => [
    'description' => 'Some special text for the k1 element',
    'type' => 'some type',
    'foo' => 'bar',
  ],
  'k2' => [
    'description' => 'This is the number 2 element description.',
    'type' => 'some type',
    'foo' => 'bar',
  ],
  // k3到k5的结构与k2一致
];

错误原因 #

这类报错位置偏移到花括号的问题是PHP语法解析的典型表现：解析器顺序扫描代码时，若前方缺失必要的语法分隔符，不会立刻触发错误，而是持续向后查找合法的语法结束标记，最终报错位置往往和实际出错点存在偏差。这段代码共存在2处语法遗漏：

• if分支的数组赋值语句末尾缺失分号;：$myArr["k$i"] = array(...)是完整的赋值语句，必须以分号标记语句结束
• else分支中description键值对的末尾缺失数组元素分隔符逗号,：PHP数组中相邻键值对必须用逗号分隔，缺失后解析器会将下一行的'type'识别为上一个字符串的未闭合内容，最终触发语法错误

额外注意：预期结构中写的裸键名k1/k2在实际代码中需要用引号包裹，否则会被PHP识别为未定义常量，抛出运行时警告。 #

修复后可直接运行的代码 #

$myArr = array();
$n = 5;
for($i = 1; $i <= $n; $i++) {
  if($i === 1){
      $myArr["k$i"] = array(
          'description' => 'Some special text for the k1 element',
          'type' => 'some type',
          'foo' => 'bar',
      ); // 补全赋值语句结尾分号
  }else{
      $myArr["k$i"] = array(
          'description' => 'This is the number ' . $i . ' element description.', // 补全数组元素分隔逗号
          'type' => 'some type',
          'foo' => 'bar',
      ); // 补全赋值语句结尾分号
  }
}
return $myArr;

PHP数组内使用变量的参考说明 #

PHP数组语法对变量的支持非常灵活，不需要额外特殊转义，常用合法写法包括：

• 双引号包裹的字符串键名中可以直接解析简单变量，例如代码中的"k$i"会自动替换为当前循环下k1/k2等对应键名
• 数组值位置可以直接使用任意合法PHP表达式，包括变量、字符串拼接、函数返回值等，示例中'This is the number ' . $i . ' element description.'的拼接写法完全符合语法规范
• 如果需要在字符串中嵌入复杂变量（例如数组元素、对象属性），可以用花括号包裹变量明确解析优先级，例如"key_{$user['id']}"

内容的提问来源于stack exchange，提问作者Robert West