直接用 file_put_contents() 覆盖写入最简单，其默认行为即清空原文件并写入新内容；误用 FILE_APPEND 会导致追加，需检查返回值、注意原子性、内存占用、目录权限、路径安全及备份策略。
直接用 file_put_contents() 覆盖写入最简单
PHP 没有“替换整个文件内容”的独立函数，本质就是「清空原文件 + 写入新内容」，file_put_contents() 默认行为就是覆盖写入，无需额外配置。
常见错误是误用 FILE_APPEND 标志导致追加而非覆盖；或者没检查返回值，写入失败却以为成功。
- 直接传入字符串内容和文件路径即可：
file_put_contents('config.php', ' "prod"]; ?>'); - 写入失败会返回
false，建议判断：if (file_put_contents($path, $content) === false) { /* 处理错误 */ } - 若需确保原子性（避免写到一半崩溃留下脏数据），可先写入临时文件，再用
rename()替换原文件
写入大文件时注意内存和权限问题
用 file_put_contents() 一次性写入几 MB 以上内容，会把整个字符串加载进内存；同时目标目录必须对 Web 进程（如 www-data、apache）有写权限，否则静默失败或报 failed to open stream: Permission denied。
- 大文件建议分块处理，或改用
fopen()+fwrite()流式写入 - 检查目录权限：
is_writable(dirname($path))应为true - Windows 下注意路径分隔符，用
realpath()或dirname(__FILE__)拼接更安全
覆盖前想保留原文件？手动备份更可控
PHP 不提供内置的“覆盖并备份”功能，copy() + file_put_contents() 是最稳妥的组合。别依赖 file_put_contents() 的标志位——它没有备份选项。
立即学习“PHP免费学习笔记（深入）”；
- 先备份：
copy($path, $path . '.bak.' . date('Ymd-His')); - 再覆盖：
file_put_contents($path, $newContent); - 注意：如果原文件正在被其他进程读取（如 Web 服务器加载 config），备份+覆盖之间存在极短时间窗口，业务敏感场景需加锁或停服务
用 file_get_contents() + str_replace() 是误解
标题里“替换整个文件内容”容易让人联想到先读再改再写，但这不是“覆盖写入”的等价操作，而是「读取→内存中替换→写回」，多了一次 I/O 和内存拷贝，且容易出错。
-
str_replace()针对的是字符串内容，不是文件结构；若想替换某几行或正则匹配内容，才需要先file_get_contents() - 全量覆盖场景下，直接
file_put_contents()更快、更安全、更省内存 - 误用示例：
file_put_contents($f, str_replace('old', 'new', file_get_contents($f)))—— 这会把文件当模板反复读写，且无法处理二进制内容
真正要注意的是：覆盖写入是否在多进程/多线程环境下安全，以及写入后是否要触发其他动作（如 opcache 清理、配置重载）。这些不在 PHP 文件函数职责范围内，得靠外部协调。
