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 能访问的文件系统路径范围。
检查方式：php -i | grep open_basedir 或在脚本中输出 ini_get('open_basedir')。若返回非空值（如 /var/www/html:/tmp），则所有文件操作都只能在这两个路径下进行。
- 写入
/tmp通常安全，但要注意清理，且不能依赖持久性 - 若必须写到
/var/log/，需在php.ini或虚拟主机配置中把该路径加进open_basedir -
safe_mode已从 PHP 5.4+ 移除，但某些老旧面板（如旧版 cPanel）可能模拟类似行为，留意错误是否含Safe Mode字样
Docker、SELinux 和容器化环境的特殊限制
本地开发跑通了，一上 Docker 就失败？常见原因是挂载卷权限不对，或 SELinux 策略拦截。例如 Docker 启动命令用了 -v /host/logs:/app/logs:ro（只读），或宿主机目录属主是 root:root，而容器内 PHP 进程是 www-data，无权写入。
SELinux 下还会出现 Permission denied 却查不出权限问题的情况——因为上下文类型不匹配（如目录是 system_u:object_r:etc_t:s0，而 Web 进程需要 httpd_sys_rw_content_t）。
- Docker 中优先用
chown -R www-data:www-data /app/logs初始化挂载目录 - SELinux 下用
ls -Z /var/log/yourapp查上下文，再用chcon -R -t httpd_sys_rw_content_t /var/log/yourapp修正 - 云环境（如 AWS EC2）注意挂载的 EBS 卷默认属主是
root，需手动调整
真正卡住人的往往不是函数怎么写，而是谁在跑、跑在哪、被什么策略拦住了。每次失败，先盯住错误信息里的路径和用户，再一层层验证权限链：目录存在 → 属主匹配 → 权限位开启 → open_basedir 允许 → 安全模块放行。漏掉任何一环，file_put_contents() 都只会安静地返回 false。
