parse_ini_file读取失败主因是路径或权限问题：默认在当前工作目录而非脚本目录查找，需用__DIR__拼接绝对路径；同时注意BOM头、文件可读性及open_basedir限制。
parse_ini_file 读取失败的常见原因
直接调用 parse_ini_file('config.ini') 却返回 false，大概率不是语法错，而是路径或权限问题。PHP 默认在当前工作目录（getcwd()）下找文件，不是脚本所在目录；如果用 CLI 运行，工作目录往往是终端打开的位置，和 __DIR__ 不一致。
- 务必用绝对路径：
parse_ini_file(__DIR__ . '/config.ini') - 检查文件是否可读：
is_readable()先判断，避免静默失败 - INI 文件开头有 BOM（尤其 Windows 编辑器保存时），会导致解析失败，用
file_get_contents检查前几个字节是否为\xEF\xBB\xBF - 默认不解析 section，若配置含
[database]，需显式传INI_SCANNER_TYPED或INI_SCANNER_NORMAL并设第二个参数为true
parse_ini_string 处理动态内容的注意事项
parse_ini_string 适合从数据库、API 或用户输入中加载配置片段，但它的解析行为和 parse_ini_file 完全一致——包括对引号、注释、转义的处理逻辑。容易忽略的是：它不自动处理换行符来源（\r\n vs \n），Windows 环境下从 textarea 提交的字符串若含 \r\n，可能被误判为非法字符。
- 统一换行：
str_replace("\r\n", "\n", $raw)再传入 - 若字符串含变量插值（如
host = ${DB_HOST}），PHP 原生不支持，得自己后置替换 - 错误不会抛异常，只返回
false；建议配合error_get_last()查看最后警告（如“syntax error”）
布尔值、null 和数字的类型陷阱
INI 解析默认把所有值当字符串，哪怕写的是 debug = true 或 timeout = 30。想让 true/false/on/off/yes/no 被识别为布尔，必须启用 INI_SCANNER_TYPED 标志；但要注意，这个标志对数字无效——port = 3306 仍是字符串 "3306"，不是整型。
- 安全做法：手动 cast，如
(int)$config['port']或filter_var($config['debug'], FILTER_VALIDATE_BOOLEAN) -
null在 INI 中无法直接表示，常用空值（log_file =）或占位符（log_file = null），需业务层约定并清理 - 浮点数会被截断：写
ratio = 0.75，启用INI_SCANNER_TYPED后是 float，但ratio = .75（缺整数位）会解析失败
section 嵌套与键名冲突的实际处理
INI 不支持真正嵌套（如 [db.primary]），但可通过点号命名模拟：db.host = localhost。此时若同时开启 section 解析（第二个参数为 true），结果是二维数组：['db' => ['host' => 'localhost']]；若关闭，则是一维扁平：['db.host' => 'localhost']。选哪种取决于你后续怎么用。
立即学习“PHP免费学习笔记（深入）”；
- 扁平结构适合简单场景，但键名易冲突（
host和db.host共存时覆盖） - section 结构更清晰，但访问需两层：
$config['database']['user']，且无法表达同名不同 section 的键（如[a] host=127.0.0.1和[b] host=192.168.1.1是合法的） - 没有原生方式合并多个 INI 文件，需用
array_replace_recursive手动合并数组
