PHP文件创建失败主因是运行时权限或路径问题，典型报错为Permission denied、No such file or directory或Operation not permitted；需逐层检查目录存在性、用户权限、open_basedir限制及SELinux/Docker等环境策略。
PHP fopen() 或 file_put_contents() 创建文件失败的常见报错
最典型的错误是：failed to open stream: Permission denied，其次是 No such file or directory（路径不存在）或 Operation not permitted（SELinux/容器限制）。这些不是代码写错了，而是运行时环境没给足权限或路径没准备好。
排查时先看错误信息里明确提到的函数和路径——比如 fopen('/var/log/app.log', 'a') 失败，就立刻检查 /var/log/ 目录是否存在、Web 进程用户（如 www-data 或 nginx）是否有写权限，而不是急着改 PHP 逻辑。
- 用
ls -ld /var/log/看目录权限和属主 - 用
ps aux | grep apache或ps aux | grep php-fpm确认当前 Web 进程以哪个用户身份运行 - 临时测试：切换到该用户（
sudo -u www-data touch /var/log/test.txt），看能否手动创建
PHP 写入路径必须是绝对路径，且父目录需存在
file_put_contents('log/app.log', 'data') 很容易失败——因为相对路径基于脚本执行位置（getcwd()），而 Web 服务器下这个位置不可控（可能是 /var/www/html，也可能是 /tmp）。更关键的是，log/ 目录如果不存在，PHP 不会自动创建它。
正确做法是显式构造绝对路径，并确保父目录可写：
立即学习“PHP免费学习笔记（深入）”；
if (!is_dir('/var/www/html/logs')) {
mkdir('/var/www/html/logs', 0755, true);
}
file_put_contents('/var/www/html/logs/debug.log', 'test');
-
mkdir()第三个参数true表示递归创建，但前提是上级目录有写权限 - 避免用
__DIR__ . '/logs/'拼接——__DIR__是脚本所在目录，线上部署后可能被移动或符号链接干扰 - 生产环境建议统一写入
/var/log/yourapp/，而非 Web 根目录下，防直接 HTTP 访问
open_basedir 限制和 safe_mode（已废弃但仍有遗留影响）
即使路径存在、权限正确，fopen() 仍可能报 open_basedir restriction in effect。这是 PHP 配置项 open_basedir 在起作用，它强制限定 PHP 能访问的文件系统路径范围。
