file_put_contents
将数据写入文件
&reftitle.description;
intfalsefile_put_contents
stringfilename
mixeddata
intflags0
resourcenullcontext&null;
和依次调用 fopen,fwrite
以及 fclose 功能一样。
如果 filename
不存在,将会创建文件。反之,存在的文件将会重写,除非设置
FILE_APPEND flag。
&reftitle.parameters;
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
在写入时获取文件独占锁。换句话说,在调用 fopen
和 fwrite 中间发生了 flock
调用。这与调用带模式“x”的 fopen 不同。
context
一个 context 资源。
&reftitle.returnvalues;
该函数将返回写入到文件内数据的字节数,失败时返回&false;
&return.falseproblem;
&reftitle.examples;
简单用法示例
]]>
Using flags
]]>
&reftitle.notes;
¬e.bin-safe;
&tip.fopen-wrapper;
&reftitle.seealso;
fopen
fwrite
file_get_contents
stream_context_create