file_put_contents()用于将字符串写入文件，支持创建、覆盖、追加（FILE_APPEND）、加锁（LOCK_EX）及序列化数组写入；通过检查返回值和error_get_last()处理错误，注意路径与内容安全以防止漏洞。
file_put_contents()函数是 PHP 中一个非常方便的文件操作函数，它能以简单的方式将字符串写入文件。核心作用就是把数据塞进文件里，用起来非常直接。
直接输出解决方案即可：
file_put_contents()函数的基本用法：
<?php $file = 'my_file.txt'; $data = "Hello, world!\nThis is a new line."; // 将数据写入文件，如果文件不存在则创建，存在则覆盖 file_put_contents($file, $data); echo "Data written to file successfully!"; ?>
上面这段代码会创建一个名为
my_file.txt的文件（如果不存在），然后把 "Hello, world!\nThis is a new line." 写入进去。如果文件已经存在，原来的内容会被覆盖掉。
立即学习“PHP免费学习笔记（深入）”；
如何追加内容到现有文件？
默认情况下，
file_put_contents()会覆盖文件内容。如果想要追加内容而不是覆盖，可以使用
FILE_APPEND标志：
<?php $file = 'my_file.txt'; $data = "This line is appended.\n"; // 将数据追加到文件末尾 file_put_contents($file, $data, FILE_APPEND); echo "Data appended to file successfully!"; ?>
FILE_APPEND就像一个开关，告诉 PHP 不要覆盖，直接把新内容加到文件屁股后面。
如何处理写入错误？
虽然
file_put_contents()用起来简单，但还是可能会出错，比如权限问题、磁盘空间不足等等。建议检查返回值，看看写入是否成功：
<?php
$file = '/path/to/protected/file.txt'; // 故意设置一个没有写入权限的路径
$data = "Some data to write.";
$result = file_put_contents($file, $data);
if ($result === false) {
$error = error_get_last();
echo "Write failed: " . $error['message'];
} else {
echo "Written " . $result . " bytes to file.";
}
?>error_get_last()函数可以获取最近一次发生的错误信息，方便调试。注意，
file_put_contents()在失败时返回
false，所以要用严格等于
===来判断。
如何控制写入时的并发问题？
在高并发环境下，多个进程同时写入同一个文件可能会导致数据丢失或损坏。可以使用
LOCK_EX标志来获取独占锁，防止并发写入：
<?php $file = 'shared_file.txt'; $data = "Data from process " . getmypid() . "\n"; // 获取独占锁并写入文件 file_put_contents($file, $data, FILE_APPEND | LOCK_EX); echo "Data written with lock."; ?>
LOCK_EX告诉操作系统，在写入文件之前先锁定它，其他进程必须等待锁释放才能写入，这样就能保证数据的一致性。
如何写入数组到文件？
file_put_contents()本身只能写入字符串。如果要写入数组，需要先将数组序列化成字符串，例如使用
serialize()或
json_encode()：
<?php $file = 'array_file.txt'; $array = ['name' => 'John', 'age' => 30, 'city' => 'New York']; // 将数组序列化成 JSON 字符串 $json_string = json_encode($array); // 写入 JSON 字符串到文件 file_put_contents($file, $json_string); echo "Array written to file as JSON."; ?>
读取时，需要使用
json_decode()或
unserialize()将字符串转换回数组。
file_put_contents
和 fwrite
有什么区别？ 什么时候用哪个？
file_put_contents更简单，一步到位，适合简单的写入操作。
fwrite需要先用
fopen打开文件，然后
fwrite写入，最后
fclose关闭，更灵活，适合复杂的写入操作，比如需要分段写入、处理大文件等。 如果只是简单地把一段字符串写到文件里，
file_put_contents绝对是首选。
如何安全地使用 file_put_contents
？
安全问题主要在于写入路径和写入内容。 确保写入路径是可信的，不要让用户控制写入路径，否则可能导致任意文件写入漏洞。 对于写入内容，如果内容来自用户输入，一定要进行过滤和转义，防止恶意代码注入。
