file_exists() 是最稳妥的文件存在性判断方式，但需配合 is_writable() 检查权限、mkdir() 确保父目录存在、flock() 处理并发，且注意编码与锁机制限制。
PHP中用 file_exists() 判断文件是否存在再修改
直接用 file_exists() 是最常用也最稳妥的判断方式，它返回布尔值，不依赖读写权限，只检查路径是否真实存在（包括文件和目录）。但要注意：它对符号链接默认跟随，若需区分链接与目标，得配合 is_link()。
常见错误是跳过判断直接 fopen(..., 'w') 或 file_put_contents() —— 这会导致路径不存在时静默失败或报 Warning: file_put_contents(): failed to open stream，且不会自动创建父级目录。
- 判断后修改的典型结构：
if (file_exists('/path/to/file.txt')) { file_put_contents('/path/to/file.txt', 'new content'); } - 若想“存在则追加、不存在则新建”，用
file_put_contents($file, $content, FILE_APPEND | LOCK_EX)更简洁，但注意它不会自动创建缺失的目录 - 路径含中文或特殊字符时，确保 PHP 文件系统函数编码与实际文件名编码一致（通常 UTF-8，但 Windows 下可能为 GBK）
修改前确保有写权限：is_writable() 不可省略
file_exists() 返回 true 只代表文件存在，不代表能改。尤其在 Linux 服务器上，权限问题比存在性更常导致失败。直接写入失败时，error_get_last() 常返回 Permission denied。
- 推荐组合判断：
if (file_exists($file) && is_writable($file)) { file_put_contents($file, $data); } else { throw new RuntimeException("Cannot write to {$file}"); } -
is_writable()在某些 NFS 或容器环境可能返回不稳定结果，此时可退而求其次：尝试fopen($file, 'c')（仅打开不截断），成功即说明可写 - 注意：
is_writable()对目录也有效，但修改文件时只需检查文件本身，而非父目录（除非你要创建新文件）
用 fopen() + flock() 安全覆盖，避免并发写乱序
多个进程/请求同时修改同一文件时，file_put_contents() 的原子性不保证（尤其大文件），易出现内容被截断或覆盖。此时需手动加锁。
立即学习“PHP免费学习笔记（深入）”；
- 安全覆盖流程：
$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()在 NFS 上可能失效，生产环境如需强一致性，应改用数据库或外部锁服务
注意 file_put_contents() 的第三个参数陷阱
很多人以为传 FILE_APPEND 就等于“先判断再追加”，其实不是——它不检查文件是否存在，路径不存在时直接报错。而 LOCK_EX 也不能替代存在性判断，它只管并发控制。
- 错误写法：
file_put_contents($file, $data, FILE_APPEND | LOCK_EX)—— 若$file不存在，照样失败 - 正确做法：存在性判断和写入模式要分开设计。例如“存在则追加，不存在则新建并写入”：
if (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.log需提前用mkdir(..., 0755, true)创建完整路径
