PHP 手册
后退 |  | 前进

# file_put_contents

(PHP 5)

file_put_contents -- 将一个字符串写入文件

## 说明

int file_put_contents ( string filename, string data [, int flags [, resource context]] )

和依次调用 fopen()，fwrite() 以及 fclose() 功能一样。

参数 data 可以是数组（但不能为多元数组），这就相当于 file_put_contents($filename, join('', $array))

自 PHP 5.1.0 起，data 参数也可以被指定为 stream 资源，这里 stream 中所保存的缓存数据将被写入到指定文件中，这种用法就相似于使用 stream_copy_to_stream() 函数。

## 参数

filename

  要被写入数据的文件名

data

  要写入的数据。类型可以是 string、 array 或者是 stream 资源（如上面所说的那样）.

flags

  flags 可以是 `FILE_USE_INCLUDE_PATH`, `FILE_APPEND` 和/或 `LOCK_EX` （获得一个独占锁定），然而使用 `FILE_USE_INCLUDE_PATH` 时要特别谨慎。

context

  一个 context 资源

## 返回值

该函数将返回写入到文件内数据的字节数

## 更新日志

版本 | 说明
--- | ---
5.1.0 | 添加了对 `LOCK_EX` 的支持和 data 参数处理 stream 资源的功能。

## 注释

> 注: 本函数可安全用于二进制对象。

> 注: 对 context 的支持是 PHP 5.0.0 添加的。有关 context 的说明请参考参考 CXLI, Stream Functions。

> 提示: 如果“fopen wrappers”已经被激活，则在本函数中可以把 URL 作为文件名来使用。请参阅 fopen() 函数来获取怎样指定文件名的详细信息以及支持 URL 封装协议的列表：附录 L。

## 参见

fopen()
fwrite()
file_get_contents()

后退 | 起点 | 前进
file_get_contents | 上一级 | file