file_exists() 是最稳妥的文件存在性判断方式，但需配合 is_writable() 检查权限、mkdir() 确保父目录存在、flock() 处理并发，且注意编码与锁机制限制。
PHP中用
判断文件是否存在再修改
直接用
是最常用也最稳妥的判断方式，它返回布尔值，不依赖读写权限，只检查路径是否真实存在（包括文件和目录）。但要注意：它对符号链接默认跟随，若需区分链接与目标，得配合
。
常见错误是跳过判断直接
或
—— 这会导致路径不存在时静默失败或报
，且不会自动创建父级目录。
判断后修改的典型结构：
若想“存在则追加、不存在则新建”，用
更简洁，但注意它不会自动创建缺失的目录
路径含中文或特殊字符时，确保 PHP 文件系统函数
编码
与实际文件名编码一致（通常 UTF-8，但 Windows 下可能为 GBK）
修改前确保有写权限：
不可省略
返回
只代表文件存在，不代表能改。尤其在 Linux 服务器上，权限问题比存在性更常导致失败。直接写入失败时，
常返回
。
推荐组合判断：
在某些 NFS 或容器环境可能返回不稳定结果，此时可退而求其次：尝试
（仅打开不截断），成功即说明可写
注意：
对目录也有效，但修改文件时只需检查文件本身，而非父目录（除非你要创建新文件）
用
+
安全覆盖，避免并发写乱序
多个进程/请求同时修改同一文件时，
的原子性不保证（尤其大文件），易出现内容被截断或覆盖。此时需手动加锁。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记（深入）
”；
安全覆盖流程：
必须用
而非
：前者在打开时就清空，后者在首次
才清空，中间若有其他进程写入会丢失
在 NFS 上可能失效，生产环境如需强一致性，应改用数据库或外部锁服务
注意
的第三个参数陷阱
很多人以为传
就等于“先判断再追加”，其实不是——它不检查文件是否存在，路径不存在时直接报错。而
也不能替代存在性判断，它只管并发控制。
错误写法：
—— 若
不存在，照样失败
正确做法：存在性判断和写入模式要分开设计。例如“存在则追加，不存在则新建并写入”：
默认不创建父目录，路径如
需提前用
创建完整路径
实际操作中，最易忽略的是“路径存在 ≠ 可写 ≠ 父目录存在 ≠ 并发安全”。三者缺一都会让看似简单的“判存后改”在上线后出问题。
file_exists()file_exists()is_link()fopen(..., 'w')file_put_contents()Warning: file_put_contents(): failed to open streamif (file_exists('/path/to/file.txt')) {
file_put_contents('/path/to/file.txt', 'new content');
}file_put_contents($file, $content, FILE_APPEND | LOCK_EX)is_writable()file_exists()trueerror_get_last()Permission deniedif (file_exists($file) && is_writable($file)) {
file_put_contents($file, $data);
} else {
throw new RuntimeException("Cannot write to {$file}");
}is_writable()fopen($file, 'c')is_writable()fopen()flock()file_put_contents()$fp = fopen($file, 'c'); // 'c' 模式：存在则清空，不存在则创建
if ($fp && flock($fp, LOCK_EX)) {
ftruncate($fp, 0); // 确保从头写
fwrite($fp, $data);
fflush($fp);
flock($fp, LOCK_UN);
fclose($fp);
}'c''w'fwrite()flock()file_put_contents()FILE_APPENDLOCK_EXfile_put_contents($file, $data, FILE_APPEND | LOCK_EX)$fileif (file_exists($file)) {
file_put_contents($file, $data, FILE_APPEND | LOCK_EX);
} else {
file_put_contents($file, $data, LOCK_EX);
}file_put_contents()logs/2024/app.logmkdir(..., 0755, true)