file_put_contents() 函数用于把字符串写入文件,成功返回写入到文件内数据的字节数,失败则返回 FALSE。
使用说明:
file_put_contents(file,data,mode,context)
参数说明:
file要写入数据的文件名
data 要写入的数据。类型可以是 string,array(但不能为多维数组),或者是 stream 资源
mode可选,规定如何打开/写入文件。可能的值:
1.FILE_USE_INCLUDE_PATH:检查 filename 副本的内置路径
2.FILE_APPEND:在文件末尾以追加的方式写入数据
3.LOCK_EX:对文件上锁
参数 | 描述 |
---|---|
file | 必需。规定要写入数据的文件。如果文件不存在,则创建一个新文件。 |
data | 可选。规定要写入文件的数据。可以是字符串、数组或数据流。 |
mode |
可选。规定如何打开/写入文件。可能的值:
|
context |
可选。规定文件句柄的环境。 context 是一套可以修改流的行为的选项。若使用 null,则忽略。 |
context 可选,Context是一组选项,可以通过它修改文本属性
例子:
<?php
echo file_put_contents("test.txt", "This is test.txt");
?>
运行该例子,浏览器输出:字符创的长度
而 test.txt 文件(与程序同目录下)内容则为:This is test.txt
提示
?如果文件不存在,则创建文件,相当于fopen()函数行为。
?如果文件存在,默认将清空文件内的内容,可设置 flags 参数值为 FILE_APPEND 以避免(见下)。
?本函数可安全用于二进制对象。
追加形式写入文件内容
当设置 flags 参数值为 FILE_APPEND 时,表示在已有文件内容后面追加内容的方式写入新数据:
<?php
file_put_contents("test.txt", "my add contents", FILE_APPEND);
?>
执行程序后,test.txt 文件内容变为:This is test.txt my
add contents
注意:file_put_contents() 的行为实际上等于依次调用 fopen(),fwrite() 以及 fclose() 功能一样。