PHP如何使用file_put_contents函数_PHP file_put_contents函数用法与技巧-php教程-PHP中文网

PHP如何使用file_put_contents函数_PHP file_put_contents函数用法与技巧

冰火之心

发布： 2025-09-15 21:43:01

原创

919人浏览过

file_put_contents()用于将字符串写入文件，支持创建、覆盖、追加（FILE_APPEND）、加锁（LOCK_EX）及序列化数组写入；通过检查返回值和error_get_last()处理错误，注意路径与内容安全以防止漏洞。

php如何使用file_put_contents函数_php file_put_contents函数用法与技巧

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()

登录后复制

用起来简单，但还是可能会出错，比如权限问题、磁盘空间不足等等。建议检查返回值，看看写入是否成功：

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

<?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.";
?>

登录后复制

读取时，需要使用