函数名: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。
示例:
- 将字符串写入文件:
$file = 'example.txt';
$data = 'Hello, World!';
file_put_contents($file, $data);
- 将数组转换为 JSON 字符串,并写入文件:
$file = 'example.json';
$data = ['name' => 'John', 'age' => 25];
$json = json_encode($data);
file_put_contents($file, $json);
- 追加内容到已存在的文件末尾:
$file = 'example.txt';
$data = 'More content';
file_put_contents($file, $data, FILE_APPEND);