本文详解如何将形如 "key1,key2,value" 的 CSV 字符串解析为多层嵌套的 PHP 关联数组，支持任意深度路径拆分、动态键构建，并兼容后续 array_merge_recursive() 合并与 JSON 序列化。
本文详解如何将形如 `"key1,key2,value"` 的 csv 字符串解析为多层嵌套的 php 关联数组，支持任意深度路径拆分、动态键构建，并兼容后续 `array_merge_recursive()` 合并与 json 序列化。
在处理配置导入、CSV 数据映射或 API 响应标准化等场景中，常会接收到以逗号分隔的“路径-值”字符串（例如 "user,profile,email,user@example.com"），需将其自动构造成结构清晰的嵌套数组。核心挑战在于：将字符串中的前 N−1 项视为嵌套键路径，最后一项作为叶子节点值，并确保多条路径能自然合并为统一结构。
以下是最简洁、健壮且可扩展的实现方案：
✅ 基础两层路径处理（推荐初用）
适用于固定两层键 + 一层值（如 "name,firstname,Bob"）：
$strings = [
"name,firstname,Bob",
"name,lastname,Dylan",
"contact,phone,+1-555-0123"
];
$result = [];
foreach ($strings as $csv) {
$parts = str_getcsv($csv);
if (count($parts) Array ([firstname] => Bob, [lastname] => Dylan)
// [contact] => Array ([phone] => +1-555-0123)
// )
? 提示：str_getcsv() 比 explode(',', $csv) 更可靠，能正确处理带引号、转义逗号的 CSV 内容（如 "user,""O'Reilly"",email"）。
? 通用 N 层嵌套（支持任意深度路径）
当路径长度不固定（如 "settings,theme,colors,primary,#007bff"）时，需递归构建层级：
function csvToNestedArray(string $csv): array {
$parts = str_getcsv($csv);
if (count($parts) $key) {
if ($i === count($keys) - 1) {
$ref[$key] = $value;
} else {
if (!isset($ref[$key]) || !is_array($ref[$key])) {
$ref[$key] = [];
}
$ref = &$ref[$key];
}
}
return $nested;
}
// 使用示例
$strings = [
"user,profile,fullname,John Doe",
"user,profile,age,32",
"user,preferences,notifications,email"
];
$result = [];
foreach ($strings as $csv) {
$nested = csvToNestedArray($csv);
$result = array_merge_recursive($result, $nested);
}
echo json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
// 输出：
// {
// "user": {
// "profile": {
// "fullname": "John Doe",
// "age": "32"
// },
// "preferences": {
// "notifications": "email"
// }
// }
// }
⚠️ 关键注意事项
- 键名安全性：若输入来自不可信源，请对 $key 进行过滤（如 preg_replace('/[^a-zA-Z0-9_\-]/', '', $key)），防止非法字符引发意外行为。
- 类型一致性：array_merge_recursive() 对同名数字索引会追加，对同名字符串键会递归合并——这正是我们所需；但若值本身是数组，需确认业务逻辑是否允许深度合并。
- 空值/缺失值处理：建议在 str_getcsv() 后校验 $parts 长度，跳过无效行，避免 Undefined index 警告。
- 性能提示：对于海量数据（>10k 行），可考虑一次性 array_map() + array_reduce() 替代循环，但可读性略降。
✅ 后续整合：合并与序列化
完成所有字符串解析后，直接使用 array_merge_recursive() 合并即可生成最终结构体，再调用 json_encode() 输出标准 JSON：
$finalJson = json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
file_put_contents('output.json', $finalJson);
该方案兼顾简洁性、健壮性与扩展性，是处理“扁平路径字符串 → 嵌套配置结构”问题的标准实践。
