直接用 file_get_contents + file_put_contents 最简单,绝大多数场景下无需逐行处理;但文件过大(>100MB)会耗尽内存,此时应改用 file 或流式处理。

直接用 file_get_contents + file_put_contents 最简单
绝大多数场景下,不需要逐行读写或流式处理,直接一次性读取全部内容、修改后覆盖写入最稳妥。PHP 的 file_get_contents 和 file_put_contents 组合就是为此设计的。
注意点:
-
file_get_contents默认以二进制模式读取,能正确处理换行符和 UTF-8 BOM;但若文件极大(比如 >100MB),会吃光内存,此时不能用 -
file_put_contents第二个参数是字符串,别误传数组——否则写进去的是Array字符串字面量 - 写入前建议用
is_writable检查权限,否则静默失败
示例:把配置文件里的 debug = off 改成 debug = on
$content = file_get_contents('/path/to/config.ini');
$content = str_replace('debug = off', 'debug = on', $content);
file_put_contents('/path/to/config.ini', $content);
需要按行替换?用 file 读成数组再 foreach
当要基于行号、正则匹配某一行、或只改特定段落时,file 函数比手动 fopen/fgets 更简洁,它自动按换行符分割并保留换行符(取决于 FILE_IGNORE_NEW_LINES 标志)。
立即学习“PHP免费学习笔记(深入)”;
常见陷阱:
-
file默认不保留行尾换行符,如果后续要拼接写回,得自己补\n或用FILE_IGNORE_NEW_LINES配合implode("\n", $lines) - Windows 和 Linux 换行符不同(
\r\nvs\n),用PHP_EOL写回更安全 - 空行或注释行容易被忽略,比如
;// debug这类行需用正则而非===判断
示例:把日志文件中所有 [ERROR] 替换成 [FATAL],仅限第 10–20 行
部分功能简介:商品收藏夹功能热门商品最新商品分级价格功能自选风格打印结算页面内部短信箱商品评论增加上一商品,下一商品功能增强商家提示功能友情链接用户在线统计用户来访统计用户来访信息用户积分功能广告设置用户组分类邮件系统后台实现更新用户数据系统图片设置模板管理CSS风格管理申诉内容过滤功能用户注册过滤特征字符IP库管理及来访限制及管理压缩,恢复,备份数据库功能上传文件管理商品类别管理商品添加/修改/
$lines = file('/var/log/app.log', FILE_IGNORE_NEW_LINES);
for ($i = 9; $i <= 19 && $i < count($lines); $i++) {
$lines[$i] = str_replace('[ERROR]', '[FATAL]', $lines[$i]);
}
file_put_contents('/var/log/app.log', implode(PHP_EOL, $lines));
大文件或需原子性?必须用临时文件 + rename
直接 file_put_contents 覆盖写入不是原子操作:写到一半进程崩溃,原文件就毁了。生产环境修改关键文本(如数据库迁移脚本、系统配置)必须用“写临时文件 → rename 替换”流程。
关键细节:
- 临时文件必须和目标文件在同一个文件系统(同分区),否则
rename会失败并降级为复制+删除,失去原子性 - 临时文件名推荐用
tempnam(sys_get_temp_dir(), 'php_edit_'),避免竞态条件 - 写完临时文件后,务必用
chmod复制原文件权限,否则可能因权限丢失导致服务无法读取
示例:安全更新 JSON 配置
$target = '/etc/app/config.json';
$temp = tempnam(sys_get_temp_dir(), 'cfg_');
$content = json_encode($newConfig, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
if (file_put_contents($temp, $content) !== false) {
chmod($temp, fileperms($target)); // 保持权限一致
rename($temp, $target); // 原子替换
}
正则替换复杂结构?慎用 preg_replace 直接作用于全文
对 INI、JSON、XML 等有嵌套/引号/转义的格式,直接 preg_replace 容易出错。比如改 JSON 的某个字段值,正则很难区分字符串内的相同关键词和真实键名。
更可靠的做法:
- INI 文件:用
parse_ini_file读取 → 修改数组 → 用自定义函数写回(别依赖ini_set) - JSON 文件:必须用
json_decode→ 修改 →json_encode,否则破坏格式或编码 - 纯文本含结构化片段(如 Markdown 中的 YAML front matter):先用正则切出目标块,再对那块做
json_decode或parse_ini_string
反例(危险):preg_replace('/"version":\s*"\d+\.\d+\.\d+"/', '"version": "2.0.0"', $json) —— 若 JSON 字符串里有 "version": "1.2.3" 就会被误改
flock)在 Web 场景中常被高估:Apache/FPM 下多个请求并发写同一文件时,flock 只在单个进程内有效,且 PHP 的 flock 在 NFS 或某些容器挂载上不可靠。真正需要强一致性时,应靠应用层队列或数据库事务控制,而不是指望文件锁。










