PHP 怎样读取配置并保留常量类型

PHP 项目读取自己的 INI 配置文件时，如果直接使用默认模式，true、null 和数字可能会变成字符串，后续判断就容易出现“看起来一样、类型却不同”的问题。我的做法是把配置按节读取，并显式使用 INI_SCANNER_TYPED：它会尽可能保留布尔、null 和整数类型，同时让配置结构保持清楚。

官方地址：https://www.php.net/manual/en/function.parse-ini-file.php

• process_sections=true 会把 [app]、[cache] 这样的节保留成多维数组。
• INI_SCANNER_TYPED 会把常见布尔词、null 和可转换的数字字符串还原为对应类型。
• 配置文件属于敏感输入，不能放在公开文档根目录，也不要把读取失败和合法的 false 值混为一谈。

先把自有配置文件和 php.ini 分开

parse_ini_file() 适合读取应用自己的配置文件。正在运行的 PHP 已经处理过 php.ini，不要把这个函数当成“重新读取运行时配置”的入口。配置文件路径也建议使用明确的绝对路径，避免工作目录变化后读到错误文件。

; app.ini 是应用自己的配置文件
[app]
debug = false
name = "订单服务"
retry = 3
empty_value = null

[cache]
enabled = true
ttl = 60

这个例子中的 false、true、3、60 和 null 都是希望在 PHP 数组里保留语义的值；带引号的名称仍然是字符串。

PHP 配置为什么会读成预期类型

读取时把第二个参数设为 true，把第三个参数设为 INI_SCANNER_TYPED。这样返回值既保留节层级，也会在可能的情况下保留值类型。下面的示例只使用项目配置，不修改全局 PHP 配置。

这里需要特别注意：false 是一次成功读取到的布尔值，不等于函数返回的失败信号。函数失败时返回的是 false，所以判断函数结果要放在读取调用之后，并使用 $config === false。拿到数组后，再对每个业务键做类型检查。

TYPED、NORMAL 和 RAW 怎样选择

INI_SCANNER_TYPED 并不是“所有内容都变成 PHP 类型”。它只在 PHP 能确定语义时转换：true、on、yes 会变成 true；false、off、no、none 会变成 false；null 会变成 null；数字字符串在可行时会变成整数。其他文本仍然是字符串。

官方文档提醒，不要用普通模式解析不可信输入，因为结果可能包含敏感常量的值。边界不清楚时，优先使用 INI_SCANNER_RAW，再在应用层按允许的字段白名单转换。对于自己的发布包，INI_SCANNER_TYPED 更适合表达明确的开关、超时和数量配置。

常量替换和失败回退要单独处理

INI 值可以引用已经定义的 PHP 常量，但只有当值本身就是常量表达式时才会被识别；这和把任意字符串自动转换成业务对象是两回事。密钥、连接串等敏感内容不应通过公开可访问的配置文件提供，也不要把完整配置数组直接写入日志。

 ['env' => APP_ENV]];
}

// 业务层只取允许的字段，避免把整个配置对象传播到日志或响应
$environment = $config['app']['env'] ?? APP_ENV;
echo $environment, PHP_EOL;
?>

生产代码还应把 .ini 文件放在文档根目录之外，或在 Web 服务器层禁止直接访问。类型保留解决的是应用读取后的判断问题，不会替你完成密钥管理、权限隔离和字段校验。

常见问题

为什么设置了 INI_SCANNER_TYPED 仍有字符串？

这个模式只会在规则允许且类型可确定时转换。普通文本、带引号的文本和无法安全解释的内容仍然保持字符串，这是为了避免把业务文本误判成开关或数字。

process_sections 该不该一直设为 true？

如果配置文件使用了节，并且业务代码希望通过 $config['app']['debug'] 访问，就应设为 true。没有节的简单配置可以保持默认的扁平数组，关键是让读取结构和访问代码保持一致。

什么时候应该使用 INI_SCANNER_RAW？

当输入来自用户、外部上传或不完全可信的来源，或者你希望完全自己解释值时使用 RAW。它减少了 INI 解析带来的值替换，但应用层仍然要做白名单、长度和敏感字段处理。