[函数]file_put_contents()函数—用法及示例

函数名：file_put_contents()

适用版本：PHP 4 >= 4.3.0, PHP 5, PHP 7

用法：file_put_contents(string $filename, mixed $data, int $flags = 0, resource $context = null): int|false

说明： file_put_contents() 函数将一个字符串写入文件中。如果文件不存在，则会创建文件；如果文件已存在，则会覆盖原有内容。该函数是一个简单且高效的替代方法，用于打开、写入并关闭文件的过程。

参数：

• $filename：要写入的文件路径。
• $data：要写入文件的数据。可以是一个字符串、数组或者是一个实现了 __toString() 方法的对象。
• $flags：可选参数，用于指定写入文件的方式。默认为 0，表示没有特殊的写入方式。可以使用以下常量进行设置：
  • FILE_USE_INCLUDE_PATH：如果设置了该常量，将在 include_path 目录中搜索文件。
  • FILE_APPEND：如果文件已经存在，将在文件末尾追加内容，而不是覆盖原有内容。
• $context：可选参数，用于指定上下文资源。通常不需要使用。

返回值：

• 成功：返回写入到文件中的字节数。
• 失败：返回 false。

示例：

1. 将字符串写入文件：

$file = 'example.txt';
$data = 'Hello, World!';
file_put_contents($file, $data);

1. 将数组转换为 JSON 字符串，并写入文件：

$file = 'example.json';
$data = ['name' => 'John', 'age' => 25];
$json = json_encode($data);
file_put_contents($file, $json);

1. 追加内容到已存在的文件末尾：

$file = 'example.txt';
$data = 'More content';
file_put_contents($file, $data, FILE_APPEND);