# PHP file_put_contents() 函数 ## 定义和用法 file_put_contents() 函数把一个字符串写入文件中。 与依次调用 fopen()，fwrite() 以及 fclose() 功能一样。 ### 语法 ``` file_put_contents(file,data,mode,context) ``` | 参数 | 描述 | | --- | --- | | file | 必需。规定要写入数据的文件。如果文件不存在，则创建一个新文件。 | | data | 可选。规定要写入文件的数据。可以是字符串、数组或数据流。 | | mode | 可选。规定如何打开/写入文件。可能的值： `FILE_USE_INCLUDE_PATH` `FILE_APPEND` `LOCK_EX` | | context | 可选。规定文件句柄的环境。context 是一套可以修改流的行为的选项。若使用 null，则忽略。 | ### 说明 参数 _data_ 可以是数组（但不能是多维数组）。 自 PHP 5.1.0 起，_data_ 参数也可以被指定为 stream 资源，stream 中所保存的缓存数据将被写入到指定文件中，这种用法就相似于使用 stream_copy_to_stream() 函数。 对 _context_ 参数的支持是 PHP 5.0.0 添加的。 ### 返回值 该函数将返回写入到文件内数据的字节数。 ## 提示和注释 提示：使用 FILE_APPEND 可避免删除文件中已有的内容。 注释：本函数可安全用于二进制对象。 ## 例子 ``` <?php echo file_put_contents("test.txt","Hello World. Testing!"); ?> ``` 输出： ``` 26 ```