php file_put_contents中文乱码怎么办？解决方法来了！

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

今天跟大家唠唠我用 `php file_put_contents` 的一些小经验，都是实打实踩坑换来的。

事情是这样的，前几天有个需求，要把一些数据写到文件里，这活儿简单，我第一个想到的就是 `file_put_contents`，方便快捷。

php

$data = "Hello, world!";

file_put_contents("*", $data);

这段代码，我写起来那是相当的自信，直接就扔到测试环境跑了。结果，问题来了！

第一次踩坑：权限问题

我发现文件压根没生成！赶紧去看服务器日志，发现是权限不足。原来，`file_put_contents` 默认是用 web server 的用户去创建文件的，如果 web server 用户对目标目录没有写权限，那肯定就跪了。

解决办法也很简单，要么修改目录权限，让 web server 用户有写权限，要么指定一个有权限的用户去执行这个脚本。我是直接 `chmod 777` 简单粗暴，测试环境嘛先跑起来再说。

bash

chmod 777 /path/to/your/directory

权限问题搞定，再次运行脚本，文件是生成了，但是新的问题又来了。

第二次踩坑：中文乱码

这回文件是生成了，但是里面的中文全是乱码！我这才想起来，编码问题是个大坑。

我赶紧检查了一下我的 PHP 文件，确认是 UTF-8 编码，但是文件内容还是乱码。后来查了资料才知道，`file_put_contents` 默认不会自动转换编码。

解决方法是，在写入文件内容之前，手动进行编码转换。我用 `mb_convert_encoding` 函数搞定。

php

$data = "你世界！";

$data = mb_convert_encoding($data, 'GBK', 'UTF-8');

file_put_contents("*", $data);

这段代码，先把 UTF-8 编码的字符串转换成 GBK 编码，然后再写入文件。再次运行，中文总算正常显示了。

第三次踩坑：追加写入

后来需求变了，不是每次都覆盖文件，而是要追加内容。这也好办，`file_put_contents` 提供了 `FILE_APPEND` 标志。

php

$data = "这是追加的内容！\n";

file_put_contents("*", $data, FILE_APPEND);

加了 `FILE_APPEND` 标志，每次运行脚本，内容都会追加到文件末尾。

第四次踩坑：并发写入

又过了几天，发现了一个更严重的问题，在高并发的情况下，文件内容经常会错乱！

这是因为 `file_put_contents` 不是原子操作，多个进程同时写入同一个文件，就会出现竞争。

解决办法是，加锁！可以用 `flock` 函数实现文件锁。

php

$file = "*";

$fp = fopen($file, "a+");

if (flock($fp, LOCK_EX)) { // 获取独占锁

$data = "这是并发写入的内容！\n";

fwrite($fp, $data);

fflush($fp); // 刷新输出缓冲

flock($fp, LOCK_UN); // 释放锁

} else {

echo "Couldn't get the lock!";

fclose($fp);

这段代码，先用 `fopen` 打开文件，然后用 `flock` 获取独占锁，写入内容，释放锁，关闭文件。这样就能保证并发写入的安全性。

总结

看似简单的 `file_put_contents`，坑还真不少。权限、编码、追加、并发，每个问题都得认真对待。

希望我的这些实践经验，能帮大家少踩一些坑，提高开发效率。写代码还是要多测试，多思考，才能避免掉进坑里。

上一篇: 如何申请个域名邮箱？超详细教程一看就会！

下一篇: 租用快速双线服务器哪家好？看看用户都推荐哪些平台！

php file_put_contents中文乱码怎么办？解决方法来了！

随便看看