parse_ini_file()仅解析INI文件为数组，不修改原文件；PHP无内置写入函数，需手动拼接字符串并写回磁盘，否则配置不变。
PHP读取INI文件时为什么不能直接用parse_ini_file()修改？
parse_ini_file()只是解析器，返回数组后原文件完全不受影响。想改配置，得自己拼字符串再写回磁盘——PHP没提供“编辑INI”的内置函数，这是最常被误解的起点。
常见错误现象：改完数组值就结束，结果配置文件纹丝不动；或者手动拼接字符串时键名带空格、注释错位，导致下次parse_ini_file()解析失败。
- INI格式对空行、分号注释、等号前后空格敏感，手动生成容易出错
- 多段落（
[section]）结构下，顺序和段落边界必须严格保留 - 原始文件的BOM、换行符（
\r\nvs\n）最好保持一致，否则某些工具会报错
安全替换单个参数值的最小可行代码
不依赖第三方库，只用PHP原生函数，重点是“不破坏原有结构”：
$ini_path = '/path/to/config.ini'; $content = file_get_contents($ini_path); // 匹配 key = value（支持前后空格、忽略分号注释行） $pattern = '/^(\s*key_name\s*=\s*)([^;#]*)([;#]?.*)$/m'; $replacement = '$1new_value$3'; file_put_contents($ini_path, preg_replace($pattern, $replacement, $content));
使用场景：CI/CD中动态注入数据库密码、切换环境开关等一次性操作。
立即学习“PHP免费学习笔记（深入）”；
-
key_name要替换成真实键名，注意正则里不能有特殊字符，否则需preg_quote() - 正则末尾
m修饰符保证^$匹配每行开头结尾 - 保留
$3是为了不丢掉原行末尾的注释或分号 - 没加锁，高并发写同一INI文件时可能冲突，生产环境建议加
flock()
批量更新+保留注释和格式的稳健做法
如果要改多个参数，或必须保留原有注释、空行、段落顺序，硬正则容易翻车。推荐先解析再重建：
$ini = parse_ini_file($ini_path, true); // true表示保留section
$ini['database']['host'] = '192.168.1.100';
$ini['app']['debug'] = 'true';
// 手动重建内容（注意：不处理嵌套、不兼容=号在值里的场景）
$output = '';
foreach ($ini as $section => $values) {
if (is_string($section)) {
$output .= "[$section]\n";
}
foreach ($values as $k => $v) {
$output .= "$k = " . var_export($v, true) . "\n";
}
$output .= "\n";
}
file_put_contents($ini_path, $output);
性能影响：var_export()会给字符串加引号，数值变'1'，部分旧版PHP ini parser不认；布尔值变成true/false而非on/off，需按目标系统要求调整。
- 若原INI里有
key = value with space，var_export()会加单引号，但有些PHP版本或工具不支持带引号的值 - 段落顺序丢失：
parse_ini_file()返回数组不保证顺序，重建时得自己维护键顺序 - 空行、行首注释（
; comment）全部丢失，这类元信息无法从数组还原
真正需要保留所有格式时该选什么方案
当INI文件由运维统一管理、含大量人工注释、或被其他工具（如Ansible、systemd）读取时，正则和重建都不可靠。这时候应该：
- 用专门的INI操作库，比如
leafo/ini（Composer包），它逐行解析并保留所有空白和注释 - 或改用JSON/YAML替代INI——PHP原生支持更好，且现代部署工具对它们的编辑更友好
- 最务实的做法：把INI当只读配置源，运行时用
getenv()或环境变量覆盖关键项，避免写文件
容易被忽略的是权限问题：www-data用户可能没权限写入/etc/下的INI，报错failed to open stream: Permission denied，得提前检查is_writable()并给出明确提示。
