目录

PHP file_put_contents() 函数

❮ PHP 文件系统参考

示例

将数据写入文件:

<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>

上面代码的输出将是:

21


定义和用法

file_put_contents() 将数据写入文件。

该函数在访问文件时遵循以下规则:

  1. 如果设置了 FILE_USE_INCLUDE_PATH,请检查包含路径中的副本文件名
  2. 如果文件不存在则创建
  3. 打开文件
  4. 如果设置了 LOCK_EX,则锁定文件
  5. 如果设置了 FILE_APPEND,则移至文件末尾。否则,清除文件内容
  6. 将数据写入文件
  7. 关闭文件并释放所有锁定

笔记:使用 FILE_APPEND 可以避免删除文件的现有内容。

语法

file_put_contents( filename, data, mode, context)

参数值

Parameter Description
filename Required. Specifies the path to the file to write to. If the file does not exist, this function will create one
data Required. The data to write to the file. Can be a string, array, or a data stream
mode Optional. Specifies how to open/write to the file. Possible values:
  • FILE_USE_INCLUDE_PATH - search for filename in the include directory
  • FILE_APPEND - if file already exists, append the data to it - instead of overwriting it
  • LOCK_EX - Put an exclusive lock on the file while writing to it
context Optional. Specifies the context of the file handle. Context is a set of options that can modify the behavior of a stream.


技术细节

返回值: 成功时写入文件的字节数,失败时写入 FALSE
PHP 版本: 5.0+
二进制安全: 是的
PHP 变更日志: PHP 5.1 - 添加了对 LOCK_EX 的支持以及将流资源传递给数据参数的功能

❮ PHP 文件系统参考