本文介绍一种简洁、健壮的递归方法，将任意深度的 PHP 关联多维数组转换为扁平化的键路径列表，使用下划线 _ 连接各级键名（如 aaa_email_main），适用于配置解析、模板变量映射等场景。
本文介绍一种简洁、健壮的递归方法，将任意深度的 php 关联多维数组转换为扁平化的键路径列表，使用下划线 `_` 连接各级键名（如 `aaa_email_main`），适用于配置解析、模板变量映射等场景。
在处理如 INI 配置、YAML 解析或嵌套 JSON 转换后的 PHP 数组时，常需将多维结构“展平”为带路径标识的键名集合。例如，从 $ini_config['bbb']['phone']['local'] 提取出字符串 'bbb_phone_local'，便于后续生成环境变量、构建表单字段名或做键值校验。
推荐使用纯函数式递归方案，避免全局变量和副作用，确保可预测性与可测试性。核心函数 keyPaths() 接收数组、当前路径前缀和分隔符，逐层遍历并累积结果：
function keyPaths(array $array, array $carry = [], string $separator = ''): array {
foreach ($array as $key => $value) {
if (is_array($value)) {
// 递归进入子数组，更新路径前缀：当前键 + 分隔符
$carry = keyPaths($value, $carry, $separator . $key . '_');
} else {
// 叶子节点：拼接完整路径并加入结果
$carry[] = $separator . $key;
}
}
return $carry;
}
// 示例数据
$ini_config['aaa']['email']['main'] = '<a href="mailto:test@example.com">[email protected]</a>';
$ini_config['bbb']['email']['ccc'] = '[email protected]';
$ini_config['bbb']['phone']['local'] = '800-555-1212';
$ini_config['bbb']['phone']['skype'] = '744-222-1234';
$ini_config['ccc']['phone']['main'] = 'domain.com';
$ini_config['ccc']['domain']['https'] = 'https://www.domain.com';
$ini_config['ccc']['fax'] = '744-222-1237';
// 调用获取全部键路径
$result = keyPaths($ini_config);
print_r($result);
输出结果为：
Array
(
[0] => aaa_email_main
[1] => bbb_email_ccc
[2] => bbb_phone_local
[3] => bbb_phone_skype
[4] => ccc_phone_main
[5] => ccc_domain_https
[6] => ccc_fax
)
✅ 关键优势说明：
- 无全局状态：不依赖 global 或静态变量，避免并发或重复调用时的污染风险；
- 深度无关：支持 1–4 层甚至更深的嵌套（题设要求），自动适配；
- 类型安全：函数签名明确限定参数类型（array），PHP 7.4+ 启用严格模式时更可靠；
- 可扩展性强：如需改为点号分隔（aaa.email.main），仅需修改 $separator . $key . '_' 中的 '_' 即可；若需同时返回键对应值，可将 $carry[] = [...] 改为 $carry[] = ['path' => ..., 'value' => $value]。
⚠️ 注意事项：
- 该函数仅处理关联数组（字符串键），不适用于数字索引数组（如 [0 => [...]]）——若存在混合键，建议预先 array_filter($array, 'is_string', ARRAY_FILTER_KEYS) 清洗；
- 若数组含循环引用，会触发无限递归，生产环境应增加引用检测（如 spl_object_hash() 辅助判重）；
- 对超大数组（>10k 键），考虑迭代替代递归以规避栈溢出，但本例典型配置场景无需担忧。
综上，keyPaths() 是兼顾简洁性、健壮性与可维护性的标准解法，可直接集成至配置管理类或 CLI 工具中，作为多维数组元信息提取的基础能力。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
