PHP配置更新必须读取→修改→写入三步完成，需处理格式、转义、权限和并发；str_replace仅适用于无结构纯文本，INI用parse_ini_file+自定义write_ini_file，JSON必须json_decode/json_encode，生产环境推荐原子切换+重载。
PHP 无法直接“安全替换配置文件内容”，必须靠读取 → 修改 → 写入三步完成，且需手动处理格式、转义、权限和并发问题。
用 file_get_contents + str_replace 替换简单键值对？小心失效
这种写法只适用于纯文本、无结构、无重复键的配置（比如单行 DEBUG=true）。一旦配置含注释、空行、多值或 JSON/YAML 格式，str_replace 会误匹配或破坏结构。
- 若配置里有
DB_HOST=127.0.0.1和DB_HOST_BACKUP=192.168.0.1，str_replace('DB_HOST', 'DB_HOST=10.0.0.1', $content)会把两个都改掉 - 没做
htmlspecialchars或addcslashes处理用户输入时，特殊字符（如/、$、\）会导致正则或字符串操作出错 - 不检查
file_get_contents是否返回false（文件不存在/权限不足），后续操作直接报错
处理 INI 配置：优先用 parse_ini_file + write_ini_file（需自定义）
PHP 原生能读 .ini（parse_ini_file），但不提供写入函数。必须自己实现 write_ini_file 来保持格式（保留注释、分组、空行难，建议只写无注释的扁平配置）。
- 读取时加
INI_SCANNER_RAW参数，避免自动解析%、${}引发意外变量展开 - 写入前用
is_writable检查目标文件或目录权限，否则file_put_contents静默失败 - 写入应使用原子操作：
file_put_contents($tmp, $new_content) && rename($tmp, $ini_path)，防止写到一半被中断导致配置损坏
更新 JSON 配置：必须用 json_decode / json_encode，不能字符串替换
JSON 是结构化数据，任何手写字符串拼接都可能破坏引号、转义或嵌套层级。必须走标准编解码流程。
立即学习“PHP免费学习笔记（深入）”；
- 读取后检查
json_last_error()—— 常见错误如配置末尾多逗号、中文未 UTF-8 编码、BOM 头，都会让json_decode返回null -
json_encode要加JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT，否则中文变\uXXXX，缩进丢失，人工维护困难 - 修改嵌套字段时，别直接
$cfg['db']['host'] = $new_host，先确保$cfg['db']是数组：isset($cfg['db']) || $cfg['db'] = [];
生产环境更新配置最稳的方式：生成新文件 + 原子切换 + reload
直接改线上配置文件风险极高，尤其 Nginx/PHP-FPM 进程可能正在读取中。更可靠的是生成新配置，再通过符号链接或进程信号切换。
- 例如 PHP-FPM 场景：生成
www.conf.new→mv www.conf.new www.conf（覆盖是原子的）→ 发送kill -USR2 $(cat /var/run/php-fpm.pid)重载 - Web 应用自身配置：写入
config.php.local（被 git 忽略），主配置文件用require_once 'config.php.local' ?? []合并，避免改源码 - 所有写操作必须记录日志：
file_put_contents('config_update.log', date('c') . " update {$key} to {$val}\n", FILE_APPEND);
真正麻烦的从来不是“怎么替换”，而是“怎么保证替换后还能跑、别人改了也不冲突、回滚有依据”。配置更新本质是变更管理，不是字符串操作。
