parse_ini_file 默认不解析方括号数组语法（如 hosts[] = "127.0.0.1"），需手动后处理或改用重复键名；推荐 nelexa/ini 库或手写解析器，复杂配置建议换 YAML 或 PHP 数组。
parse_ini_file 读不到数组值？默认不支持
PHP 的 parse_ini_file 默认把形如 hosts[] = "127.0.0.1" 的写法当普通字符串处理，不会自动转成数组——这是最常踩的坑。它只在启用 process_sections 且配合 scanner_mode 参数时才有限支持数组语法，但依然不原生解析方括号数组。
- 想读取带
[]的配置，得手动后处理：先用parse_ini_file($file, true)按 section 分组，再遍历每个 section，对键名含[]的项做正则提取和数组合并 - 更稳妥的做法是改用 INI 格式约定：用重复键名 +
process_sections = false，比如写成host = "127.0.0.1"\nhost = "192.168.1.1"，此时parse_ini_file会自动合并为数组（PHP 5.6.1+） - 旧版 PHP（
中文路径或 BOM 头导致 file_get_contents 失败
parse_ini_file 底层调用 file_get_contents，如果 INI 文件路径含中文（尤其 Windows 下）、或文件开头有 UTF-8 BOM，会导致读取失败并静默返回 false，错误提示里只显示“failed to open stream”，不提 BOM 或编码问题。
- 检查文件是否带 BOM：用
hexdump -C config.ini | head -n1，看到ef bb bf就是 BOM，用sed -i '1s/^\xEF\xBB\xBF//' config.ini去掉 - 路径含中文时，确保 PHP 运行环境的 locale 支持该编码（Linux 下常见是
LANG=C导致路径解析失败），临时解决可先realpath()或用iconv()转路径编码 - 更省事：把 INI 文件放纯英文路径下，避免编码纠缠
strict_types=1 下 parse_ini_file 返回类型不匹配
开启严格类型后，parse_ini_file 返回 array|false，但很多人直接当数组用，没判空就进 foreach，立刻报 Fatal error: Uncaught TypeError: foreach() argument must be of type array。
- 必须显式判断：
$cfg = parse_ini_file($path); if ($cfg === false) { throw new RuntimeException("INI parse failed: " . error_get_last()['message']); } - 注意
parse_ini_file在解析失败时返回false，不是空数组，也不是抛异常 - 若配置为可选，建议封装一层默认值 fallback，比如
$cfg = $cfg ?: ['debug' => false];
替代方案：比 parse_ini_file 更稳的 ini 解析方式
原生 parse_ini_file 对注释、引号嵌套、跨行值支持弱，且无法自定义解析逻辑。真要靠得住，要么用社区成熟库，要么自己手写轻量解析器。
立即学习“PHP免费学习笔记（深入）”；
- 推荐
nelexa/iniComposer 包：支持 BOM、UTF-8、数组语法、多行值、保留注释，API 和原生接近 - 手写解析只需 20 行：用
file()逐行读，跳过;和#开头，用正则匹配^(\w+)\s*=\s*(.*)$，再用stripcslashes()处理引号和转义——比依赖函数更可控 - 别硬扛：如果配置里开始出现 JSON 片段或环境变量插值（如
url = "https://${HOST}/api"），直接换 YAML 或 PHP 数组配置，INI 不是万能的
INI 文件看着简单，但实际项目里最容易出问题的反而是加载那一刻——路径、编码、数组语法、错误处理，四个点漏一个，后面所有逻辑都跑偏。
