PHP文件写入常用file_put_contents和fopen+fwrite，支持覆盖、追加及JSON数据存储；需注意权限、路径安全、错误处理、文件锁和资源释放。
在PHP开发中，文件写入是一个常见操作，比如记录日志、生成配置文件或保存用户上传的内容。正确使用文件写入方法不仅能提升程序稳定性，还能避免安全风险。下面介绍几种常用的PHP文件写入方式及使用时的注意事项。
使用 file_put_contents 写入文件
file_put_contents 是最简单高效的写入方法，能将字符串直接写入文件，若文件不存在会自动创建。
示例：
$filename = 'example.txt';
$content = "Hello, this is a test.\n";
file_put_contents($filename, $content);
如果要追加内容而不是覆盖，可传入 FILE_APPEND 标志：
file_put_contents($filename, $content, FILE_APPEND);
立即学习“PHP免费学习笔记（深入）”；
使用 fopen + fwrite 进行控制写入
当需要更精细控制文件操作（如锁定、分段写入）时，推荐使用 fopen 和 fwrite 配合。
$handle = fopen('example.txt', 'w'); // 'w' 覆盖写入，'a' 追加写入
if ($handle) {
fwrite($handle, "Line 1\n");
fwrite($handle, "Line 2\n");
fclose($handle);
}
注意打开模式的选择：
- 'w'：写入，清空原内容
- 'a'：追加，保留原内容
- 'x'：仅当文件不存在时创建并写入，避免误覆盖
写入 JSON 或数组数据的技巧
常需将数组写入文件（如配置文件），建议结合 json_encode 使用。
示例：
$data = ['name' => 'Alice', 'age' => 25];
$json_content = json_encode($data, JSON_PRETTY_PRINT);
file_put_contents('config.json', $json_content);
使用 JSON_PRETTY_PRINT 可提高可读性，便于后期维护。
文件写入的注意事项
实际开发中，忽略以下几点容易引发问题：
- 检查目录权限：确保PHP进程有写入目标目录的权限，否则会触发 warning 或失败。
- 避免路径注入：不要直接使用用户输入拼接文件路径，防止恶意写入系统文件。
- 处理写入失败：file_put_contents 失败时返回 false，应做错误判断。
- 及时关闭文件句柄：使用 fopen 后务必 fclose，避免资源泄漏。
- 考虑并发写入：高并发场景下，多个进程同时写同一文件可能导致数据错乱，可使用 flock 加锁。
基本上就这些。掌握好写入方法和防护措施，能让PHP文件操作更安全可靠。
