PHP rename() 不带日志功能，需手动用 file_put_contents() 追加记录；应使用绝对路径、确保权限、过滤敏感路径、包含时间/路径/结果/错误码；建议封装为 safe_rename_with_log() 函数并配合 logrotate 实现轮转。
PHP rename() 函数直接重命名文件，但不自动记录日志
PHP 本身没有内置的“带日志的重命名”函数，rename() 只负责移动/改名，成功或失败都静默。你要的日志能力必须自己补全——不是加个参数就能开，而是得在调用前后手动写入日志条目。
用 file_put_contents() 追加日志，注意权限和路径安全
最轻量的做法是每次 rename 前后，用 file_put_contents($log_file, $log_line, FILE_APPEND | LOCK_EX) 写入一行。关键点：
-
$log_file要用绝对路径（比如/var/log/myapp/rename.log），避免相对路径导致写入失败 - 确保 Web 进程用户（如 www-data 或 nginx）对日志目录有写权限，否则日志会静默丢失
- 日志内容建议包含时间、原路径、目标路径、操作结果（成功/失败）、错误码（如果失败）
- 别把敏感路径（如用户上传的原始文件名）直接拼进日志，先做
basename()过滤，防路径遍历或日志注入
if (rename($old_path, $new_path)) {
$log = date('Y-m-d H:i:s') . " [OK] rename '{$old_path}' -> '{$new_path}'\n";
} else {
$err = error_get_last()['message'] ?? 'unknown error';
$log = date('Y-m-d H:i:s') . " [FAIL] rename '{$old_path}' -> '{$new_path}': {$err}\n";
}
file_put_contents('/var/log/myapp/rename.log', $log, FILE_APPEND | LOCK_EX);
封装成函数更可控，支持失败回滚和上下文标记
如果重命名逻辑分散在多处，建议抽成函数，比如 safe_rename_with_log()。它不只是记日志，还能帮你规避常见坑：
- 自动检查
$old_path是否存在、$new_path所在目录是否可写 - 失败时尝试恢复原名（前提是旧文件没被删或覆盖）
- 支持传入
$context参数（如'user_upload'或'batch_process_123'），让日
志可分类检索
- 避免重复写日志：
rename()在同一文件系统内是原子操作，但跨分区会先 copy 再 unlink，此时若中断，可能留下残留，日志里要体现这种风险
日志轮转不能靠 PHP 自己做，得交由系统工具
PHP 不适合处理日志切割。不要在代码里判断文件大小然后重命名旧日志——并发请求下极易冲突。正确做法是：
- 让 PHP 日志文件保持单一、追加写入（如
rename.log） - 用系统级工具管理轮转：Linux 下配
logrotate，指定rotate 7、daily、compress等规则 - logrotate 的
postrotate可选发信号给 PHP-FPM（如果用了 reload 机制），但绝大多数场景下不需要——PHP 不缓存日志文件句柄，每次file_put_contents()都是重新打开
