在PHP开发中，将各类调用结果存储到文件是常见需求，file_put_contents函数凭借简洁的语法成为实现该功能的首选方案，它可以快速将字符串内容写入指定文件，支持多种写入模式和参数配置。
file_put_contents基础用法
file_put_contents的基本语法如下，它接受文件路径、写入内容和可选的参数，返回成功写入的字节数，失败则返回false。
<?php
// 基础写入示例
$filePath = 'result.txt';
$content = '这是要写入的内容';
$writeResult = file_put_contents($filePath, $content);
if ($writeResult !== false) {
echo '写入成功，写入字节数：' . $writeResult;
} else {
echo '写入失败';
}
?>
写入普通函数调用结果
如果函数返回的是字符串、数字等基础类型，可以直接作为写入内容传入file_put_contents。
<?php
// 定义一个获取当前时间的函数
function getCurrentTime() {
return date('Y-m-d H:i:s');
}
$timeResult = getCurrentTime();
$writeRes = file_put_contents('time_result.txt', $timeResult);
if ($writeRes) {
echo '时间结果写入成功';
}
?>
写入数组或对象类调用结果
当调用结果不是字符串类型时，需要先转换为字符串再写入，常用json_encode或者serialize处理。
<?php
// 模拟接口调用返回数组结果
function getUserInfo() {
return [
'id' => 1,
'name' => '测试用户',
'age' => 25
];
}
$userInfo = getUserInfo();
// 转换为JSON字符串写入
$jsonContent = json_encode($userInfo, JSON_UNESCAPED_UNICODE);
file_put_contents('user_info.json', $jsonContent);
// 如果需要后续反序列化使用，也可以用serialize
$serializeContent = serialize($userInfo);
file_put_contents('user_info.ser', $serializeContent);
?>
追加写入调用结果
默认情况下file_put_contents会覆盖文件原有内容，如果需要追加写入，需要传入FILE_APPEND参数。
<?php
// 模拟多次调用结果追加写入
function getLogContent($msg) {
return '[' . date('Y-m-d H:i:s') . '] ' . $msg . PHP_EOL;
}
// 第一次写入
file_put_contents('app.log', getLogContent('程序启动'));
// 第二次追加写入
file_put_contents('app.log', getLogContent('处理请求'), FILE_APPEND);
// 第三次追加写入
file_put_contents('app.log', getLogContent('程序结束'), FILE_APPEND);
?>
写入时的注意事项
- 要确保目标文件路径有写入权限，否则会返回false写入失败。
- 如果写入的内容包含特殊字符，需要注意编码问题，避免写入后出现乱码。
- 写入远程文件路径时，需要确保PHP配置允许打开远程文件，否则无法正常写入。
- 如果需要同时设置写入锁定，可以搭配LOCK_EX参数使用，避免多进程写入冲突。
<?php
// 带锁定的写入示例
$content = '需要安全写入的内容';
file_put_contents('safe.txt', $content, FILE_APPEND | LOCK_EX);
?>
PHPfile_put_contents文件写入调用结果存储修改时间：2026-06-10 21:06:27