fopen() 创建文件失败主因是父目录不存在或无写权限；需先用 is_dir() 和 mkdir(..., 0755, true) 确保路径存在且可写，再用 fopen() 或 file_put_contents() 写入。
PHP fopen() 创建文件时路径不生效？先确认目录存在且可写
直接用 fopen() 指定绝对或相对路径创建文件，行——但前提是 PHP 进程有权限在目标目录下写入，且该目录已存在。fopen('logs/error.log', 'w') 会失败，如果 logs/ 目录根本不存在；也不会自动创建父级目录。
常见错误现象：fopen(): No such file or directory 或 Permission denied。不是函数不行，是路径前提没满足。
- 用
is_writable()检查目标目录是否可写（注意：检查的是目录，不是文件） - 用
is_dir()确认父目录存在，不存在就用mkdir()逐级创建（加0755权限和true第三个参数） - Windows 下路径分隔符用
/或\\都可以，但统一用/更安全（PHP 自动兼容）
用 file_put_contents() 一行写入并自动创建文件，但不建目录
file_put_contents() 是最简方式，能自动创建文件、覆盖或追加内容，但它和 fopen() 一样，**不会递归创建缺失的父目录**。
示例：file_put_contents('/var/www/app/cache/data.json', json_encode($data)) —— 若 cache/ 不存在，直接报错。
立即学习“PHP免费学习笔记（深入）”；
- 必须搭配
mkdir(..., 0755, true)先确保路径完整 - 第二个参数支持
FILE_APPEND和LOCK_EX，高并发写日志时建议加LOCK_EX - 返回写入字节数，失败返回
false，记得用=== false判断（避免 0 字节误判）
安全写法：组合 dirname() + mkdir() + file_put_contents()
这是生产环境推荐的最小可靠闭环。重点不是“怎么写”，而是“怎么让路径稳稳落地”。
示例代码片段：
function safe_file_write($filepath, $content) {
$dir = dirname($filepath);
if (!is_dir($dir) && !mkdir($dir, 0755, true)) {
throw new RuntimeException("Failed to create directory: $dir");
}
if (file_put_contents($filepath, $content) === false) {
throw new RuntimeException("Failed to write file: $filepath");
}
}
-
dirname()提取路径中的目录部分，支持多层嵌套（如a/b/c/file.txt→a/b/c） -
mkdir($dir, 0755, true)的true参数启用递归创建，否则只建最后一级 - 权限
0755是常规选择；若需 web 用户可写（如缓存），考虑0775+ 正确的组配置
相对路径陷阱：当前工作目录（CWD）不是你想象的那个
用 file_put_contents('config/test.ini', $str) 时，PHP 不看你的脚本在哪，而是看执行时的 getcwd()。CLI 下可能是 /home/user，Web 下通常是 Web 根目录（如 /var/www/html），极易写错位置。
- 永远优先用绝对路径：从
__DIR__或$_SERVER['DOCUMENT_ROOT']出发拼接 - 例如：
__DIR__ . '/../storage/logs/app.log'，比../storage/logs/app.log可靠得多 - 调试时加一句
echo getcwd(); die;，亲眼确认当前路径再动手
dirname()、mkdir(..., ..., true)、is_writable() 这三者串起来用，比死记某个“一行创建”技巧管用得多。 
