php file_put_contents 函数

file_put_contents
（ PHP 5中）

file_put_contents -写一个字符串到一个文件

描述
国际file_put_contents （字符串$文件名，混合$数据[摘要$国旗= 0 [ ，资源$背景] ] ）
这一功能是相同的要求fopen （ ）函数， fwrite （ ）和fclose （ ）先后将数据写入一个文件。

如果文件不存在，该文件的创建。否则，现有的文件被覆盖，除非FILE_APPEND旗帜设置。

参数

文件名
文件路径在哪里写的数据。

数据
这些数据给我们写信。可以是一个字符串，数组或流资源（上面解释） 。

如果数据流的资源，剩下的缓冲区的流将被复制到指定的文件。这是类似使用stream_copy_to_stream （ ） 。

您还可以指定数据参数作为一个单一的层面阵列。这相当于file_put_contents （ $文件名，爆（ '' ， $阵列） ） 。

旗帜
国旗的价值可任意组合下列旗帜（与一些限制） ，加入的二进位或（ | ）操作符。


可悬挂国旗描述
FILE_USE_INCLUDE_PATH搜索文件名中包含目录。见include_path中获取更多信息。
FILE_APPEND如果档案filename已经存在，附加数据的文件，而不是覆盖它。
LOCK_EX获得独占锁定的文件，同时着手写作。
FILE_TEXT数据写入的文字模式。如果已启用的Unicode语义，默认字符编码是UTF - 8 。您可以指定一个不同的编码，建立一个自定义的范围内或使用stream_default_encoding （ ）来更改默认的。此标志不能用于FILE_BINARY 。此标志只适用于自PHP 6 。
FILE_BINARY数据将被写入二进制模式。这是默认设置，并不能用于FILE_TEXT 。此标志只适用于自PHP 6 。


背景
资源的有效范围内建立stream_context_create （ ） 。


返回值
该函数返回的字节数是写入文件，或FALSE的失败。

实例

例如＃ 1使用简单的例子

$file = 'people.txt';
// Open the file to get existing content
$current = file_get_contents($file);
// Append a new person to the file
$current .= "John Smithn";
// Write the contents back to the file
file_put_contents($file, $current);
?>

$file = 'people.txt';
// The new person to add to the file
$person = "John Smithn";
// Write the contents to the file,
// using the FILE_APPEND flag to append the content to the end of the file
// and the LOCK_EX flag to prevent anyone else writing to the file at the same time
file_put_contents($file, $person, FILE_APPEND | LOCK_EX);
?>