PHP 的 touch 函数仅修改时间戳且不创建父目录,路径不存在时会报错;正确做法是先用 mkdir(..., true) 递归建目录,再 touch;更推荐 fopen($file, 'w') 或 file_put_contents($file, '') 自动处理路径与内容。

touch 函数在 PHP 中确实能创建空文件,但它的行为和 Unix/Linux 命令行 touch 不完全一致——它**只修改时间戳,不创建父目录,且当文件路径不存在时会失败**。直接用 touch 创建深层路径下的空文件,大概率报错 Warning: touch(): No such file or directory。
touch 函数本身不能自动创建父目录
PHP 的 touch 只操作已存在的文件或同级目录下可写的路径。如果 /var/log/app/2024/debug.log 的 /var/log/app/2024/ 不存在,touch 就会失败。
- ✅ 正确做法:先用
mkdir递归创建目录(加recursive=true参数),再调用touch - ❌ 错误写法:
touch('/path/to/nonexistent/file.txt');(直接报错) - ⚠️ 注意:
mkdir需要写权限,且 PHP 进程用户(如 www-data)必须有对应目录的父级写入权
替代方案:用 fopen + fclose 更可靠
多数场景下,创建空文件真正需要的是“确保文件存在且为空”,fopen($file, 'w') 更直观、兼容性更好,还能自动创建路径(配合 dirname + mkdir)。
-
fopen($file, 'w')会截断已有内容,等效于清空;若文件不存在,则创建 - 必须搭配
fclose(),否则可能残留句柄或写入异常 - 示例:
$file = '/tmp/test.txt';
$dir = dirname($file);
if (!is_dir($dir)) {
mkdir($dir, 0755, true);
}
$fp = fopen($file, 'w');
if ($fp) fclose($fp);
touch 和 fopen 创建空文件的性能与语义差异
两者底层开销接近,但语义不同:
立即学习“PHP免费学习笔记(深入)”;
-
touch是“设置访问/修改时间为当前时间”,本质是元数据操作;即使文件已存在,也会更新时间戳 -
fopen(..., 'w')是“打开并清空内容”,侧重文件内容状态,更适合“确保空文件存在”这个目标 - Windows 下
touch可能因时区或 FAT32 文件系统限制表现异常;fopen兼容性更稳 - 如果只是想记录一个标记(如
lock.tmp),建议用file_put_contents($file, ''),一行搞定且自动处理路径
真正容易被忽略的是权限链:PHP 进程用户能否在目标路径的**每一级父目录**执行 mkdir,比函数选哪个更重要。别只盯着 touch 成不成功,先 var_dump(is_writable(dirname($file))) 看清楚。











