PHP替换文件字符串需先读取再写回，用file_get_contents+str_replace+file_put_contents处理中小文件；大文件须流式处理并原子替换；注意编码、换行符、权限及错误恢复。
PHP 替换文件中的特定字符串，不能直接用 str_replace() 处理文件路径——它只操作字符串，不读写文件。 必须先读取内容、替换、再写回，否则什么都不会发生。
file_get_contents + str_replace + file_put_contents 是最简可行方案
这是处理中小文件（比如配置、模板、日志片段）最常用且安全的做法：
-
file_get_contents()把整个文件读成字符串，注意二进制安全（默认支持），但需检查返回值是否为false（文件不存在或无权限） -
str_replace()区分大小写，不支持正则；若要模式匹配，换用preg_replace() -
file_put_contents()默认覆盖原文件；加FILE_APPEND标志会追加，这不是你想要的
示例：
$path = '/path/to/config.php';
$content = file_get_contents($path);
if ($content === false) {
throw new RuntimeException("无法读取文件: $path");
}
$newContent = str_replace('old_value', 'new_value', $content);
if (file_put_contents($path, $newContent) === false) {
throw new RuntimeException("无法写入文件: $path");
}
大文件别一次性读进内存：用 stream_filter_register 或逐行处理
几百 MB 的日志或数据文件，file_get_contents() 会触发 memory_limit 错误，甚至 OOM。必须流式处理：
立即学习“PHP免费学习笔记（深入）”；
- 用
fopen()打开源文件和临时文件，fgets()逐行读，fwrite()逐行写 - 替换后先写到
.tmp文件，再用rename()原子替换原文件（避免中间状态损坏） - 不要用
file()（读成数组）或file_get_contents()处理 >10MB 的文件
注意编码和换行符，尤其是 Windows 和 Linux 混合环境
PHP 默认按字节操作，不自动识别编码。如果文件是 GBK 或 UTF-8 BOM，str_replace() 可能因 BOM 字节或多字节字符截断而失效：
- 用
mb_detect_encoding()粗略判断，但更可靠的是明确指定编码（如从外部约定） - 替换前可用
mb_convert_encoding($content, 'UTF-8', 'auto')统一转码（注意损失风险） - Windows 下的
\r\n在某些编辑器里显示异常，替换时若涉及换行，建议用str_replace(["\r\n", "\n", "\r"], "\n", $content)先归一化
权限、原子性与错误恢复常被忽略
生产环境改配置文件，出错就可能服务中断：
- 写入前检查目标目录是否可写：
is_writable(dirname($path)) - 永远先写临时文件，再
rename()替换，避免替换中途失败导致文件为空 - 必要时备份原文件（如加时间戳后缀），但注意磁盘空间和清理策略
-
file_put_contents()返回写入字节数，不等于strlen($newContent)时说明写入不完整（如磁盘满、中断）
真正难的不是“怎么替换”，而是“替换时不破坏文件、不丢数据、不卡死进程”。尤其在无人值守脚本或部署流程中，漏掉权限或原子性，半夜就会收告警。
