正确做法是用 fopen() 配合 ftruncate() 清空文件:先以 'c+' 模式打开文件,再调用 ftruncate($fp, 0),最后 fclose();可保留 inode、权限、acl 和符号链接,避免重写导致的各类问题。

PHP用 ftruncate() 清空文件但保留 inode 和权限
直接覆盖写空字符串(如 file_put_contents($file, ''))会重写文件,导致 inode 变更、ACL 丢失、符号链接断开,且在某些 NFS 或容器场景下可能触发监听器误判。真正“保留结构”的核心是截断而非重写。
正确做法是打开文件句柄后调用 ftruncate():
if ($fp = fopen('/path/to/file.log', 'c+')) {
ftruncate($fp, 0);
fclose($fp);
}关键点:
-
'c+'模式确保文件存在才打开(不创建),且支持读写,避免'w'导致权限重置 - 必须先
fopen()再ftruncate(),不能对已关闭的文件操作 - 操作后文件大小为 0,但
stat()中的ino、uid、gid、mode全部不变
清空日志文件时还要保留 atime/mtime?用 touch() 回填
默认 ftruncate() 会更新 mtime 和 ctime,但 atime 不变;若需完全冻结时间戳(例如审计合规),得手动保存再恢复:
立即学习“PHP免费学习笔记(深入)”;
$stat = stat($file); ftruncate($fp, 0); touch($file, $stat['mtime'], $stat['atime']);
注意:touch() 第二个参数是 mtime,第三个是 atime;省略则设为当前时间。
常见疏漏:
- 没检查
fopen()是否成功,直接ftruncate()会警告 - 忘记
fclose(),导致文件句柄泄漏(尤其循环中) - 对目录或无写权限文件硬执行,抛出
Warning: ftruncate():错误
替代方案:用 exec('truncate -s 0 /path') 的坑
有人倾向用 shell 命令绕过 PHP 文件函数限制,但风险明显:
-
truncate命令在 Alpine Linux(Docker 常见)里默认不安装,需额外装coreutils - Web 服务器用户(如
www-data)可能无权执行系统命令,exec()返回空或报错 - 路径含空格或特殊字符时未转义,造成命令注入或截断失败
- 无法原子化判断:命令执行成功 ≠ 文件真被清空(比如磁盘满时
truncate仍返回 0)
除非明确控制运行环境且需批量处理,否则优先用原生 ftruncate()。
大文件清空后磁盘空间没释放?检查是否有进程 hold 住旧内容
执行 ftruncate() 后 df 显示空间未增加,大概率是其他进程仍在读/写该文件(比如 tail -f、rsyslog、PHP-FPM 子进程未 reload)。Linux 下文件被打开时,即使清空,磁盘块直到所有 fd 关闭才真正释放。
排查命令:
lsof +L1 | grep filename # 查看被删除但未释放的文件 lsof /path/to/file # 查看哪些进程正占用该文件
解决方式只有两个:
- 重启对应进程(如
systemctl restart rsyslog) - 或让进程主动 reopen 文件(如 logrotate 的
copytruncate模式)
这和 PHP 怎么清空无关,但常被误认为代码没生效——实际是系统级资源持有问题。











