PHP文件操作关键在权限、路径、上下文三层关系：fopen()报错多因权限不足或目录缺失；推荐用__DIR__拼接绝对路径；file_get/put_contents适用于小文件，大文件需流式处理；scandir()前须is_dir()和is_readable()校验。
PHP 文件操作不是“学会函数就行”，而是得先理清权限、路径、上下文这三层关系，否则 fopen() 报错、file_put_contents() 写不进、scandir() 返回空数组，全是路径或权限惹的祸。
为什么 fopen() 总是返回 false
绝大多数情况不是代码写错了，而是 PHP 进程没权限读/写目标路径，或者路径根本不存在（注意：不是文件不存在，是目录层级缺失）。
-
fopen()的第一个参数必须是**绝对路径**或相对于当前工作目录的路径；用__DIR__拼接最稳，比如fopen(__DIR__ . '/data/log.txt', 'a') - Linux/macOS 下检查 Web 服务器用户（如
www-data或_www）对目标目录是否有w权限；Windows 下注意 IIS/Apache 服务是否以有权限的账户运行 - 不要依赖相对路径如
./logs/error.log—— 当前工作目录取决于谁调用脚本（命令行？Web 请求？Cron？），结果不可控 - 错误时立刻加
error_get_last()查具体原因：$fp = fopen($path, 'w');<br>if (!$fp) {<br> $err = error_get_last();<br> echo $err['message']; // 比如 "Permission denied" 或 "No such file or directory"<br>}
file_get_contents() 和 file_put_contents() 能否替代 fopen/fwrite
能，但只适用于小文件（一般建议 ≤ 2MB）和简单场景。它们底层仍调用 fopen()，只是封装了打开→读/写→关闭三步。
-
file_get_contents()会把整个文件加载进内存，大文件直接 OOM；fgets()+ 循环才是处理日志、CSV 等大文本的正解 -
file_put_contents($file, $data, FILE_APPEND | LOCK_EX)是安全追加日志的常用写法，LOCK_EX防止并发写乱序 - 如果要写入二进制内容（如图片、PDF），必须加
FILE_BINARY标志，否则 Windows 下换行符可能被误转 - 它们不支持“只读打开后判断大小再决定是否读取”这类精细控制，遇到条件复杂逻辑，还是得回到
fopen()流式操作
scandir() 为什么列不出子目录里的文件
常见原因是传入了错误路径，或目标目录权限未开放给 Web 用户，而不是函数本身有问题。
立即学习“PHP免费学习笔记（深入）”；
- 永远用
is_dir($path)和is_readable($path)双重校验后再调用scandir()，避免静默失败 -
scandir()返回数组包含.和..，实际文件需过滤：$files = array_diff(scandir($dir), ['.', '..']);
- 想递归遍历？别硬写多层 for —— 直接用
RecursiveDirectoryIterator+RecursiveIteratorIterator，更可靠也更省内存 - 注意：NFS、Docker volume、某些云存储挂载点可能不支持
scandir()，此时需换用glob()或 API 方式访问
真正卡住人的从来不是函数记不全，而是搞不清当前脚本是以什么身份、在什么路径、带着什么上下文去碰那个文件——每次出问题，先打 echo getcwd() . "\n" . __DIR__;，比翻手册快十倍。
