parse_ini_file() 默认将所有值转为字符串且覆盖重复键;启用 ini_scanner_typed(php 7.0+)可自动类型转换,否则需手动强制转换;重复键须用分段或自定义解析;文件不存在或权限/ open_basedir 限制会导致静默失败。

PHP 读取 INI 文件不用写解析器,parse_ini_file() 直接搞定,但默认行为会丢掉重复键、忽略注释、把数字当字符串——这些不注意就踩坑。
为什么 parse_ini_file() 读出来的值全是字符串?
INI 文件本身没类型概念,PHP 默认把所有值都转成 string,哪怕你写了 port = 8080 或 debug = true,读出来也是 "8080" 和 "true"。
- 加第二个参数
true启用INI_SCANNER_TYPED才能自动转 bool/int/float(PHP 7.0+) - 老版本 PHP 只能手动 cast:
(int)$config['port']、filter_var($config['debug'], FILTER_VALIDATE_BOOLEAN) - 空字符串
host = ""会被转成"",不是null;注释行或空行不影响,但带空格的键名如host = localhost会导致键名变成" host "(前后空格保留)
重复的 key 怎么办?比如多个 extension 条目
默认模式下,后面出现的同名 key 会直接覆盖前面的,extension = mysqli 和 extension = pdo_mysql 最后只剩一个。
- 用
parse_ini_file($file, false, INI_SCANNER_RAW)不行,还是覆盖 - 必须开启“sections”:把配置写成段落形式,例如
[ext_1]和[ext_2],再用parse_ini_file($file, true) - 更实际的做法是改用自定义解析:用
file()逐行读 + 正则匹配^\s*(\w+)\s*=\s*(.*)$,遇到重复 key 就 push 到数组里
parse_ini_file() 找不到文件或返回 false 怎么排错?
它不报 warning,只静默返回 false,容易误判为“配置为空”。常见原因不是路径错,而是权限或 open_basedir 限制。
立即学习“PHP免费学习笔记(深入)”;
- 先确认文件存在且可读:
is_readable($path) && file_exists($path) - 检查路径是否相对:脚本工作目录 ≠ 当前文件目录,推荐用
__DIR__ . '/config.ini' - 如果启用了
open_basedir,而$path超出范围,parse_ini_file()直接失败,不会提示具体原因 - 错误信息
Warning: parse_ini_file(): Unable to open...说明文件不可达;没 warning 却返回false,大概率是 open_basedir 或 SELinux 拦截
真正麻烦的是嵌套结构和环境变量替换——parse_ini_file() 完全不支持。想用 host = ${DB_HOST} 或多层 database.host,就得换 symfony/yaml 或手写解析逻辑。别指望一个函数包打天下。











