PHP:file_put_contents()的用法_Filesystem函数

file_put_contents

(PHP 5)

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 的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用
===
运算符来测试此函数的返回值。

范例

Example #1 Simple usage example

$file