不是必须用 array_walk_recursive,因其会丢失节信息;需手动遍历保留节名与层级,注意键名清洗、换行规范及 parse_ini_file(true) 读取嵌套。

PHP嵌套数组转INI:必须用 array_walk_recursive 吗?
不是必须,但直接用它会丢节(section)信息。INI 文件的节名(如 [database])在嵌套数组里通常对应一级键,而 array_walk_recursive 会扁平化所有层级,无法还原结构。真正要保留节和子键层级,得手动遍历,不能偷懒。
常见错误是把 ['db' => ['host' => '127.0.0.1']] 传给 array_walk_recursive,结果写出来变成 host = "127.0.0.1",完全丢失 [db] 节。
- 一级键视为节名(除非值不是数组,此时应跳过或报错)
- 二级及以下键按点号拼接(如
db.host),或保持缩进层级(需手动控制) - 空数组、
null值建议跳过,INI 不支持原生空节或空值语义
写入时如何正确处理节名和键名中的特殊字符
INI 节名和键名本身不支持方括号、等号、分号、空格等字符,但 PHP 数组键可以含这些。如果原始数组键是 "user.name" 或 "cache ttl",直接写入会导致解析失败或行为异常。
稳妥做法是:对节名和键名做最小化清洗,只保留字母、数字、下划线、连字符;遇到非法字符统一替换为下划线,或抛出警告。不要自动加引号——INI 标准不承认键名引号("user.name" = value 是无效语法)。
立即学习“PHP免费学习笔记(深入)”;
- 节名过滤示例:
preg_replace('/[^a-zA-Z0-9_-]/', '_', $section) - 键名同理,且需避免以数字开头(如
123host→_123host) - 若业务强依赖原始键名(如含点号的配置项),应改用 JSON/YAML,而非硬塞进INI
parse_ini_file 读不出嵌套?那是你没用对参数
PHP 原生 parse_ini_file 默认 flat 模式,即所有键展平,不保留节结构。想读回嵌套数组,必须显式传 INI_SCANNER_TYPED + INI_SCANNER_NORMAL 不够,关键是要加 true 第二个参数:
parse_ini_file('config.ini', true)
这个 true 表示“启用节模式”,返回形如 ['database' => ['host' => 'localhost']] 的二维数组。但注意:它仍不支持三层及以上嵌套(如 database.redis.host),这种需要自己后处理或换格式。
- 写入时若用了点号拼接(如
redis.host = "127.0.0.1"),parse_ini_file(..., true)会把它当字面键名,不会自动拆成三维数组 - 若需深度嵌套 round-trip,别用 INI —— 它本质是二维键值容器
- 布尔值写入建议用
1/0或on/off,避免true/false字符串被误判为字符串
手写 INI 写入函数:绕不开的换行与空行规范
PHP 没有内置“数组 → INI”函数,必须手写。最容易被忽略的是换行符和空行逻辑:Windows 用 \r\n,Linux/macOS 用 \n,而 file_put_contents 默认用系统默认,一般没问题;但节之间必须空一行,否则某些解析器(如老版本 Zend_Config_Ini)会合并节。
还有注释问题:INI 支持分号 ; 和井号 # 开头的行注释,但不能出现在键值行末尾(host = localhost ; comment 是非标准扩展,部分解析器不认)。
- 每节前加空行(首节除外)
-
键值对用
=连接,左右不强制空格,但建议左侧无空格、右侧一个空格(host = localhost) - 字符串值含空格或特殊字符时,需用双引号包裹(
path = "/var/log/app"),且内部双引号要转义为\" - 写完务必用
parse_ini_file($file, true)反向验证是否可读,否则可能白写
return [...];)。











