PHP 基础教程

PHP 表单

PHP 高级教程

PHP 7 新特性

PHP 数据库

PHP XML

PHP 与 AJAX

PHP 参考手册

original icon
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.knowledgedict.com/tutorial/php-func-filesystem-file-put-contents.html

PHP file_put_contents() 函数

PHP 5 Filesystem 函数 PHP 5 Filesystem 函数


定义和用法

file_put_contents() 函数把一个字符串写入文件中。

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

  1. 如果设置了 FILE_USE_INCLUDE_PATH,那么将检查 *filename* 副本的内置路径
  2. 如果文件不存在,将创建一个文件
  3. 打开文件
  4. 如果设置了 LOCK_EX,那么将锁定文件
  5. 如果设置了 FILE_APPEND,那么将移至文件末尾。否则,将会清除文件的内容
  6. 向文件中写入数据
  7. 关闭文件并对所有文件解锁

如果成功,该函数将返回写入文件中的字符数。如果失败,则返回 False。

语法

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )

参数 描述
file 必需。规定要写入数据的文件。如果文件不存在,则创建一个新文件。
data 必需。规定要写入文件的数据。可以是字符串、数组或数据流。
mode 可选。规定如何打开/写入文件。可能的值:
  • FILE_USE_INCLUDE_PATH
  • FILE_APPEND
  • LOCK_EX
context 可选。规定文件句柄的环境。context 是一套可以修改流的行为的选项。

提示和注释

注释:请使用 FILE_APPEND 避免删除文件中已存在的内容。

实例


<?php
echo file_put_contents("sites.txt","Runoob");
?>

以上实例执行输出结果为:

6

接下来我们向文件 sites.txt 追加内容:


<?php
$file = 'sites.txt';
 
$site = "\nGoogle";
// 向文件追加写入内容
// 使用 FILE_APPEND 标记,可以在文件末尾追加内容
//  LOCK_EX 标记可以防止多人同时写入
file_put_contents($file, $site, FILE_APPEND | LOCK_EX);
?>

执行成功后,打开 sites.txt 文件,内容为:

Runoob
Google