file_put_contents

(PHP 5, PHP 7)

file_put_contents — 将一个字符串写入文件

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )

和依次调用 fopen()，fwrite() 以及 fclose() 功能一样。

If filename does not exist, the file is created. Otherwise, the existing file is overwritten, unless the FILE_APPEND flag is set.

filename

要被写入数据的文件名。

data

要写入的数据。类型可以是 string，array 或者是 stream 资源（如上面所说的那样）。

如果 data 指定为 stream 资源，这里 stream 中所保存的缓存数据将被写入到指定文件中，这种用法就相似于使用stream_copy_to_stream() 函数。

参数 data 可以是数组（但不能为多维数组），这就相当于 file_put_contents($filename, join('', $array))。

flags

flags 的值可以是以下 flag 使用 OR (|) 运算符进行的组合。

**Available flags**
Flag	描述
`FILE_USE_INCLUDE_PATH`	在 include 目录里搜索 `filename`。更多信息可参见 include_path。
`FILE_APPEND`	如果文件 `filename` 已经存在，追加数据而不是覆盖。
`LOCK_EX`	在写入时获得一个独占锁。

context

一个 context 资源。

该函数将返回写入到文件内数据的字节数，失败时返回FALSE

Warning

此函数可能返回布尔值 FALSE，但也可能返回等同于 FALSE 的非布尔值。请阅读布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。

实例：

很多时候记录日志需要换行。不建议使用\r\n，因为：
在windows中\r\n是换行
在Mac中\r是换行
在Liunx中\n是换行

PHP提供了一个常量【PHP_EOL】来匹配不同的操作系统。

$key = 'test';

file_put_contents('writeWrong.log', $key . PHP_EOL, FILE_APPEND);

FILE_APPEND：在文件末尾以追加的方式写入数据。

PHP_EOL：换行，会自动适应windows、mac、linux系统。

我们可以用函数get_defined_constants()来获取所有PHP常量。