PHP file_put_contents 函数详解：一键写入文件与追加模式

函数概述

file_put_contents() 用于将字符串写入文件。如果文件不存在，则会自动创建；如果存在，默认情况下会覆盖原有内容。该函数相当于依次调用 fopen()、fwrite() 和 fclose() 三个步骤。

语法结构

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

核心参数解析

• $filename：目标文件的路径名称。请注意检查目录权限及拼写错误。
• $data：要写入的数据。可以是字符串（string）、标量值（integer/float），或者非多维的数组（Array）。如果是数组，会将数组元素拼接后写入，等价于 join('', $array)。在 PHP 5.1+ 中也支持流资源（Stream Resource）。
• $flags（可选）：控制写入行为的标记，可以是以下常量的组合：

• FILE_USE_INCLUDE_PATH：在 include_path 中搜索文件（使用需谨慎）。
• FILE_APPEND：如果文件已存在，则在文件末尾追加内容，而不是覆盖。
• LOCK_EX：在写入时获得独占锁定（Exclusive Lock），防止并发写入冲突。

实战操作指南

第1步：写入字符串到文件

这是最基础的应用场景，直接将文本内容保存为新文件或覆盖旧文件。

<?php
// 定义要写入的内容
$content = "Hello World";

// 执行写入操作
// 如果 html/test.txt 不存在则创建，存在则覆盖
file_put_contents("html/test.txt", $content);

// 输出文件大小以验证是否成功
echo filesize("html/test.txt");
?>

第2步：处理数组数据

当需要保存一组字符串时，可以直接传递数组，无需手动循环写入。

<?php
$lines = array(
    "第一行内容",
    "第二行内容",
    "第三行内容"
);

// 自动将数组拼接为字符串写入
file_put_contents("html/array_cache.txt", $lines);
?>

第3步：开启追加模式（推荐）

在生产环境中，为了避免误删历史日志或配置，通常建议结合 FILE_APPEND 标志使用，确保新数据位于文件尾部。

<?php
$file = 'log.txt';
$newLog = date('Y-m-d H:i:s') . " - 系统操作记录\n";

// 使用 | 运算符组合追加模式和锁定
file_put_contents($file, $newLog, FILE_APPEND | LOCK_EX);
?>

常见问题排查

在使用该函数时，开发者常遇到文件未生成的情况。请重点检查：

1. 路径正确性：确认相对路径是基于当前执行脚本的位置。如果脚本在根目录，而试图写入子文件夹，确保子文件夹存在且可写。
2. 拼写细节：类似文件名拼写错误会导致文件出现在意想不到的位置（例如将 cache.txt 错写为 caceh.txt 从而生成了多余文件）。
3. 服务器权限：Web 服务器用户（如 www-data 或 IUSR）必须对目标文件夹拥有写入权限。

以上就是 file_put_contents 函数的详细内容，更多关于 PHP 文件操作的资料请关注本站其它相关文章！