用 explode() 拆分路径字符串时需注意转义点号,如 "config\.database.host" 应先预处理再切分;构建嵌套数组要检查并初始化层级,避免标量值被当数组访问;重复键需按业务选择覆盖或结构化存储。

用 explode() 拆分路径字符串时要注意分隔符转义
PHP 中常见需求是把类似 "user.profile.address.city" 这样的点号分隔字符串,转成嵌套数组:['user' => ['profile' => ['address' => ['city' => null]]]]。直接用 explode('.', $str) 没问题,但若原始字符串含转义点(如用于配置项 key:"config\.database.host"),就得先预处理。否则 explode() 会错误切开 config\.database 成两段。
实操建议:
- 若输入可控(如内部配置键),默认信任点号为分隔符,直接
explode('.', $key) - 若可能含转义(如用户输入或兼容旧格式),先用
stripcslashes()或正则替换掉\.为特殊占位符,再切分 - 避免用
split()(已废弃)或preg_split()无必要地引入 PCRE 开销
逐层构建嵌套数组时别直接赋值 $tree[$k] = []
常见写法是遍历 $parts = explode('.', $key),然后循环中写 $current = &$current[$part]。但如果某一层已存在值(比如之前已设 $tree['user'] = 'string'),再试图给 $tree['user']['profile'] 赋值就会报 Warning:Cannot use a scalar value as an array。
安全做法是检查并初始化:
立即学习“PHP免费学习笔记(深入)”;
- 每次进入下一层前,用
if (!isset($current[$part]) || !is_array($current[$part])) { $current[$part] = []; } - 或者更简洁地用空合并:
$current[$part] = $current[$part] ?? [];(PHP 7+) - 注意引用变量
&$current必须在循环内重新绑定,否则最后一层引用会滞留
处理重复键时需决定覆盖还是合并
如果多条路径共用前缀,例如 "a.b.c" 和 "a.b.d",正常构建不会冲突;但若出现 "a.b" 和 "a.b.c",就意味 a.b 既是叶子又是父级——PHP 数组不支持同 key 同时存字符串和数组。
典型现象是后写入的覆盖前值,导致树断裂。应对方式取决于业务:
- 强制结构优先:把
"a.b"视为路径而非终值,所有键都建为数组,终值用固定子键(如_value)存储 - 值优先:遇到已存在非数组值时,停止向下建树,或抛出异常提醒数据冲突
- 不校验直接覆盖(仅适用于确定无歧义的场景,如配置加载顺序明确)
用 array_replace_recursive() 合并多个路径树效率低且行为隐晦
有人想先为每条路径生成独立树,再用 array_replace_recursive() 合并。这看似方便,但有明显缺陷:
- 该函数对数字键和字符串键混合时行为不一致,容易误删数据
- 性能差:每条路径都建全量嵌套,再层层递归合并,时间复杂度远高于单次遍历构建
- 无法控制冲突策略(比如想保留第一个出现的值,它默认用后者)
- 推荐做法:统一用一个
&$tree引用,逐条解析路径并就地插入
"1st.level"),虽能存进数组,后续用 json_encode() 或传给 JS 时可能出问题。是否过滤/转义应由上层协议约定,不是建树逻辑该越界处理的。











