最稳妥创建空文件的方式是用fopen()以'c'模式打开并立即fclose():$fp = fopen($path, 'c'); fclose($fp);,该方式PHP 5.2.6+支持,不覆盖已有内容,语义明确且兼容性好。

用 fopen() + fclose() 创建空文件最稳妥
直接调用 fopen() 以写入模式('w' 或 'c')打开一个不存在的路径,PHP 会自动创建空文件。这是兼容性最好、行为最明确的方式。
注意:'w' 会截断已有文件,'c' 则只创建不覆盖(PHP 5.2.6+),若需严格避免误删内容,优先选 'c':
$fp = fopen('/path/to/file.txt', 'c');
if ($fp === false) {
throw new RuntimeException('无法创建文件:' . error_get_last()['message']);
}
fclose($fp);
-
'c'模式下,即使文件已存在也不会清空内容,仅确保文件存在 - 必须调用
fclose(),否则某些系统(如 NFS)可能延迟落盘或创建失败 - 权限由 umask 和父目录默认权限共同决定,不保证是 0644
touch() 函数能快速创建但有平台限制
touch() 本意是更新文件时间戳,但它在目标文件不存在时也会创建空文件——这点常被忽略,但要注意它的局限性。
常见问题:
立即学习“PHP免费学习笔记(深入)”;
- Windows 下对符号链接支持不稳定,可能失败
- 若父目录不可写,
touch()直接返回false,无额外错误提示 - 不支持设置初始权限(Linux 下默认受 umask 影响,无法像
mkdir()那样传0644)
安全用法示例:
$file = '/path/to/empty.log';
if (!touch($file)) {
// 检查是否因目录不可写导致失败
if (!is_writable(dirname($file))) {
throw new RuntimeException('父目录不可写:' . dirname($file));
}
}
别用 file_put_contents('', FILE_APPEND) 做空文件
有人尝试用 file_put_contents($path, '', FILE_APPEND) 创建空文件,这看似简洁,但隐含风险:
- 如果文件已存在且是只读的,
FILE_APPEND会触发警告并失败;而fopen('a')同样失败,但'c'或touch()至少能确保文件存在 -
FILE_APPEND要求文件可写,但创建空文件本身只需要父目录可写 - 语义不清:你不是在“追加空内容”,而是在“确保文件存在”
真正需要原子性创建(如防并发重复写),应配合 sys_get_temp_dir() + rename(),而不是依赖写空字符串。
权限和路径问题最容易踩坑
创建成功不等于能用。以下三点必须手动确认:
- 父目录必须存在且 PHP 进程有写权限(
is_writable(dirname($path))要为true) - 若通过 Web 服务器执行,注意用户是
www-data、nginx还是apache,而非当前 shell 用户 - 相对路径(如
'log.txt')按脚本执行位置解析,不是按__DIR__,容易误建到 webroot 根目录
推荐写法:
$path = __DIR__ . '/files/placeholder.json';
if (!is_dir(dirname($path))) {
mkdir(dirname($path), 0755, true);
}
$f = fopen($path, 'c');
fclose($f);
路径和权限不是创建动作的一部分,却是它能否落地的关键。很多人卡在这一步,却回头去查 fopen() 参数文档。











