PHP parse_ini_file 读取环境配置怎么避免类型漂移：常量、引号与 INI_SCANNER_TYPED

PHP 项目把连接地址、重试次数和开关放进 INI 文件后，最容易被忽略的不是文件路径，而是读取结果的类型。feature_enabled = on 在默认模式下会变成字符串 '1'，retry_count = 3 也可能仍是字符串；业务层如果直接做严格比较，配置看着正确，分支却不会按预期执行。

先复现类型漂移：同一个值为什么有三种表现

示例只准备一份 config.ini，然后让 parse_ini_file($path, true, $mode) 依次使用三种扫描模式。这样比较的是扫描器的差异，不是三份手工改过的配置。

feature_enabled = on
retry_count = 3
empty_value = null
quoted_on = "on"

[database]
port = 3306
host = "db.internal"

真实运行结果显示：NORMAL 把未加引号的 on、数字和 null 按普通 INI 规则处理；RAW 保留值的字符串形态；TYPED 则把开关、数字和 null 分别变成 bool、int 和 null。加了引号的 quoted_on 在 TYPED 下仍然是字符串，这是区分“配置语义”和“字面文本”的关键。

把 scanner_mode 选成明确的配置契约

如果配置属于应用自己的受控文件，TYPED 通常更容易让开关、数量和空值进入业务代码；如果配置文件可能被用户上传或来自外部系统，RAW 更安全，解析结果要通过键名白名单、类型转换和范围校验后才能使用。PHP 手册特别提醒，非 RAW 模式可能展开保存敏感值的常量，因此不能把不可信 INI 直接交给默认扫描器。

用同一段 PHP 代码核对 section 和类型

$path = __DIR__ . '/config.ini';

foreach ([
    'NORMAL' => INI_SCANNER_NORMAL,
    'RAW' => INI_SCANNER_RAW,
    'TYPED' => INI_SCANNER_TYPED,
] as $label => $mode) {
    $config = parse_ini_file($path, true, $mode);
    echo "[$label]", PHP_EOL;
    echo get_debug_type($config['feature_enabled']), PHP_EOL;
    echo get_debug_type($config['retry_count']), PHP_EOL;
    echo get_debug_type($config['empty_value']), PHP_EOL;
    echo get_debug_type($config['database']['port']), PHP_EOL;
}

第二张图把配置文件的 [database] 段和同一次运行的输出放在一起。验收时看三件事：section 是否变成嵌套数组、TYPED 的端口是否为整数、带引号的值是否仍保持字符串。只看 var_dump 的值而不看类型，容易漏掉这个问题。

生产读取前补上三层校验

1. 文件层：使用绝对路径，检查 parse_ini_file 返回值是否为 false，并把缺失文件与语法错误单独记录。
2. 类型层：按键名检查 is_bool、is_int 或 is_string，不要用宽松比较掩盖扫描模式的差异。
3. 业务层：对重试次数设置非负范围，对端口设置 1 到 65535，对开关只接受明确的布尔值，并拒绝未知键。

一个实用做法是读取后立即映射成应用配置对象，而不是让整个数组在项目各处流动。这样 retry_count 的默认值、database.port 的范围和 feature_enabled 的分支规则都集中在一个入口，修改扫描模式时也只需要回归这一层。

常见问题

INI_SCANNER_TYPED 会把所有数字都变成整数吗？

会尽可能把可转换的数字字符串转成整数，但业务仍应检查范围；带引号的值和无法安全转换的内容应按实际类型验收。

为什么 NORMAL 的 on 不是 bool true？

普通扫描遵循 PHP INI 的兼容语义，未加引号的 on 会变成字符串 '1'；需要布尔类型时使用 TYPED 并保留类型校验。

RAW 是否适合所有外部配置？

不代表读取后就安全。RAW 只是不解析值，仍要限制允许的键、转换类型、检查范围，并拒绝不认识的字段。

process_sections 设置为 true 有什么影响？

它会把 [database] 等 section 组织成嵌套数组；代码访问路径也要从 $config['port'] 改为 $config['database']['port']。

把配置读取结果当成契约验收

parse_ini_file 的重点不是记住某个模式名称，而是先决定配置值要保留字面文本，还是要在读取阶段获得明确类型。受控应用配置可用 TYPED 缩短转换路径；外部输入则先用 RAW，再经过白名单和范围校验。只要把模式、section、返回值和关键类型写进回归检查，配置文件就不会再靠“看起来像数字”来工作。