PHP中用fopen()的a或a+模式可自动创建文件并追加写入,a只写、a+读写但写仍强制追加;需检查fopen返回值,推荐file_put_contents($file, $data, FILE_APPEND | LOCK_EX)。

用 fopen() 打开文件时指定 a 或 a+ 模式
PHP 中追加写入并自动创建文件,核心是使用 fopen() 的 a(只写追加)或 a+(读写追加)模式。这两种模式会在文件不存在时自动创建,且无论文件是否存在,写入位置总是在末尾——这是和 w 模式最本质的区别。w 会清空原内容,a 不会。
常见错误是误用 fwrite() 前没检查 fopen() 返回值,导致 Warning: fwrite() expects parameter 1 to be resource, bool given。务必先判断是否成功打开:
$fp = fopen('log.txt', 'a');
if ($fp === false) {
die('无法打开或创建文件');
}
fwrite($fp, date('Y-m-d H:i:s') . " - 记录一条\n");
fclose($fp);
a 和 a+ 的实际差异在哪
两者都支持自动创建文件、写入位置在末尾,但权限不同:a 只允许写,不能读;a+ 允许读写,但读操作默认从开头开始,而写操作仍强制追加到末尾(即使你用 fseek() 移动了指针,fwrite() 仍会回到末尾写)。
- 只需记录日志、追加文本 → 用
a,更安全,也更符合语义 - 需要先读取已有内容再决定是否追加(比如去重写入)→ 用
a+,但注意:读完后必须用fseek($fp, 0, SEEK_END)才能确保后续fwrite()真正追加 - 如果只是“先读再覆盖整个文件”,别用
a+,该用c+或r+配合ftruncate()
为什么有时追加失败却没报错
典型原因不是代码逻辑问题,而是权限或路径问题:
立即学习“PHP免费学习笔记(深入)”;
- 目标目录不存在,且 PHP 进程无权在父级目录中
mkdir()→fopen()直接返回false,但不会提示“目录不存在” - 文件存在但权限为只读(如
chmod 444 log.txt)→fopen('log.txt', 'a')在 Linux 下可能静默失败(取决于系统配置) - Windows 下路径含中文或特殊符号(如
日志\test.txt),而脚本编码与系统不一致 → 文件看似创建失败,实则生成了乱码名文件
建议追加前主动检查并创建目录:is_dir(dirname($path)) || mkdir(dirname($path), 0755, true)。
用 file_put_contents() 更简洁,但要注意第三个参数
如果只是简单追加字符串,file_put_contents() 是更轻量的选择,关键是传入 FILE_APPEND 标志:
file_put_contents('data.txt', "新行内容\n", FILE_APPEND | LOCK_EX);
LOCK_EX 强烈建议加上,尤其在多进程写同一文件时,避免内容错乱。不加的话,在高并发下可能出现两行文字挤在同一行、或部分丢失。
注意:file_put_contents() 默认以 UTF-8 写入,若源字符串是 GBK 编码,需先转换,否则出现乱码;而 fopen() + fwrite() 不做编码干预,更“原始”也更可控。
追加写入本身很简单,难的是在并发、权限、编码、路径动态性这些边界场景里不出错。别只盯着函数参数,多看 error_log() 和 var_dump(file_exists($path), is_writable(dirname($path)))。











