使用 php fprintf 写入文件遇到问题？常见错误与解决方法！

发布日期： 2025-10-04 阅读量： 作者： admin

今天得空，就想着把我之前用PHP往文件里写点东西的经历絮叨絮叨，主要是用了那个叫 fprintf 的玩意儿。

起因是这样的，我需要把一些处理过的数据存到一个文本文件里，而且还想让它有点格式，比如每行有名字、年龄、分数啥的，用逗号隔开，整整齐齐那种。一开始我寻思着用 `fwrite` 直接怼字符串进去，但拼字符串有点烦，特别是数字和文本混一起的时候。

后来想起来C语言里有 `printf`，PHP里也有个类似的 `printf` 是直接输出到屏幕的，我就琢磨着有没有往文件里输出的，一查，还真有，就是这个 fprintf。

开始动手

说干就干。第一步，我得先打开一个文件，或者说创建一个文件来写。用了 `fopen` 函数，像这样：

$文件句柄 = fopen("我的数据.txt", "w");

这里的 "w" 很关键，意思是写入模式，如果文件存在就清空它，不存在就新建一个。要是想追加内容，就得用 "a"。

文件打开了，拿到一个所谓的“句柄”，你可以把它理解成一个指向文件的“把手”，接下来操作文件就靠它了。

然后我就开始尝试用 fprintf 往里面写数据。这函数的用法跟 `printf` 差不多，第一个参数是文件句柄，第二个是格式化字符串，后面跟着要填进去的变量。

比如我想写一行“张三, 25, 90.5”，格式大概是“字符串, 整数, 浮点数”，那么格式字符串就是 "%s, %d, %.1f\n"。那个 `\n` 是换行符，这样下一条记录就能写在新的一行了。

我的代码大概是这样写的（假设变量已经有值了）：

fprintf($文件句柄, "%s, %d, %.1f\n", $名字, $年龄, $分数);

一开始写的时候，遇到点小麻烦。主要是那个格式化字符串里的占位符 `%s`, `%d`, `%.1f` 这些，有时候会搞混，或者忘了小数点后面要保留几位。试了几次，看看生成的文件内容对不对，慢慢就调对了。

通常我不是只写一条数据，而是有很多条，所以会把 `fprintf` 放在一个循环里面。比如从数据库里读出来一堆用户数据，然后一条条循环处理，用 `fprintf` 写到文件里。

先 `fopen` 打开文件。
然后开始循环（比如 `foreach` 遍历一个数组）。
循环里面，每次调用 `fprintf` 写入一行格式化的数据。
特别重要的一步：所有数据都写完之后，一定要记得用 `fclose` 把文件关掉！像这样：fclose($文件句柄);。不然数据可能没完全写到磁盘上，或者文件一直被占用着，不

检查生成的 "我的数据.txt" 文件，里面的内容果然是我想要的格式，每一行都是 “名字, 年龄, 分数” 的样子，整整齐齐，看着就舒服。用 `fprintf` 确实比自己手动拼字符串要省事儿，也不容易出错。

这回实践过程还算顺利。fprintf 这个函数用熟了之后，处理这种需要格式化输出到文件的场景，效率还是挺高的。关键就是记住那几个步骤：打开文件、循环写入（注意格式字符串）、关闭文件。就这么简单。