最稳妥方式是 fopen() + fwrite(),因可精确控制模式、即时判断失败、避免权限路径陷阱;file_put_contents() 虽简捷但默认覆盖且不建父目录;touch() 单独建空文件冗余无必要。

用 fopen() + fwrite() 创建并写入文件最稳妥
PHP 里最通用、可控性最强的方式就是组合使用 fopen() 和 fwrite()。它能明确控制打开模式(比如 'w' 覆盖写、'a' 追加)、处理失败情况,并支持二进制或文本内容。
常见错误是直接用 file_put_contents() 却忽略权限或路径问题,而 fopen() 的返回值可以立刻判断是否成功:
-
fopen('log.txt', 'w')返回false?说明目录不可写或路径不存在 - 没加
fclose($fp)可能导致后续写入失败或资源泄漏 - 中文内容记得在
fwrite()前确保源字符串是 UTF-8 编码,否则可能乱码
file_put_contents() 适合简单场景但要注意默认行为
一行代码搞定创建+写入,但它的默认行为容易埋坑:
- 如果文件已存在,默认会覆盖(
FILE_APPEND标志才能追加) - 不自动创建父级目录 ——
file_put_contents('data/logs/app.log', $content)会失败,除非data/logs/已存在 - 想保证目录存在,得先调用
mkdir(dirname($path), 0755, true) - 第二个参数如果是数组,会自动 implode("\n"),但多数时候你传字符串更可控
示例:file_put_contents('test.txt', "Hello\nWorld"); —— 成功时返回写入字节数,失败返回 false,别忘了检查。
立即学习“PHP免费学习笔记(深入)”;
用 touch() 单独建空文件再写入?没必要
touch() 只负责创建空文件或更新 mtime,它不接受内容参数。有人误以为“先 touch() 再 file_put_contents()”更安全,其实多余:
-
file_put_contents('new.txt', 'hi')本身就会创建文件(只要目录可写) -
touch()多一次系统调用,还可能因权限问题失败(比如目录不可执行) - 唯一适用场景:只建空文件占位,内容稍后由其他进程写入
权限和路径问题比语法更容易导致失败
写入失败八成不是代码问题,而是环境配置:
- Web 服务器用户(如
www-data或_www)必须对目标目录有w权限,chmod 755不够,得是775或更宽松 - 相对路径如
'./output/data.txt'是相对于当前工作目录(getcwd()),不是脚本所在目录;用__DIR__ . '/output/data.txt'更可靠 - Windows 下路径分隔符用
/或\\都行,但统一用/可避免转义麻烦 - 某些共享主机禁用
fopen()的 URL 封装协议(http://),但本地文件操作不受影响
真正卡住人的,往往是一句 is_writable(__DIR__ . '/output') 返回 false 却没检查就往下走。











